Classe GCKUIMediaController

Documentation de référence de la classe GCKUIMediaController

Présentation

Contrôleur des vues de l'interface utilisateur permettant de contrôler ou d'afficher l'état de la lecture de contenus multimédias sur un récepteur Cast.

L'application appelante enregistre ses commandes d'interface utilisateur liées au média auprès du contrôleur en définissant les propriétés appropriées. La manette répond ensuite aux événements tactiles sur les commandes en envoyant les commandes multimédias appropriées au récepteur, puis les met à jour en fonction des informations d'état et des métadonnées multimédias reçues de celui-ci. Elle active et désactive automatiquement les commandes de l'interface utilisateur en fonction de l'état actuel du lecteur multimédia et de la session. De plus, toutes les commandes sont désactivées lorsqu'une requête est en cours.

Consultez GCKUIMediaControllerDelegate pour connaître le protocole délégué.

Depuis
3,0

Hérite du NSObject.

Résumé des méthodes d'instance

(instancetype) - init
 Initialise une instance. Plus...
 
(void) - bindLabel:toMetadataKey:
 Liaison entre un UILabel et une clé de métadonnées. Plus...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Liaison entre un UILabel et une clé de métadonnées. Plus...
 
(void) - bindTextView:toMetadataKey:
 Liaison entre une classe UITextView et une clé de métadonnées Plus...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Liaison entre une classe UITextView et une clé de métadonnées Plus...
 
(void) - bindImageView:toImageHints:
 Liaison entre une classe UIImageView et une instance GCKUIImageHints Plus...
 
(void) - bindControlView:toRewindForTime:
 Lie un élément UIControl pour revenir en arrière dans la lecture de l'élément actuel en fonction de la valeur transmise (en secondes). Plus...
 
(void) - bindControlView:toForwardForTime:
 Lie une UIControl pour avancer la lecture de l'élément actuel selon la valeur transmise en secondes. Plus...
 
(void) - unbindView:
 Annule la liaison de la vue spécifiée. Plus...
 
(void) - unbindAllViews
 Dissocie toutes les vues associées. Plus...
 
(GCKMediaRepeatMode- cycleRepeatMode
 Passe le mode de répétition de la file d'attente au mode suivant du cycle: Plus...
 
(void) - selectTracks
 Méthode pratique permettant d'afficher l'interface utilisateur de sélection de la piste multimédia. Plus...
 
(void) - skipAd
 Envoie et contrôle la demande d'annonce "Ignorer". Plus...
 

Résumé de la propriété

id< GCKUIMediaControllerDelegatedelegate
 Délégué pour recevoir les notifications de GCKUIMediaController. Plus...
 
GCKSessionsession
 Session associée à ce contrôleur. Plus...
 
BOOL mediaLoaded
 Indique si un contenu multimédia est en cours de chargement (ou en cours de chargement) sur le récepteur. Plus...
 
BOOL hasCurrentQueueItem
 Indique si un élément en cours se trouve dans la file d'attente. Plus...
 
BOOL hasLoadingQueueItem
 Indique si un élément est préchargé dans la file d'attente. Plus...
 
GCKMediaPlayerState lastKnownPlayerState
 Dernier état du lecteur multimédia connu. Plus...
 
NSTimeInterval lastKnownStreamPosition
 Dernière position connue du flux multimédia. Plus...
 
UIButton * playButton
 Un bouton de lecture Plus...
 
UIButton * pauseButton
 Un bouton « Pause ». Plus...
 
GCKUIMultistateButtonplayPauseToggleButton
 Un bouton bascule "Lecture/Pause" Plus...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Contrôleur d'activation/désactivation de la lecture Plus...
 
UIButton * stopButton
 Un bouton "Arrêter" Plus...
 
UIButton * forward30SecondsButton
 Bouton permettant d'avancer de 30 secondes dans l'élément multimédia en cours de lecture Plus...
 
UIButton * rewind30SecondsButton
 Un bouton pour revenir 30 secondes en arrière dans l'élément multimédia en cours de lecture. Plus...
 
UIButton * pauseQueueButton
 Bouton permettant de suspendre la lecture de la file d'attente une fois la lecture de l'élément en cours terminée. Plus...
 
UIButton * nextButton
 Un bouton "Suivant" Plus...
 
UIButton * previousButton
 Un bouton "Précédent" Plus...
 
GCKUIMultistateButtonrepeatModeButton
 Bouton pour parcourir les modes de répétition de file d'attente disponibles. Plus...
 
UISlider * streamPositionSlider
 Curseur permettant d'afficher et de modifier la position actuelle du flux. Plus...
 
UIProgressView * streamProgressView
 Vue permettant d'afficher la progression actuelle de la diffusion. Plus...
 
UILabel * streamPositionLabel
 Libellé permettant d'afficher la position actuelle du flux, en minutes et en secondes. Plus...
 
UILabel * streamDurationLabel
 Libellé permettant d'afficher la durée actuelle du flux, en minutes et en secondes. Plus...
 
UILabel * streamTimeRemainingLabel
 Libellé permettant d'afficher la durée restante du flux (la durée moins la position), en minutes et en secondes. Plus...
 
GCKUIStreamPositionControllerstreamPositionController
 Contrôleur de position du flux Plus...
 
GCKUIPlaybackRateControllerplaybackRateController
 Un régulateur de vitesse de lecture de flux. Plus...
 
BOOL displayTimeRemainingAsNegativeValue
 Indique si la durée restante de la diffusion doit être affichée sous forme de valeur négative (par exemple, "-1:23:45"). Plus...
 
BOOL hideStreamPositionControlsForLiveContent
 Indique si les commandes de position du flux (y compris le curseur de position et le libellé de position du flux, le libellé de durée et la vue de progression du flux) doivent être masquées pour le contenu en direct. Plus...
 
UIButton * tracksButton
 Bouton permettant de sélectionner des pistes audio et/ou des sous-titres. Plus...
 
UILabel * smartSubtitleLabel
 Libellé permettant d'afficher un sous-titre pour le contenu multimédia actuellement chargé. Plus...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Affichage d'un indicateur d'activité indiquant que le contenu multimédia est en cours de chargement. Plus...
 
UILabel * skipAdLabel
 Libellé indiquant la durée restante avant que l'annonce ne puisse être ignorée. Plus...
 
UIButton * skipAdButton
 Un bouton pour ignorer l'annonce actuelle. Plus...
 

Détails sur la méthode

- (instancetype) init

Initialise une instance.

- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key 

Liaison entre un UILabel et une clé de métadonnées.

La vue affiche la valeur actuelle du champ de métadonnées correspondant.

Consultez GCKMediaMetadata pour obtenir la liste des clés de métadonnées prédéfinies.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Liaison entre un UILabel et une clé de métadonnées.

La vue affiche la valeur actuelle du champ de métadonnées correspondant.

Consultez GCKMediaMetadata pour obtenir la liste des clés de métadonnées prédéfinies.

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 

Liaison entre une classe UITextView et une clé de métadonnées

La vue affiche la valeur actuelle du champ de métadonnées correspondant.

Consultez GCKMediaMetadata pour obtenir la liste des clés de métadonnées prédéfinies.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Liaison entre une classe UITextView et une clé de métadonnées

La vue affiche la valeur actuelle du champ de métadonnées correspondant.

Consultez GCKMediaMetadata pour obtenir la liste des clés de métadonnées prédéfinies.

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 

Liaison entre une classe UIImageView et une instance GCKUIImageHints

Le GCKUIImagePicker actuellement installé permettra de sélectionner une image parmi les métadonnées de la vue.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) bindControlView: (UIControl *)  control
toRewindForTime: (NSTimeInterval)  rewindSeconds 

Lie un élément UIControl pour revenir en arrière dans la lecture de l'élément actuel en fonction de la valeur transmise (en secondes).

La vue est mise à jour en fonction de l'état de la GCKCastSession et de la lecture à distance, et selon qu'il s'agit ou non d'une diffusion en direct. Une cible est également ajoutée à UIControl pour capturer l'événement UIControlEventTouchUpInside. N'ajoutez pas de cible de ce type sur UIControl. Pour capturer l'événement, utilisez plutôt les méthodes 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 

Lie une UIControl pour avancer la lecture de l'élément actuel selon la valeur transmise en secondes.

La vue est mise à jour en fonction de l'état de la GCKCastSession et de la lecture à distance, et selon qu'il s'agit ou non d'une diffusion en direct. Une cible est également ajoutée à UIControl pour capturer l'événement UIControlEventTouchUpInside. N'ajoutez pas de cible de ce type sur UIControl. Pour capturer l'événement, utilisez plutôt les méthodes 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

Annule la liaison de la vue spécifiée.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Dissocie toutes les vues associées.

- (GCKMediaRepeatMode) cycleRepeatMode

Définit le mode de répétition de la file d'attente sur le mode suivant du cycle:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Renvoie
Nouveau mode de répétition.
- (void) selectTracks

Méthode pratique permettant d'afficher l'interface utilisateur de sélection de la piste multimédia.

- (void) skipAd

Envoie et contrôle la demande d'annonce "Ignorer".

Depuis
4,3

Détails de la propriété

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

Délégué pour recevoir les notifications de GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

Session associée à ce contrôleur.

- (BOOL) mediaLoaded
readnonatomicassign

Indique si un contenu multimédia est en cours de chargement (ou en cours de chargement) sur le récepteur.

Si aucune session Cast n'est active, il s'agit de NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Indique si un élément en cours se trouve dans la file d'attente.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Indique si un élément est préchargé dans la file d'attente.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

Dernier état du lecteur multimédia connu.

Si aucune session Cast n'est active, l'état du lecteur est affiché juste avant la fin de la dernière session. En l'absence de session précédente, la valeur sera GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

Dernière position connue du flux multimédia.

Si aucune session de diffusion n'est active, la position du contenu multimédia est affichée juste avant la fin de la dernière session. En l'absence de session précédente, la valeur est kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Un bouton de lecture

Lorsque vous appuyez sur le bouton, la lecture du contenu multimédia actuellement chargé commence ou reprend sur le récepteur. Le bouton est désactivé si la lecture est déjà en cours, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est en cours.

- (UIButton*) pauseButton
readwritenonatomicweak

Un bouton « Pause ».

Lorsque vous appuyez sur le bouton, la lecture du contenu multimédia actuellement chargé est mise en pause sur le récepteur. Le bouton est désactivé si le contenu multimédia actuellement chargé n'est pas compatible avec la mise en pause, si la lecture n'est pas en cours, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est en cours.

- (GCKUIMultistateButton*) playPauseToggleButton
readwritenonatomicweak

Un bouton bascule "Lecture/Pause"

L'appelant doit définir les icônes appropriées pour les états GCKUIButtonStatePlay, GCKUIButtonStatePlayLive et GCKUIButtonStatePause du bouton, à savoir une icône de pause pour l'état de lecture, une icône d'arrêt pour l'état de lecture en direct et une icône de lecture pour l'état de pause. L'état du bouton est automatiquement mis à jour pour refléter l'état de lecture actuel sur le récepteur. Lorsque vous appuyez sur le bouton, la lecture du contenu multimédia actuellement chargé est mise en pause ou reprise sur le récepteur. Le bouton est désactivé si le contenu multimédia actuellement chargé n'est pas compatible avec la mise en pause, si la lecture n'est pas en cours ou en pause, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est en cours.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Contrôleur d'activation/désactivation de la lecture

Il peut servir de complément à une interface utilisateur personnalisée d'activation/de désactivation de la lecture et de la mise en pause. Pour en savoir plus, consultez GCKUIPlayPauseToggleController.

Depuis
3,4
- (UIButton*) stopButton
readwritenonatomicweak

Un bouton "Arrêter"

Lorsque vous appuyez sur le bouton, la lecture du contenu multimédia actuellement chargé est interrompue sur le récepteur. Le bouton est désactivé si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIButton*) forward30SecondsButton
readwritenonatomicweak

Bouton permettant d'avancer de 30 secondes dans l'élément multimédia en cours de lecture

Le bouton est désactivé si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIButton*) rewind30SecondsButton
readwritenonatomicweak

Un bouton pour revenir 30 secondes en arrière dans l'élément multimédia en cours de lecture.

Le bouton est désactivé si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Bouton permettant de suspendre la lecture de la file d'attente une fois la lecture de l'élément en cours terminée.

- (UIButton*) nextButton
readwritenonatomicweak

Un bouton "Suivant"

Lorsque vous appuyez sur le bouton, la lecture passe à l'élément multimédia suivant dans la file d'attente. Le bouton est désactivé si l'opération n'est pas possible, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIButton*) previousButton
readwritenonatomicweak

Un bouton "Précédent"

Lorsque vous appuyez sur le bouton, la lecture passe à l'élément multimédia précédent dans la file d'attente. Le bouton est désactivé si l'opération n'est pas possible, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (GCKUIMultistateButton*) repeatModeButton
readwritenonatomicweak

Bouton pour parcourir les modes de répétition de file d'attente disponibles.

(Voir GCKMediaRepeatMode.) L'appelant doit définir les icônes appropriées pour les états GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll et GCKUIButtonStateShuffle du bouton. L'état du bouton est automatiquement mis à jour pour refléter le mode de répétition de la file d'attente actuel sur le récepteur. Appuyer sur le bouton permet de passer au mode de répétition suivant, dans l'ordre suivant:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Le bouton est désactivé si aucune session Cast n'est actuellement active.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

Curseur permettant d'afficher et de modifier la position actuelle du flux.

Lorsque la valeur du curseur est modifiée par l'utilisateur, la position du flux du contenu multimédia actuellement chargé est mise à jour sur le récepteur. Pendant la lecture du contenu multimédia sur le récepteur, la valeur du curseur est mise à jour en temps réel pour refléter la position actuelle du flux. Le curseur est désactivé si le contenu multimédia actuellement chargé n'est pas compatible avec la recherche, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Vue permettant d'afficher la progression actuelle de la diffusion.

Pendant la lecture du contenu multimédia sur le récepteur, la valeur des vues est mise à jour en temps réel pour refléter la position actuelle du flux. L'affichage est désactivé si le contenu multimédia actuellement chargé est un flux en direct, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

Libellé permettant d'afficher la position actuelle du flux, en minutes et en secondes.

Si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active, le libellé affiche la forme localisée "--:--".

- (UILabel*) streamDurationLabel
readwritenonatomicweak

Libellé permettant d'afficher la durée actuelle du flux, en minutes et en secondes.

Si le contenu multimédia actuellement chargé n'a pas de durée (s'il s'agit d'une diffusion en direct, par exemple), s'il n'y a aucun contenu multimédia actuellement chargé ou s'il n'y a pas de session Cast actuellement active, le libellé affiche une forme localisée "--:--".

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Libellé permettant d'afficher la durée restante du flux (la durée moins la position), en minutes et en secondes.

Si le contenu multimédia actuellement chargé n'a pas de durée (s'il s'agit d'une diffusion en direct, par exemple), s'il n'y a aucun contenu multimédia actuellement chargé ou s'il n'y a pas de session Cast actuellement active, le libellé affiche une forme localisée "--:--".

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

Contrôleur de position du flux

Utilisé comme substitut pour une position de flux personnalisée et/ou une interface utilisateur de recherche, fournie par l'application. Pour en savoir plus, consultez GCKUIStreamPositionController.

Depuis
3,4
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

Un régulateur de vitesse de lecture de flux.

Pour en savoir plus, consultez GCKUIPlaybackRateController.

Depuis
4,0
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Indique si la durée restante de la diffusion doit être affichée sous forme de valeur négative (par exemple, "-1:23:45").

Par défaut, cette propriété est définie sur YES.

- (BOOL) hideStreamPositionControlsForLiveContent
readwritenonatomicassign

Indique si les commandes de position du flux (y compris le curseur de position et le libellé de position du flux, le libellé de durée et la vue de progression du flux) doivent être masquées pour le contenu en direct.

La valeur par défaut est NO.

Depuis
4,0
- (UIButton*) tracksButton
readwritenonatomicweak

Bouton permettant de sélectionner des pistes audio et/ou des sous-titres.

Lorsque l'utilisateur appuie sur le bouton, l'interface utilisateur de sélection des pistes multimédias s'affiche. Le bouton est désactivé si le média actuellement chargé ne comporte aucune piste multimédia sélectionnable, si aucun contenu multimédia n'est actuellement chargé ou si aucune session Cast n'est active.

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

Libellé permettant d'afficher un sous-titre pour le contenu multimédia actuellement chargé.

Si aucun champ de sous-titre n'est défini explicitement dans les métadonnées, la maison de disques affiche le champ de métadonnées le plus approprié en fonction du type de contenu multimédia (par exemple, le nom du studio pour un film ou celui de l'artiste pour une piste musicale).

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Affichage d'un indicateur d'activité indiquant que le contenu multimédia est en cours de chargement.

- (UILabel*) skipAdLabel
readwritenonatomicweak

Libellé indiquant la durée restante avant que l'annonce ne puisse être ignorée.

Depuis
4,3
- (UIButton*) skipAdButton
readwritenonatomicweak

Un bouton pour ignorer l'annonce actuelle.

Depuis
4,3