Panoramica
L'SDK Cast WebRicevir supporta la riproduzione di contenuti tramite diverse protocolli di streaming. In base alla utilizzato, l'SDK carica un player per gestire la riproduzione dei contenuti. Nella in caso di contenuti HLS, viene caricata la libreria Media Player Library (MPL). Nel caso di DASH, Shaka Player è caricato.
In futuro, i team tecnici di Cast SDK e Shaka Player si occuperanno consolidando gli sforzi per aumentare il supporto della riproduzione dei contenuti HLS su Shaka Player. Il formato MPL non riceverà più aggiornamenti critici. Ti consigliamo di attivare per utilizzare Shaka Player per la riproduzione di contenuti HLS della tua applicazione.
Vantaggi di Shaka Player
Nel cambiare i giocatori, le applicazioni sfruttano i seguenti vantaggi:
- Sessioni di streaming più affidabili per gli utenti, con tempi di caricamento migliorati errori e latenza.
- Adozione continua delle ultime funzionalità HLS.
- Maggiore chiarezza nell'analisi delle cause principali per i contenuti dei giocatori dovuti alla natura open source di Shaka Player.
- Il codebase open source per i player consente ai partner contribuire allo Shaka Player Project.
- Una riduzione significativa dei tempi di produzione di funzionalità e bug, poiché Lancio di Shaka Player frequenza è frequente e indipendentemente dalle release dell'SDK Web ricevitore.
- Maggiore controllo sull'ambiente di riproduzione offerto dalla
API
shakaVersion. - Maggiore assistenza per la riproduzione da parte di Google grazie alle risorse tecniche incentrato sulla riproduzione HLS su Shaka Player come visto roadmap.
Cronologia
L'SDK WebRicevir passerà all'utilizzo di Shaka Player come player predefinito per la riproduzione di contenuti HLS. Questo approccio avverrà in un approccio graduale per ai partner attraverso il processo di migrazione.
| Fase | Data di inizio | Panoramica |
|---|---|---|
| 1 | Ott '22 | L'SDK Cast Web receiver introduce le API per l'attivazione della riproduzione di contenuti HLS su Shaka Player. |
| 2 | Secondo semestre del 2024 | L'SDK Cast WebRicevir cambia il player predefinito in Shaka Player per la riproduzione dei contenuti HLS. |
I team tecnici dell'SDK Web ricevitore stanno adottando un approccio orientato alle prestazioni e passerà alla fase successiva soltanto quando sarà attiva l'esibizione di Shaka Player in linea con le prestazioni di base dell'MPL. Queste modifiche verranno annunciate nel cast-sdk-announcements nel gruppo Google e aggiornato in questa guida.
Attiva
A partire dalla versione CAF 3.0.0105, è previsto un livello di applicazione
per l'attivazione dell'utilizzo di Shaka Player per la riproduzione HLS. Questa versione
introduce anche un'API per scegliere tra una gamma supportata di versioni di Shaka Player
da caricare. Questi flag vengono forniti
CastReceiverOptions tramite il
useShakaForHls e
shakaVersion e vengono valutate quando
il CastReceiverContext viene avviato. Qualsiasi applicazione che attiva Shaka per HLS
devi impostare almeno una versione di Shaka Player pari a 4.3.4 per sfruttare le
gli ultimi miglioramenti apportati a HLS. Per attivare la funzionalità, 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 dei contenuti
I partner devono convalidare la riproduzione dei contenuti su Shaka Player prima di attivare l'opzione. a utilizzare Shaka Player nella propria app di produzione. Ti consigliamo di eseguire test per ciascuno le varianti dei contenuti elencate di seguito:
- Tipi di stream: LIVE o VOD
- Formati container: TS, MP4 o stream elementari
- Contenuti con discontinuità o annunci incorporati
- Riproduzione sui seguenti tipi di dispositivi: smart display, dongle Chromecast Dispositivi Android TV, TV con Chromecast integrato, smart speaker
Se rilevi errori o comportamenti imprevisti, segnala un bug. Dopo aver verificato che non sono presenti errori critici di riproduzione nel contenuti, trasferire le modifiche all'ambiente di produzione.
Disattiva
L'SDK Web ricevitore passerà a un modello di disattivazione per HLS di Shaka Player
la riproduzione di contenuti in base alla sequenza temporale. La proprietà
useShakaForHls cambierà il suo valore predefinito
dalle ore false alle ore true. A quel punto, le applicazioni possono scegliere di utilizzare MPL per HLS
impostando manualmente questa proprietà su false. Quando
L'app CastReceiverContext è stata avviata, verrà ripristinato il caricamento dell'SDK Web receiver
MPL anziché Shaka Player. Per informazioni su come disattivare la funzionalità, consulta l'esempio di seguito:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
Problemi con i rapporti
Invitiamo i nostri partner a segnalare eventuali problemi riscontrati durante la riproduzione di HLS contenuti. Come accennato, MPL non riceverà più aggiornamenti critici. Se presente con MPL, segui i passaggi nella sezione per l'attivazione della guida per verificare se il passaggio a Shaka Player sbloccherà problema. Se il problema persiste o se lo riscontri, procedi nel seguente modo: un problema diverso quando cambi giocatore.
- Prova a impostare il
shakaVersionsu un un'altra versione del ramo per risolvere il problema. Ad esempio, se il problema è già sperimentata sul ramo4.3, prova a impostarla sull'ultima release in le versioni4.2.xo3.3.x. Controlla la release di Shaka Player note per trovare con gli aggiornamenti più pertinenti. Tieni presente che L'APIshakaVersionha un limite minimo e massimo supportata, come descritto in dettaglio nella documentazione di riferimento. Se noti che c'è una regressione, segnala il problema nella sezione Shaka Player monitoraggio problemi. Prova a modificare i parametri di configurazione del player. Shaka Player è configurabile tramite
PlayerConfiguration. Il web L'SDK ricevitore definisce un insieme di valori predefiniti e consente alle applicazioni di modificare questa configurazione tramite ProprietàshakaConfiginPlaybackConfig. Viene valutato durante il tempo di caricamento quando l'istanza del player è stato creato. Altre indella configurazione dell'applicazione opzioni. Il valore predefinito impostati dall'SDK WebRicevir sono i valori consigliati.
Controlla se il problema è stato segnalato nel Issue Tracker di Shaka Player o Cast monitoraggio problemi. Commenta il bug e aggiungi eventuali commenti pertinenti informazioni se anche questo descrive il tuo problema.
Verifica i tuoi contenuti sul sito dimostrativo di Shaaka Player. Se verifica che il problema sia riprodotto sul sito dimostrativo dei contenuti, invia una del progetto Shaka Player.
Segnala un bug in Cast Issue Tracker se presentano un problema specifico di Shaka Player sugli endpoint di trasmissione.
Domande frequenti
Cambiare i giocatori può far nascere molte domande. Di seguito sono riportate le risposte alle domande più comuni per guidarti nel processo di migrazione.
Devo eseguire la migrazione a Shaka Player?
Invitiamo i nostri partner che utilizzano contenuti HLS ad avviare il processo di migrazione il prima possibile. Di conseguenza, la tua app fornirà uno streaming più affidabile la migliore esperienza utente possibile. Nel player di Shaka sono descritti altri vantaggi. vantaggi di questa guida. I partner devono verificare che le app funzionino correttamente usando Shaka Player per garantire una transizione. Alcune app potrebbero essere a rischio quando l'SDK Web receivers transizioni a un modello di opt-out se i partner non verificano che i contenuti vengano riprodotti in anticipo su Shaka Player.
Qual è il livello di impegno previsto nel cambiare i giocatori?
I partner dovranno testare la propria applicazione e i propri contenuti in un ambiente di test per garantire che l'esperienza utente sia simile o migliorata rispetto a HLS. Per farlo, i partner dovranno attivare la funzione in una ambiente interno e testare accuratamente che i loro contenuti siano in grado di riprodurre usando Shaka Player. Consulta la sezione Convalida dei contenuti per maggiori dettagli su su quali aspetti dei tuoi contenuti concentrarti. Dopo la convalida, i partner dovranno aggiungere il flag per attivare la funzionalità nell'ambiente applicativo di produzione per avviare sfruttando i vantaggi offerti da Shaka Player. A livello generale, sono modifiche minime durante lo sviluppo del software e principalmente requisiti di QA per le nostre partner per eseguire correttamente la migrazione.
A breve la mia applicazione utilizzerà HLS per trasmettere contenuti in streaming. Che cosa devo fare?
Nelle nuove integrazioni è necessario attivare l'utilizzo di Shaka Player per la riproduzione. Il tuo verrà supportata meglio a lungo termine e richiederà sfruttare le nuove funzionalità HLS e i miglioramenti delle prestazioni. Se il tuo nuovo se si verificano dei problemi nell'integrazione, segnala un bug il prima possibile per il team tecnico abbia tempo sufficiente per risolvere il problema. Se la tua applicazione include scadenza ravvicinata, includi queste informazioni nella segnalazione di bug, nonché l'impatto a cui assegnare le priorità di conseguenza. Il nostro team tecnico lavorerà per fornire una soluzione per fornire un'assistenza adeguata ai tuoi utenti.
I miei contenuti o la mia app non funzionano con Shaka Player, e adesso?
Dovresti segnalare un bug relativo al progetto Shaka Player o al progetto Cast (consulta la pagina Segnalare problemi). Il team tecnico di Cast SDK sta attivamente il monitoraggio di questi tracker e collaboreremo con te per risolvere eventuali problemi. Prima vengono rilevati questi problemi, maggiore sarà il tempo che avranno a disposizione trovare una soluzione.
MPL non riceve più aggiornamenti critici. Che cosa significa esattamente?
In passato, MPL ha adottato nuove funzionalità HLS e ha corretto i principali bug tramite aggiornamenti critici. Ora che il file MPL non li riceverà più, il nuovo HLS non verranno aggiunti al player. Allo stesso modo, eventuali problemi segnalati per HLS la riproduzione su MPL non sarà fissata in MPL. Questi problemi dovrebbero essere risolti entro il giorno passare a Shaka Player per la riproduzione. Se i problemi persistono, bug, indicando i problemi pertinenti riscontrati su Shaka Player. I partner non devono più utilizzare la tecnologia MPL.
I miei contenuti utilizzano il protocollo Streaming fluido. Quali sono le conseguenze per la mia applicazione?
I file binari MPL continueranno a essere ospitati e saranno accessibili al ricevitore un'applicazione. Tuttavia, eventuali richieste di funzionalità e bug relativi a Streaming fluido correzioni non saranno supportate perché La specifica di Streaming fluido non è stata aggiornata in nell'arco di quattro anni. Ti consigliamo di eseguire la migrazione dei tuoi contenuti per utilizzare DASH o HLS. Streaming Protocol per continuare a ricevere aggiornamenti sulle prestazioni e supporto i tuoi contenuti.
I miei contenuti non utilizzano i protocolli HLS o Streaming fluido. Quali sono le conseguenze per la mia applicazione?
Se la tua raccolta di contenuti non utilizza nessuno di questi protocolli di streaming: non sarai interessato dalla migrazione. Non sono necessarie modifiche in un'applicazione.