HLS sulla migrazione del player Shaka

Panoramica

L'SDK Cast Web Receiver supporta la riproduzione di contenuti utilizzando diversi protocolli di streaming web. A seconda del protocollo utilizzato, l'SDK carica un player per gestire la riproduzione dei contenuti. Nel caso di contenuti HLS, viene caricata la Media Player Library (MPL). Nel caso di contenuti DASH, Shaka Player viene caricato.

In futuro, i team di progettazione dell'SDK Cast e di Shaka Player uniranno le forze per aumentare il supporto della riproduzione di contenuti HLS su Shaka Player. MPL non riceverà più aggiornamenti critici. Ti consigliamo di attivare l'utilizzo di Shaka Player per la riproduzione di contenuti HLS della tua applicazione.

Vantaggi di Shaka Player

Quando cambiano i player, le applicazioni usufruiscono dei seguenti vantaggi:

• Sessioni di streaming più robuste per gli utenti, con miglioramenti nei tempi di caricamento e nella latenza.
• Adozione continua delle ultime funzionalità HLS.
• Maggiore chiarezza nell'analisi della causa principale per i problemi di compatibilità tra player e contenuti grazie alla natura open source di Shaka Player.
• Il codice base del player open source consente ai partner di contribuire al progetto Shaka Player.
• Riduzione significativa del tempo di produzione di funzionalità e correzioni di bug poiché la cadenza di rilascio di Shaka Player è frequente e indipendente dai rilasci dell'SDK Web Receiver.
• Maggiore controllo sull'ambiente di riproduzione fornito dall'API shakaVersion.
• Maggiore supporto per la riproduzione da parte di Google con risorse di progettazione incentrate sulla riproduzione HLS su Shaka Player, come indicato nella roadmap.

Cronologia

L'SDK Web Receiver passerà all'utilizzo di Shaka Player come player predefinito per la riproduzione di contenuti HLS. Questa operazione verrà eseguita in modo graduale per guidare i partner durante il processo di migrazione.

I team di progettazione dell'SDK Web Receiver adottano un approccio basato sul rendimento e passeranno alla fase successiva solo quando il rendimento di Shaka Player sarà pari al rendimento di base di MPL. Queste modifiche verranno annunciate nel gruppo Google cast-sdk-announcements e aggiornate in questa guida.

Attiva

A partire dalla versione CAF 3.0.0105, è disponibile una configurazione a livello di applicazione per attivare l'utilizzo di Shaka Player per la riproduzione HLS. Questa versione introduce anche un'API per selezionare un intervallo di versioni di Shaka Player supportate da caricare. Questi flag vengono forniti nella CastReceiverOptions classe tramite le useShakaForHls e shakaVersion proprietà e vengono valutati all'avvio di CastReceiverContext. Qualsiasi applicazione che attiva Shaka per HLS deve impostare una versione di Shaka Player almeno 4.15.55 per usufruire dei miglioramenti HLS più recenti. Per attivare, segui lo snippet di codice riportato di seguito:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

Convalida i contenuti

I partner devono convalidare la riproduzione dei contenuti su Shaka Player prima di attivare l'utilizzo di Shaka Player nella loro app di produzione. Ti consigliamo di testare ciascuna delle varianti dei contenuti elencate di seguito:

• Tipi di stream: LIVE o VOD
• Formati container: TS, MP4 o stream elementari
• Contenuti con interruzioni o annunci incorporati
• Riproduzione sui seguenti tipi di dispositivi: smart display, dongle Google Cast, dispositivi Android TV, TV con Google Cast, smart speaker

Se riscontri errori o comportamenti imprevisti, segnala un bug. Una volta verificato che non ci sono errori di riproduzione critici nei tuoi contenuti, esegui il push delle modifiche nell'ambiente di produzione.

Disattiva

L'SDK Web Receiver passerà a un modello di disattivazione per la riproduzione di contenuti HLS di Shaka Player in base alla cronologia. La proprietà useShakaForHls cambierà il valore predefinito da false a true. A quel punto, le applicazioni potranno scegliere di utilizzare MPL per la riproduzione HLS impostando manualmente questa proprietà su false. Quando viene avviato CastReceiverContext, l'SDK Web Receiver tornerà a caricare MPL anziché Shaka Player. Consulta l'esempio riportato di seguito per scoprire come disattivare:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

Problemi con i report

Invitiamo i nostri partner a segnalare eventuali problemi riscontrati durante la riproduzione di contenuti HLS. Come accennato, MPL non riceverà più aggiornamenti critici. Se riscontri problemi con MPL, segui i passaggi nella sezione Attiva della guida per verificare se il passaggio a Shaka Player risolverà il tuo problema. Segui i passaggi riportati di seguito se il problema persiste o se riscontri un problema diverso quando cambi player.

1. Prova a impostare shakaVersion su una versione di ramo diversa per risolvere il problema. Ad esempio, se il problema si verifica nel ramo 4.15, prova a impostarlo sull'ultima release di un altro ramo. Consulta le note di rilascio di Shaka Player per trovare le release con gli aggiornamenti più pertinenti. Tieni presente che l' shakaVersion API ha una versione minima e massima supportata, come descritto nella documentazione di riferimento. Se noti una regressione, segnala il problema in Issue Tracker di Shaka Player.
2. Prova a modificare i parametri di configurazione del player. Shaka Player è configurabile tramite l'oggetto PlayerConfiguration. L'SDK Web Receiver definisce un insieme di valori predefiniti e consente alle applicazioni di modificare questa configurazione tramite la shakaConfig proprietà nell'PlaybackConfig oggetto. Questa proprietà viene valutata durante il tempo di caricamento quando viene creata l'istanza del player. Scopri di più nella sezione Configurazione e opzioni dell'applicazione. I valori predefiniti impostati dall'SDK Web Receiver sono i valori consigliati.
3. Verifica se il problema è stato segnalato in Issue Tracker di Shaka Player o in Issue Tracker di Cast. Commenta il bug e aggiungi eventuali informazioni pertinenti se descrive anche il tuo problema.
4. Testa i tuoi contenuti sul sito demo di Shaka Player. Se riscontri che il problema si riproduce nel sito demo per i tuoi contenuti, segnala un bug al progetto Shaka Player.
5. Segnala un bug in Issue Tracker di Cast se riscontri un problema specifico di Shaka Player sugli endpoint Cast.

Domande frequenti

Il cambio di player può generare molte domande. Di seguito troverai le risposte alle domande più comuni per aiutarti durante il processo di migrazione.

Devo eseguire la migrazione a Shaka Player?

Invitiamo i nostri partner che utilizzano contenuti HLS a iniziare il processo di migrazione il prima possibile. Di conseguenza, la tua app offrirà un'esperienza di streaming più robusta per i tuoi utenti. Nella sezione Vantaggi di Shaka Player di questa guida sono descritti ulteriori vantaggi. I partner devono verificare che le loro app funzionino correttamente utilizzando Shaka Player per garantire una transizione senza problemi. Alcune app potrebbero essere a rischio per quando l'SDK Web Receiver passa a un modello di disattivazione se i partner non verificano in anticipo che i loro contenuti vengano riprodotti correttamente su Shaka Player.

Qual è il livello di impegno previsto per il cambio di player?

I partner dovranno testare l'applicazione e i contenuti in un ambiente di test per assicurarsi che l'esperienza utente sia simile o migliorata rispetto a HLS. Per farlo, i partner dovranno attivare la funzionalità in un ambiente interno e testare a fondo che i loro contenuti possano essere riprodotti utilizzando Shaka Player. Per informazioni dettagliate sugli aspetti dei contenuti su cui concentrarsi, consulta la sezione Convalida i contenuti. Una volta convalidati, i partner dovranno aggiungere il flag per l'attivazione nell'ambiente dell'applicazione di produzione per iniziare a usufruire dei vantaggi offerti da Shaka Player. A livello generale, le modifiche allo sviluppo software sono minime e i requisiti di controllo qualità per i nostri partner per eseguire la migrazione correttamente sono principalmente di questo tipo.

La mia applicazione utilizzerà presto HLS per lo streaming di contenuti. Che cosa devo fare?

Le nuove integrazioni devono attivare l'utilizzo di Shaka Player per la riproduzione. La tua applicazione sarà supportata meglio a lungo termine e usufruirà anche delle nuove funzionalità HLS e dei miglioramenti delle prestazioni. Se la tua nuova integrazione riscontra problemi, segnala un bug il prima possibile per dare al team di progettazione il tempo sufficiente per risolvere il problema. Se la tua applicazione ha una scadenza imminente, includi queste informazioni nella segnalazione di bug, nonché l'impatto per assegnare la priorità di conseguenza. Il nostro team di progettazione si impegnerà a fornire una soluzione per supportare adeguatamente i tuoi utenti.

I miei contenuti o la mia app non funzionano con Shaka Player. Che cosa devo fare?

Devi segnalare un bug al progetto Shaka Player o al progetto Cast (vedi Problemi con i report). Il team di progettazione dell'SDK Cast monitora attivamente questi tracker e collaborerà con te per risolvere eventuali problemi. Prima vengono rilevati questi problemi, più tempo avranno a disposizione per fornire una correzione.

MPL non riceverà più aggiornamenti critici. Che cosa significa esattamente?

In passato, MPL ha adottato nuove funzionalità HLS e ha corretto i bug principali tramite aggiornamenti critici. Ora che MPL non li riceverà più, non verranno aggiunte nuove funzionalità HLS al player. Allo stesso modo, eventuali problemi segnalati per la riproduzione HLS su MPL non verranno corretti in MPL. Questi problemi devono essere risolti passando a Shaka Player per la riproduzione. Se i problemi persistono, allora un bug deve essere segnalato con i problemi pertinenti riscontrati su Shaka Player. I partner devono smettere di utilizzare MPL.

I miei contenuti utilizzano il protocollo Smooth Streaming. In che modo influisce sulla mia applicazione?

I file binari MPL continueranno a essere ospitati e accessibili alla tua applicazione ricevitore. Tuttavia, le richieste di funzionalità e le correzioni di bug relative a Smooth Streaming non saranno supportate perché la specifica Smooth Streaming non è stata aggiornata da oltre quattro anni. Ti consigliamo di eseguire la migrazione dei contenuti per utilizzare il protocollo di streaming DASH o HLS per continuare a ricevere aggiornamenti delle prestazioni e supporto per i tuoi contenuti.

I miei contenuti non utilizzano i protocolli HLS o Smooth Stream. In che modo influisce sulla mia applicazione?

Se la tua libreria di contenuti non utilizza nessuno di questi protocolli di streaming, la migrazione non avrà alcun impatto. Non sono richieste modifiche nell'applicazione.