Panoramica
Un controller per le viste UI che viene utilizzato per controllare o mostrare lo stato della riproduzione di contenuti multimediali su un ricevitore di trasmissione.
L'applicazione di chiamata registra i propri controlli UI relativi ai contenuti multimediali con il controller impostando le proprietà appropriate. Il controller risponde quindi agli eventi touch sui controlli inviando i comandi multimediali appropriati al ricevitore e aggiorna i controlli in base alle informazioni sullo stato e ai metadati dei contenuti multimediali ricevuti dal ricevitore. Il controller attiva e disattiva automaticamente i controlli dell'interfaccia utente in base alla sessione corrente e allo stato del media player. Inoltre, disattiva tutti i controlli mentre è in corso una richiesta.
Vedi GCKUIMediaControllerDelegate per il protocollo delegato.
- Dal
- 3,0
Eredita NSObject.
Riepilogo del metodo di istanza | |
| (instancetype) | - init |
| Inizializza un'istanza. Altro... | |
| (void) | - bindLabel:toMetadataKey: |
| Associa UILabel a una chiave di metadati. Altro... | |
| (void) | - bindLabel:toMetadataKey:withFormatter: |
| Associa UILabel a una chiave di metadati. Altro... | |
| (void) | - bindTextView:toMetadataKey: |
| Associa un oggetto UITextView a una chiave di metadati. Altro... | |
| (void) | - bindTextView:toMetadataKey:withFormatter: |
| Associa un oggetto UITextView a una chiave di metadati. Altro... | |
| (void) | - bindImageView:toImageHints: |
| Associa UIImageView a un'istanza GCKUIImageHints. Altro... | |
| (void) | - bindControlView:toRewindForTime: |
Associa un UIControl per riavvolgere la riproduzione dell'elemento corrente in base al valore passato in secondi. Altro... | |
| (void) | - bindControlView:toForwardForTime: |
Associa un valore UIControl per inoltrare la riproduzione dell'elemento corrente in base al valore passato in secondi. Altro... | |
| (void) | - unbindView: |
| Annulla l'associazione della visualizzazione specificata. Altro... | |
| (void) | - unbindAllViews |
| Annulla l'associazione di tutte le visualizzazioni associate. Altro... | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| Modifica la modalità di ripetizione per la coda alla modalità successiva nel ciclo: Altro... | |
| (void) | - selectTracks |
| Un metodo pratico per visualizzare l'interfaccia utente per la selezione delle tracce multimediali. Altro... | |
| (void) | - skipAd |
| Invia e monitora la richiesta di annuncio "Salta annuncio". Altro... | |
Riepilogo proprietà | |
| id< GCKUIMediaControllerDelegate > | delegate |
| Il delegato per aver ricevuto notifiche da GCKUIMediaController. Altro... | |
| GCKSession * | session |
| La sessione associata a questo controller. Altro... | |
| BOOL | mediaLoaded |
| Indica se i contenuti multimediali sono attualmente caricati (o in fase di caricamento) sul ricevitore. Altro... | |
| BOOL | hasCurrentQueueItem |
| Indica se è presente un elemento corrente in coda. Altro... | |
| BOOL | hasLoadingQueueItem |
| Indica se un elemento è precaricato nella coda. Altro... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| L'ultimo stato noto del media player. Altro... | |
| NSTimeInterval | lastKnownStreamPosition |
| L'ultima posizione nota dello stream multimediale. Altro... | |
| UIButton * | playButton |
| Un pulsante di riproduzione. Altro... | |
| UIButton * | pauseButton |
| Un pulsante "Metti in pausa". Altro... | |
| GCKUIMultistateButton * | playPauseToggleButton |
| Un pulsante di attivazione/disattivazione "riproduci/metti in pausa". Altro... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Un controller di attivazione/disattivazione "riproduci/metti in pausa". Altro... | |
| UIButton * | stopButton |
| Un pulsante di interruzione. Altro... | |
| UIButton * | forward30SecondsButton |
| Un pulsante per andare avanti di 30 secondi nell'elemento multimediale attualmente in riproduzione. Altro... | |
| UIButton * | rewind30SecondsButton |
| Un pulsante per tornare indietro di 30 secondi all'elemento multimediale attualmente in riproduzione. Altro... | |
| UIButton * | pauseQueueButton |
| Un pulsante per mettere in pausa la riproduzione in coda una volta terminata la riproduzione dell'elemento corrente. Altro... | |
| UIButton * | nextButton |
| Un pulsante "Avanti". Altro... | |
| UIButton * | previousButton |
| Un pulsante "Indietro". Altro... | |
| GCKUIMultistateButton * | repeatModeButton |
| Pulsante per scorrere le modalità di ripetizione della coda disponibili. Altro... | |
| UISlider * | streamPositionSlider |
| Un dispositivo di scorrimento per visualizzare e modificare la posizione corrente dello stream. Altro... | |
| UIProgressView * | streamProgressView |
| Una visualizzazione per mostrare l'avanzamento dello stream corrente. Altro... | |
| UILabel * | streamPositionLabel |
| Un'etichetta per visualizzare la posizione corrente dello stream, in minuti e secondi. Altro... | |
| UILabel * | streamDurationLabel |
| Un'etichetta per visualizzare la durata attuale dello stream, in minuti e secondi. Altro... | |
| UILabel * | streamTimeRemainingLabel |
| Un'etichetta per visualizzare il tempo di streaming rimanente (la durata meno la posizione), in minuti e secondi. Altro... | |
| GCKUIStreamPositionController * | streamPositionController |
| Un controller di posizione dello stream. Altro... | |
| GCKUIPlaybackRateController * | playbackRateController |
| Un controller della velocità di riproduzione dello streaming. Altro... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Indica se il tempo di streaming rimanente verrà visualizzato come valore negativo, ad esempio "-1:23:45". Altro... | |
| BOOL | hideStreamPositionControlsForLiveContent |
| Indica se i controlli di posizione dello stream (inclusi il dispositivo di scorrimento della posizione, l'etichetta della posizione dello stream, l'etichetta della durata dello stream e la visualizzazione dell'avanzamento dello stream) devono essere nascosti per i contenuti dal vivo. Altro... | |
| UIButton * | tracksButton |
| Un pulsante per selezionare le tracce audio e/o i sottotitoli. Altro... | |
| UILabel * | smartSubtitleLabel |
| Un'etichetta per visualizzare un sottotitolo per i contenuti multimediali attualmente caricati. Altro... | |
| UIActivityIndicatorView * | mediaLoadingIndicator |
| Un indicatore di attività che indica che i contenuti multimediali sono in stato di caricamento. Altro... | |
| UILabel * | skipAdLabel |
| Un'etichetta per visualizzare il tempo rimanente prima che sia possibile saltare l'annuncio. Altro... | |
| UIButton * | skipAdButton |
| Pulsante per saltare l'annuncio corrente. Altro... | |
Dettaglio metodo
| - (instancetype) init |
Inizializza un'istanza.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
Associa UILabel a una chiave di metadati.
La visualizzazione mostrerà il valore corrente del campo dei metadati corrispondente.
Consulta la pagina GCKMediaMetadata per un elenco delle chiavi dei metadati predefinite.
- Parameters
-
label The UILabel that will display the value. key The metadata key.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
Associa UILabel a una chiave di metadati.
La visualizzazione mostrerà il valore corrente del campo dei metadati corrispondente.
Consulta la pagina GCKMediaMetadata per un elenco delle chiavi dei metadati predefinite.
- Parameters
-
label The UILabel that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
Associa un oggetto UITextView a una chiave di metadati.
La visualizzazione mostrerà il valore corrente del campo dei metadati corrispondente.
Consulta la pagina GCKMediaMetadata per un elenco delle chiavi dei metadati predefinite.
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
Associa un oggetto UITextView a una chiave di metadati.
La visualizzazione mostrerà il valore corrente del campo dei metadati corrispondente.
Consulta la pagina GCKMediaMetadata per un elenco delle chiavi dei metadati predefinite.
- Parameters
-
textView The UITextView that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindImageView: | (UIImageView *) | imageView | |
| toImageHints: | (GCKUIImageHints *) | imageHints | |
Associa UIImageView a un'istanza GCKUIImageHints.
L'oggetto GCKUIImagePicker attualmente installato verrà utilizzato per selezionare un'immagine dai metadati per la visualizzazione.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) bindControlView: | (UIControl *) | control | |
| toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
Associa un UIControl per riavvolgere la riproduzione dell'elemento corrente in base al valore passato in secondi.
La visualizzazione verrà aggiornata in base allo stato di GCKCastSession, allo stato della riproduzione remota e alla presenza o meno di un live streaming. Viene aggiunto anche un target a UIControl per acquisire l'evento UIControlEventTouchUpInside. Non aggiungere target di questo tipo alla UIControl. Per acquisire l'evento, utilizza invece i metodi GCKUIMediaControllerDelegate.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.rewindSeconds The number of seconds to rewind the media.
| - (void) bindControlView: | (UIControl *) | control | |
| toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
Associa un valore UIControl per inoltrare la riproduzione dell'elemento corrente in base al valore passato in secondi.
La visualizzazione verrà aggiornata in base allo stato di GCKCastSession, allo stato della riproduzione remota e alla presenza o meno di un live streaming. Viene aggiunto anche un target a UIControl per acquisire l'evento UIControlEventTouchUpInside. Non aggiungere target di questo tipo alla UIControl. Per acquisire l'evento, utilizza invece i metodi GCKUIMediaControllerDelegate.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.forwardSeconds The number of seconds to skip the media.
| - (void) unbindView: | (UIView *) | view |
Annulla l'associazione della visualizzazione specificata.
- Parameters
-
view The view to unbind.
| - (void) unbindAllViews |
Annulla l'associazione di tutte le visualizzazioni associate.
| - (GCKMediaRepeatMode) cycleRepeatMode |
Modifica la modalità di ripetizione per la coda alla modalità successiva nel ciclo:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Ritorni
- La nuova modalità di ripetizione.
| - (void) selectTracks |
Un metodo pratico per visualizzare l'interfaccia utente per la selezione delle tracce multimediali.
| - (void) skipAd |
Invia e monitora la richiesta di annuncio "Salta annuncio".
- Dal
- 4,3
Dettagli della proprietà
|
readwritenonatomicweak |
Il delegato per aver ricevuto notifiche da GCKUIMediaController.
|
readnonatomicstrong |
La sessione associata a questo controller.
|
readnonatomicassign |
Indica se i contenuti multimediali sono attualmente caricati (o in fase di caricamento) sul ricevitore.
Se non è attiva alcuna sessione di trasmissione, sarà NO.
|
readnonatomicassign |
Indica se è presente un elemento corrente in coda.
|
readnonatomicassign |
Indica se un elemento è precaricato nella coda.
|
readnonatomicassign |
L'ultimo stato noto del media player.
Se non è attiva alcuna sessione di trasmissione, lo stato del player sarà quello immediatamente precedente al termine dell'ultima sessione. Se non c'è stata una sessione precedente, questo sarà GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
L'ultima posizione nota dello stream multimediale.
Se nessuna sessione di trasmissione è attiva, verrà indicata la posizione dello stream del contenuto multimediale immediatamente prima della fine dell'ultima sessione. Se non c'è stata una sessione precedente, sarà kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Un pulsante di riproduzione.
Quando si tocca il pulsante, la riproduzione dei contenuti multimediali attualmente caricati viene avviata o ripresa sul ricevitore. Il pulsante verrà disattivato se la riproduzione è già in corso, se al momento non sono presenti contenuti multimediali caricati o se non è attualmente attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un pulsante "Metti in pausa".
Quando tocchi il pulsante, la riproduzione dei contenuti multimediali attualmente caricati viene messa in pausa sul ricevitore. Il pulsante verrà disattivato se i contenuti multimediali attualmente caricati non supportano la messa in pausa, se la riproduzione non è attualmente in corso, se non ci sono contenuti multimediali attualmente caricati o se non c'è alcuna sessione di trasmissione attiva.
|
readwritenonatomicweak |
Un pulsante di attivazione/disattivazione "riproduci/metti in pausa".
Il chiamante deve impostare le icone appropriate per gli stati del pulsante GCKUIButtonStatePlay, GCKUIButtonStatePlayLive e GCKUIButtonStatePause del pulsante, ovvero un'icona "pausa" per lo stato di riproduzione, un'icona "stop" per lo stato di riproduzione dal vivo e un'icona "riproduci" per lo stato di pausa. Lo stato del pulsante viene aggiornato automaticamente in base allo stato di riproduzione attuale sul ricevitore. Quando si tocca il pulsante, la riproduzione dei contenuti multimediali attualmente caricati viene messa in pausa o ripresa sul ricevitore. Il pulsante verrà disattivato se il contenuto multimediale attualmente caricato non supporta la messa in pausa, se la riproduzione non è attualmente in corso o in pausa, se non ci sono contenuti multimediali attualmente caricati o se non c'è alcuna sessione di trasmissione attiva.
|
readwritenonatomicstrong |
Un controller di attivazione/disattivazione "riproduci/metti in pausa".
Utilizzato come sostituto di un'interfaccia utente di attivazione/disattivazione di riproduzione/pausa fornita dall'applicazione. Per ulteriori dettagli, consulta GCKUIPlayPauseToggleController.
- Dal
- 3,4
|
readwritenonatomicweak |
Un pulsante di interruzione.
Quando tocchi il pulsante, la riproduzione dei contenuti multimediali attualmente caricati viene interrotta sul ricevitore. Il pulsante verrà disattivato se al momento non sono presenti contenuti multimediali caricati o se al momento non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un pulsante per andare avanti di 30 secondi nell'elemento multimediale attualmente in riproduzione.
Il pulsante verrà disattivato se al momento non sono presenti contenuti multimediali caricati o se al momento non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un pulsante per tornare indietro di 30 secondi all'elemento multimediale attualmente in riproduzione.
Il pulsante verrà disattivato se al momento non sono presenti contenuti multimediali caricati o se al momento non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un pulsante per mettere in pausa la riproduzione in coda una volta terminata la riproduzione dell'elemento corrente.
|
readwritenonatomicweak |
Un pulsante "Avanti".
Quando tocchi il pulsante, la riproduzione passa all'elemento multimediale successivo in coda. Il pulsante viene disattivato se l'operazione non è supportata, se al momento non sono presenti contenuti multimediali caricati o se non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un pulsante "Indietro".
Quando tocchi il pulsante, la riproduzione passa all'elemento multimediale precedente nella coda. Il pulsante viene disattivato se l'operazione non è supportata, se al momento non sono presenti contenuti multimediali caricati o se non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Pulsante per scorrere le modalità di ripetizione della coda disponibili.
(Vedi GCKMediaRepeatMode). Il chiamante deve impostare le icone appropriate per gli stati dei pulsanti GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll e GCKUIButtonStateShuffle del pulsante. Lo stato del pulsante viene aggiornato automaticamente per riflettere l'attuale modalità di ripetizione della coda sul ricevitore. Quando si tocca il pulsante, si passa alla modalità di ripetizione successiva, nell'ordine:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Il pulsante viene disattivato se al momento non ci sono sessioni di trasmissione attive.
|
readwritenonatomicweak |
Un dispositivo di scorrimento per visualizzare e modificare la posizione corrente dello stream.
Quando l'utente modifica il valore del dispositivo di scorrimento, la posizione dello stream del contenuto multimediale attualmente caricato viene aggiornata sul destinatario. Mentre è in corso la riproduzione di contenuti multimediali sul ricevitore, il valore del dispositivo di scorrimento viene aggiornato in tempo reale per riflettere la posizione dello stream corrente. Il dispositivo di scorrimento verrà disattivato se i contenuti multimediali attualmente caricati non supportano la ricerca, se al momento non sono presenti contenuti multimediali o se non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Una visualizzazione per mostrare l'avanzamento dello stream corrente.
Mentre è in corso la riproduzione di contenuti multimediali sul destinatario, il valore delle visualizzazioni viene aggiornato in tempo reale per riflettere la posizione corrente dello stream. La visualizzazione verrà disattivata se i contenuti multimediali attualmente caricati sono un live streaming, se al momento non sono presenti contenuti multimediali o se non sono presenti sessioni di trasmissione attive.
|
readwritenonatomicweak |
Un'etichetta per visualizzare la posizione corrente dello stream, in minuti e secondi.
Se al momento non sono presenti contenuti multimediali caricati o se non c'è alcuna sessione di trasmissione attiva, l'etichetta mostrerà un formato localizzato di "--:--".
|
readwritenonatomicweak |
Un'etichetta per visualizzare la durata attuale dello stream, in minuti e secondi.
Se i contenuti multimediali attualmente caricati non hanno una durata (ad esempio, se si tratta di un live streaming) o se non ci sono contenuti multimediali attualmente caricati o se non c'è alcuna sessione di trasmissione attiva, l'etichetta mostra un formato localizzato di "--:--".
|
readwritenonatomicweak |
Un'etichetta per visualizzare il tempo di streaming rimanente (la durata meno la posizione), in minuti e secondi.
Se i contenuti multimediali attualmente caricati non hanno una durata (ad esempio, se si tratta di un live streaming) o se non ci sono contenuti multimediali attualmente caricati o se non c'è alcuna sessione di trasmissione attiva, l'etichetta mostra un formato localizzato di "--:--".
|
readwritenonatomicstrong |
Un controller di posizione dello stream.
Utilizzato come sostituzione per una posizione dello stream personalizzata e/o per l'interfaccia utente di ricerca fornita dall'applicazione. Per ulteriori dettagli, consulta GCKUIStreamPositionController.
- Dal
- 3,4
|
readwritenonatomicstrong |
Un controller della velocità di riproduzione dello streaming.
Per ulteriori dettagli, consulta GCKUIPlaybackRateController.
- Dal
- 4,0
|
readwritenonatomicassign |
Indica se il tempo di streaming rimanente verrà visualizzato come valore negativo, ad esempio "-1:23:45".
Per impostazione predefinita, questa proprietà è impostata su YES.
|
readwritenonatomicassign |
Indica se i controlli di posizione dello stream (inclusi il dispositivo di scorrimento della posizione, l'etichetta della posizione dello stream, l'etichetta della durata dello stream e la visualizzazione dell'avanzamento dello stream) devono essere nascosti per i contenuti dal vivo.
Il valore predefinito è NO.
- Dal
- 4,0
|
readwritenonatomicweak |
Un pulsante per selezionare le tracce audio e/o i sottotitoli.
Quando il pulsante viene toccato, l'utente visualizza l'interfaccia utente per la selezione delle tracce multimediali. Il pulsante verrà disattivato se i contenuti multimediali attualmente caricati non hanno tracce multimediali selezionabili, se non ci sono contenuti multimediali attualmente caricati o se non è attiva alcuna sessione di trasmissione.
|
readwritenonatomicweak |
Un'etichetta per visualizzare un sottotitolo per i contenuti multimediali attualmente caricati.
Se nei metadati non è stato esplicitamente impostato un campo dei sottotitoli, la casa discografica mostrerà il campo dei metadati più appropriato in base al tipo di media, ad esempio il nome dello studio cinematografico per un film o il nome dell'artista di una traccia musicale.
|
readwritenonatomicweak |
Un indicatore di attività che indica che i contenuti multimediali sono in stato di caricamento.
|
readwritenonatomicweak |
Un'etichetta per visualizzare il tempo rimanente prima che sia possibile saltare l'annuncio.
- Dal
- 4,3
|
readwritenonatomicweak |
Pulsante per saltare l'annuncio corrente.
- Dal
- 4,3