chrome. trasmetti. contenuti multimediali. Contenuti multimediali
Rappresenta un elemento multimediale che è stato caricato nell'applicazione destinatario.
Costruttore
Contenuti multimediali
nuovo Media(sessionId, mediaSessionId)
Parametro |
|
---|---|
sessionId |
stringa L'identificatore di sessione. |
mediaSessionId |
numero L'identificatore multimediale. |
Proprietà
activeTrackIds
Array di numero nullable
Elenco di ID corrispondenti alle tracce attive.
breakStatus
(chrome.cast.media.BreakStatus non nullo o valore non definito)
Stato di una pausa quando viene riprodotta una pausa sul ricevitore. Questo campo verrà definito quando il destinatario sta riproducendo un'interruzione, vuoto quando non è in riproduzione un'interruzione ma è presente nel contenuto e non definito se il contenuto non contiene interruzioni.
currentItemId
numero null
ID elemento dell'elemento che era attivo in coda (potrebbe non essere in riproduzione) al momento della modifica dello stato dei contenuti multimediali.
currentTime
numero
La posizione di riproduzione corrente in secondi dall'inizio del contenuto multimediale.
Questo membro viene aggiornato solo sporadicamente, pertanto il suo valore è spesso obsoleto. Usa il metodo getEstimatedTime
per ottenere una stima della
posizione di riproduzione reale in base alle ultime informazioni riportate dal
ricevitore.
- Deprecata
- Usa invece getEstimatedTime.
customData
oggetto nullable
Set di dati personalizzato dall'applicazione del destinatario.
idleReason
chrome.cast.media.IdleReason nullable
Motivo dell'inattività se il destinatario lo sa.
items
nullable Array di chrome.cast.media.QueueItem non null
Array di elementi ordinati in coda.
liveSeekableRange
(chrome.cast.media.LiveSeekableRange non nullo o non definito)
Raggio d'azione possibile di un live streaming o di un evento. Utilizza il tempo multimediale relativo in secondi. Il valore non sarà definito per gli stream VOD.
loadingItemId
numero null
ID dell'articolo attualmente in fase di caricamento sul destinatario. Null se al momento nessun elemento è in fase di caricamento.
media
chrome.cast.media.MediaInfo nullable
Descrizione dei contenuti multimediali.
mediaSessionId
numero
Identifica l'elemento multimediale.
playbackRate
numero
La velocità di riproduzione. 1.0 rappresenta la riproduzione normale.
playerState
non-null chrome.cast.media.PlayerState
Lo stato del player.
preloadedItemId
numero null
ID dell'elemento successivo, disponibile solo se è stato precaricato. Sul ricevitore, gli elementi multimediali possono essere precaricati e memorizzati temporaneamente nella cache in modo che, quando vengono caricati in un secondo momento, il processo sia più rapido (in quanto i contenuti multimediali non devono essere recuperati dalla rete).
queueData
(chrome.cast.media.QueueData non nullo o undefined)
Dati della coda.
repeatMode
non-null chrome.cast.media.RepeatMode
La modalità di ripetizione per riprodurre la coda.
sessionId
stringa
Identifica la sessione che ospita i contenuti multimediali.
supportedMediaCommands
non-null Array of non-null chrome.cast.media.MediaCommand
I comandi multimediali supportati dal media player.
videoInfo
(chrome.cast.media.VideoInformation non nullo o non definito)
Le informazioni sul video.
volume
chrome.cast.Volume non null
Il volume dello stream multimediale. volume.level e volume.muted saranno sempre impostati.
Metodi
addUpdateListener
addUpdateListener(listener)
Aggiunge un listener che viene richiamato quando lo stato dell'elemento multimediale è cambiato. Le modifiche alle seguenti proprietà attiveranno il listener: currentTime, volume, metadata, playbackRate, playerState, customData. Anche una chiamata riuscita al metodo getStatus dell'elemento multimediale attiverà il listener.
Parametro |
|
---|---|
listener |
function(boolean) Il listener da aggiungere. Il parametro indica se l'oggetto Media è ancora attivo. |
editTracksInfo
editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)
Modifica lo stile delle tracce di testo o lo stato delle tracce. Se un trackId non corrisponde ai trackId esistenti, l'intera richiesta avrà esito negativo e lo stato non cambierà.
Parametro |
|
---|---|
editTracksInfoRequest |
chrome.cast.media.EditTracksInfoRequest Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
getEstimatedBreakClipTime
getEstimatedBreakClipTime() returns (number or undefined)
Valuta la posizione attuale del clip di interruzione in base alle ultime informazioni riportate dal destinatario.
- Ritorni
-
(number or undefined)
Una stima della posizione attuale del clip di interruzione in secondi dall'inizio dell'elemento multimediale. Restituisce un valore indefinito se non sono definiti breakStatus o currentBreakClipTime quando non è in corso una riproduzione di un'interruzione.
getEstimatedBreakTime
getEstimatedBreakTime() returns (number or undefined)
Valuta la posizione attuale dell'interruzione in base alle ultime informazioni riportate dal destinatario.
- Ritorni
-
(number or undefined)
Una stima della posizione attuale dell'interruzione in secondi dall'inizio della riproduzione multimediale. Verrà restituito un valore indefinito se non sono definiti breakStatus o currentBreakTime (quando non è in riproduzione un'interruzione).
getEstimatedLiveSeekableRange
getEstimatedLiveSeekableRange() returns (chrome.cast.media.LiveSeekableRange or undefined)
Stima l'inizio di liveSeekableRange in secondi in base alle ultime informazioni riportate dal ricevitore.
- Ritorni
-
(non-null chrome.cast.media.LiveSeekableRange or undefined)
Una stima dell'attuale liveSeekableRange. Restituisce undefined se liveSeekableRange, liveSeekableRange.start o liveSeekableRange.end non sono definiti quando il contenuto non è pubblicato.
getEstimatedTime
getStimaTime() restituisce numero
Stima la posizione di riproduzione attuale in base alle ultime informazioni riportate dal ricevitore.
- Ritorni
-
number
Una stima della posizione di riproduzione corrente in secondi dall'inizio del contenuto multimediale.
getStatus
getStatus(getStatusRequest, successCallback, errorCallback)
Restituisce lo stato dell'elemento multimediale dall'applicazione del destinatario.
Insieme all'elemento successCallback specificato, eventuali listener di aggiornamenti multimediali aggiunti verranno richiamati quando lo stato viene ricevuto dall'applicazione del destinatario. Anziché chiamare questo metodo per eseguire il polling dello stato dei contenuti multimediali, le app dovrebbero affidarsi alla chiamata automatica dei listener degli aggiornamenti multimediali ogni volta che i contenuti multimediali cambiano.
Parametro |
|
---|---|
getStatusRequest |
chrome.cast.media.GetStatusRequest La richiesta facoltativa get status. |
successCallback |
funzione() Richiamato quando viene ricevuto lo stato dall'applicazione del destinatario. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
in pausa
pausa(pauseRequest, successCallback, errorCallback)
Mette in pausa l'elemento multimediale.
Parametro |
|
---|---|
pauseRequest |
|
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. La richiesta di messa in pausa dei contenuti multimediali. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
riproduci
play(playRequest, successCallback, errorCallback)
Riproduce l'elemento multimediale.
Parametro |
|
---|---|
playRequest |
La richiesta facoltativa di riproduzione dei contenuti multimediali. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueAppendItem
queueAppendItem(item, successCallback, errorCallback)
Aggiunge un nuovo elemento multimediale alla fine della coda.
Parametro |
|
---|---|
elemento |
Elemento da aggiungere alla fine della coda. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueInsertItems
queueInsertItems(queueInsertItemsRequest, successCallback, errorCallback)
Inserisce un elenco di nuovi elementi multimediali nella coda.
Parametro |
|
---|---|
queueInsertItemsRequest |
chrome.cast.media.QueueInsertItemsRequest Richiedi l'inserimento di elementi multimediali nella coda di contenuti multimediali. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueJumpToItem
queueJumpToItem(itemId, successCallback, errorCallback)
Riproduce l'elemento con itemId in coda.
Se itemId non viene trovato nella coda, perché non era presente in origine o perché è stato rimosso da un altro mittente prima di chiamare questa funzione, questa funzione verrà restituita automaticamente senza inviare una richiesta al destinatario.
Parametro |
|
---|---|
itemId |
numero L'ID dell'elemento a cui passare. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueMoveItemToNewIndex
queueMoveItemToNewIndex(itemId, newIndex, successCallback, errorCallback)
Sposta l'elemento con itemId in posizione newIndex nella coda.
Se itemId non viene trovato nella coda, perché non era presente in origine o perché è stato rimosso da un altro mittente prima di chiamare questa funzione, questa funzione verrà restituita automaticamente senza inviare una richiesta al destinatario.
errorCallback verrà richiamato se newIndex è negativo. Tuttavia, se l'overflow di newIndex, perché è stato specificato in modo errato o perché la coda è stata ridotta da un altro mittente, l'elemento verrà spostato alla fine della coda.
Parametro |
|
---|---|
itemId |
numero L'ID dell'elemento da spostare. |
newIndex |
numero Il nuovo indice dell'elemento. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueNext
queueNext(successCallback, errorCallback)
Passa all'elemento successivo in coda.
Parametro |
|
---|---|
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queuePrev
queuePrev(successCallback, errorCallback)
Passa all'elemento precedente in coda.
Parametro |
|
---|---|
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueRemoveItem
queueRemoveItem(itemId, successCallback, errorCallback)
Rimuove dalla coda l'elemento con itemId.
Se itemId non viene trovato nella coda, perché non era presente in origine o perché è stato rimosso da un altro mittente prima di chiamare questa funzione, questa funzione verrà restituita automaticamente senza inviare una richiesta al destinatario.
Parametro |
|
---|---|
itemId |
numero L'ID dell'elemento da rimuovere. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueReorderItems
queueReorderItems(queueReorderItemsRequest, successCallback, errorCallback)
Riordina un elenco di elementi multimediali in coda.
Parametro |
|
---|---|
queueReorderItemsRequest |
chrome.cast.media.QueueReorderItemsRequest Richiedi l'ordine degli elementi nella coda dei contenuti multimediali. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueSetRepeatMode
queueSetRepeatMode(repeatMode, successCallback, errorCallback)
Imposta la modalità di ripetizione della coda.
Parametro |
|
---|---|
repeatMode |
L'algoritmo per la selezione dell'elemento successivo quando l'elemento corrente è terminato. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
queueUpdateItems
queueUpdateItems(queueUpdateItemsRequest, successCallback, errorCallback)
Aggiorna le proprietà della coda multimediale, ad esempio la modalità di ripetizione, e le proprietà degli elementi esistenti nella coda.
Parametro |
|
---|---|
queueUpdateItemsRequest |
chrome.cast.media.QueueUpdateItemsRequest Richiedi l'aggiornamento delle proprietà della coda multimediale. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
removeUpdateListener
removeUpdateListener(listener)
Rimuove un listener aggiunto in precedenza per questo contenuto multimediale.
Parametro |
|
---|---|
listener |
function(boolean) Il listener da rimuovere. |
cerca
search(seekRequest, successCallback, errorCallback)
Cerca l'elemento multimediale.
Parametro |
|
---|---|
seekRequest |
La richiesta di ricerca multimediale. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
setVolume
setVolume(volumeRequest, successCallback, errorCallback)
Imposta il volume dello stream multimediale. Devi impostare almeno un valore volumeRequest.level o volumeRequest.muted. La modifica dello stato di disattivazione audio non influisce sul livello del volume e viceversa.
Parametro |
|
---|---|
volumeRequest |
chrome.cast.media.VolumeRequest La richiesta di volume impostato. Il valore non deve essere nullo. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
Scalo
stop(stopRequest, successCallback, errorCallback)
Interrompe il media player.
Parametro |
|
---|---|
stopRequest |
La richiesta di interruzione. |
successCallback |
funzione() Richiamato al successo. |
errorCallback |
function(non-null chrome.cast.Error) Richiamato in caso di errore. Gli errori possibili sono TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR ed EXTENSION_MISSING. |
supportsCommand
supportaCommand(command) restituisce booleano
Determina se il media player supporta il comando multimediale specificato.
Parametro |
|
---|---|
comando |
chrome.cast.media.MediaCommand Il comando su cui eseguire una query. Il valore non deve essere nullo. |
- Ritorni
-
boolean
True se il player supporta il comando.