Classe: media

chrome.trasmetti.contenuti multimediali.Contenuti multimediali

class   statica

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	chrome.cast.media.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	chrome.cast.media.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	chrome.cast.media.QueueItem 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	chrome.cast.media.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	chrome.cast.media.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	chrome.cast.media.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.