Classe GCKUIMediaController

Riferimento alla classe GCKUIMediaController

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< GCKUIMediaControllerDelegatedelegate
 Il delegato per aver ricevuto notifiche da GCKUIMediaController. Altro...
 
GCKSessionsession
 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...
 
GCKUIMultistateButtonplayPauseToggleButton
 Un pulsante di attivazione/disattivazione "riproduci/metti in pausa". Altro...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 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...
 
GCKUIMultistateButtonrepeatModeButton
 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...
 
GCKUIStreamPositionControllerstreamPositionController
 Un controller di posizione dello stream. Altro...
 
GCKUIPlaybackRateControllerplaybackRateController
 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
labelThe UILabel that will display the value.
keyThe 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
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA 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
textViewThe UITextView that will display the value.
keyThe 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
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA 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
imageViewThe UIImageView that will display the selected image.
imageHintsThe 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
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
rewindSecondsThe 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
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
forwardSecondsThe number of seconds to skip the media.
- (void) unbindView: (UIView *)  view

Annulla l'associazione della visualizzazione specificata.

Parameters
viewThe 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:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

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à

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

Il delegato per aver ricevuto notifiche da GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

La sessione associata a questo controller.

- (BOOL) mediaLoaded
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.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Indica se è presente un elemento corrente in coda.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Indica se un elemento è precaricato nella coda.

- (GCKMediaPlayerState) lastKnownPlayerState
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.

- (NSTimeInterval) lastKnownStreamPosition
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.

- (UIButton*) playButton
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.

- (UIButton*) pauseButton
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.

- (GCKUIMultistateButton*) playPauseToggleButton
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.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
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
- (UIButton*) stopButton
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.

- (UIButton*) forward30SecondsButton
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.

- (UIButton*) rewind30SecondsButton
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.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Un pulsante per mettere in pausa la riproduzione in coda una volta terminata la riproduzione dell'elemento corrente.

- (UIButton*) nextButton
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.

- (UIButton*) previousButton
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.

- (GCKUIMultistateButton*) repeatModeButton
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:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Il pulsante viene disattivato se al momento non ci sono sessioni di trasmissione attive.

- (UISlider*) streamPositionSlider
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.

- (UIProgressView*) streamProgressView
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.

- (UILabel*) streamPositionLabel
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 "--:--".

- (UILabel*) streamDurationLabel
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 "--:--".

- (UILabel*) streamTimeRemainingLabel
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 "--:--".

- (GCKUIStreamPositionController*) streamPositionController
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
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

Un controller della velocità di riproduzione dello streaming.

Per ulteriori dettagli, consulta GCKUIPlaybackRateController.

Dal
4,0
- (BOOL) displayTimeRemainingAsNegativeValue
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.

- (BOOL) hideStreamPositionControlsForLiveContent
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
- (UIButton*) tracksButton
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.

- (UILabel*) smartSubtitleLabel
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.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Un indicatore di attività che indica che i contenuti multimediali sono in stato di caricamento.

- (UILabel*) skipAdLabel
readwritenonatomicweak

Un'etichetta per visualizzare il tempo rimanente prima che sia possibile saltare l'annuncio.

Dal
4,3
- (UIButton*) skipAdButton
readwritenonatomicweak

Pulsante per saltare l'annuncio corrente.

Dal
4,3