Classe GCKUIMediaController

Documentation de référence sur la classe GCKUIMediaController

Présentation

Contrôleur pour les vues d'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 aux médias auprès du contrôleur en définissant les propriétés appropriées. La télécommande répond ensuite aux événements tactiles des commandes en envoyant les commandes multimédias appropriées au récepteur, puis met à jour les commandes en fonction des informations d'état et des métadonnées multimédias reçues du récepteur. Le contrôleur active et désactive automatiquement les commandes de l'interface utilisateur en fonction de l'état actuel de la session et du lecteur multimédia. En outre, tous les contrôles sont désactivés lorsqu'une requête est en cours.

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

Sincé
3,0

Hérite de NSObject.

Résumé de la méthode d'instance

(instancetype) - init
 Initialise une instance. Plus...
 
(void) - bindLabel:toMetadataKey:
 Lie un UILabel à une clé de métadonnées. Plus...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Lie un UILabel à une clé de métadonnées. Plus...
 
(void) - bindTextView:toMetadataKey:
 Lie un objet UITextView à une clé de métadonnées. Plus...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Lie un objet UITextView à une clé de métadonnées. Plus...
 
(void) - bindImageView:toImageHints:
 Lie une classe UIImageView à une instance GCKUIImageHints. Plus...
 
(void) - unbindView:
 Annule la vue spécifiée. Plus...
 
(void) - unbindAllViews
 Annule toutes les vues lié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 pour afficher l'interface utilisateur de sélection de la piste multimédia. Plus...
 

Récapitulatif de la propriété

id< GCKUIMediaControllerDelegatedelegate
 Délégué de la réception des notifications du GCKUIMediaController. Plus...
 
GCKSessionsession
 Session associée à ce contrôleur. Plus...
 
BOOL mediaLoaded
 Indique si un contenu multimédia est actuellement chargé (ou en cours de chargement) sur le récepteur. Plus...
 
BOOL hasCurrentQueueItem
 Indique s'il y a un élément actuel 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 connu du lecteur multimédia. 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...
 
GCKUIButtonplayPauseToggleButton
 Bouton "Lecture/Pause" Plus...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Commande d'activation/de désactivation "Lecture/Pause". Plus...
 
UIButton * stopButton
 Un bouton "Arrêter" Plus...
 
GCKUIButtonforward30SecondsButton
 Bouton pour avancer de 30 secondes dans l'élément multimédia en cours de lecture. Plus...
 
GCKUIButtonrewind30SecondsButton
 Bouton pour revenir en arrière de 30 secondes dans l'élément multimédia en cours de lecture. Plus...
 
UIButton * pauseQueueButton
 Bouton permettant de suspendre la lecture dans 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...
 
GCKUIButtonrepeatModeButton
 Bouton pour parcourir les modes de répétition disponibles de la file d'attente Plus...
 
UISlider * streamPositionSlider
 Curseur permettant d'afficher et de modifier la position actuelle du flux. Plus...
 
UIProgressView * streamProgressView
 Vue permettant d'afficher la progression du streaming en cours. Plus...
 
UILabel * streamPositionLabel
 Libellé pour afficher la position actuelle du flux, en minutes et en secondes. Plus...
 
UILabel * streamDurationLabel
 Libellé pour afficher la durée actuelle du flux, en minutes et en secondes. Plus...
 
UILabel * streamTimeRemainingLabel
 Libellé pour afficher le temps de diffusion restant (la durée moins la position), en minutes et en secondes. Plus...
 
GCKUIStreamPositionControllerstreamPositionController
 Contrôleur de posdition de flux. Plus...
 
BOOL displayTimeRemainingAsNegativeValue
 Indique si la durée de diffusion restante s'affiche sous forme de valeur négative (par exemple, "-1:23:45"). Plus...
 
UIButton * tracksButton
 Bouton permettant de sélectionner les pistes audio et/ou les sous-titres. Plus...
 
UILabel * smartSubtitleLabel
 Libellé permettant d'afficher un sous-titre pour le contenu multimédia actuellement chargé. Plus...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Vue de l'indicateur d'activité indiquant que le contenu multimédia est en cours de chargement. Plus...
 

Détails sur la méthode

- (instancetype) init

Initialise une instance.

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

Lie un UILabel à 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 

Lie un UILabel à 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 

Lie un objet UITextView à 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 

Lie un objet UITextView à 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 

Lie une classe UIImageView à une instance GCKUIImageHints.

L'outil UIImagePicker actuellement installé permet de sélectionner une image dans les métadonnées de la vue.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) unbindView: (UIView *)  view

Annule la vue spécifiée.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Annule toutes les vues liées.

- (GCKMediaRepeatMode) cycleRepeatMode

Remplace le mode de répétition de la file d'attente par le mode suivant du cycle:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Retours
Le nouveau mode de répétition.
- (void) selectTracks

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

Détails de la propriété

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

Délégué de la réception des notifications du GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

Session associée à ce contrôleur.

- (BOOL) mediaLoaded
readnonatomicassign

Indique si un contenu multimédia est actuellement chargé (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 s'il y a un élément actuel 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 connu du lecteur multimédia.

Si aucune session Cast n'est active, l'état du lecteur est défini juste avant la fin de la dernière session. S'il n'y a pas eu de session précédente, il s'agit de GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

Dernière position connue du flux multimédia.

Si aucune session de diffusion n'est active, il s'agit de la position de diffusion du contenu multimédia juste avant la fin de la session. S'il n'y a pas eu de session précédente, il s'agit de kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Un bouton de lecture

Lorsque vous appuyez sur le bouton, la lecture du contenu multimédia actuellement chargé démarre ou reprend sur le récepteur. Le bouton sera désactivé si la lecture est déjà en cours, si aucun mé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 support actuellement chargé ne prend pas en charge la mise en pause, si la lecture n'est pas en cours, si aucun support n'est actuellement chargé ou si aucune session Cast n'est active.

- (GCKUIButton*) playPauseToggleButton
readwritenonatomicweak

Bouton "Lecture/Pause"

L'appelant doit définir les icônes appropriées pour les états GCKUIControlStatePlay et GCKUIControlStatePause du bouton, à savoir une icône "pause" pour l'état de lecture 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 réactivée sur le récepteur. Le bouton est désactivé si le support actuellement chargé ne prend pas en charge la mise en pause, si la lecture n'est pas en cours ou en pause, si aucun support n'est actuellement chargé, ou si aucune session Cast n'est active.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Commande d'activation/de désactivation "Lecture/Pause".

Utilisé comme solution de remplacement pour une interface utilisateur de lecture/pause personnalisée, fournie par l'application. Pour en savoir plus, consultez GCKUIPlayPauseToggleController.

Sincé
3,4
- (UIButton*) stopButton
readwritenonatomicweak

Un bouton "Arrêter"

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

- (GCKUIButton*) forward30SecondsButton
readwritenonatomicweak

Bouton pour avancer de 30 secondes dans l'élément multimédia en cours de lecture.

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

- (GCKUIButton*) rewind30SecondsButton
readwritenonatomicweak

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

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

- (UIButton*) pauseQueueButton
readwritenonatomicweak

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

- (UIButton*) nextButton
readwritenonatomicweak

Un bouton "Suivant"

Lorsque l'utilisateur appuie sur le bouton, la lecture passe à l'élément multimédia suivant dans la file d'attente. Le bouton sera désactivé si l'opération n'est pas prise en charge, si aucun média n'est actuellement chargé ou si aucune session Cast n'est active.

- (UIButton*) previousButton
readwritenonatomicweak

Un bouton "précédent"

Lorsque l'utilisateur appuie sur le bouton, la lecture passe à l'élément multimédia précédent dans la file d'attente. Le bouton sera désactivé si l'opération n'est pas prise en charge, si aucun média n'est actuellement chargé ou si aucune session Cast n'est active.

- (GCKUIButton*) repeatModeButton
readwritenonatomicweak

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

(Voir GCKMediaRepeatMode.) L'appelant doit définir les icônes appropriées pour les états UIControlStateNormal (répétition), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll et GCKUIControlStateShuffle. 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. Appuyez sur le bouton pour passer au mode de répétition suivant, dans l'ordre:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Le bouton sera désactivé si aucune session Cast n'est en cours.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

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

Lorsque l'utilisateur modifie la valeur du curseur, la position de flux du contenu multimédia actuellement chargé est mise à jour sur le récepteur. Lorsqu'un contenu multimédia est en cours de lecture sur le récepteur, la valeur du curseur est mise à jour en temps réel afin de refléter la position actuelle du flux. Le curseur est désactivé si le support actuellement chargé n'est pas compatible avec la recherche, s'il n'y a pas de support chargé actuellement ou si aucune session Cast n'est active.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Vue permettant d'afficher la progression du streaming en cours.

Lorsqu'un contenu multimédia est en cours de lecture sur le récepteur, la valeur des vues est mise à jour en temps réel afin de refléter la position actuelle du flux. L'affichage sera désactivé si le média actuellement chargé est un flux en direct, s'il n'y a pas de contenu multimédia en cours de chargement ou si aucune session Cast n'est active.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

Libellé pour afficher la position actuelle du flux, en minutes et en secondes.

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

- (UILabel*) streamDurationLabel
readwritenonatomicweak

Libellé pour afficher la durée actuelle du flux, en minutes et en secondes.

Si le support actuellement chargé n'a pas de durée (par exemple, s'il s'agit d'un flux en direct), s'il n'y a pas de support en cours de chargement ou s'il n'y a pas de session Cast actuellement active, le libellé affiche une forme localisée "--:--".

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Libellé pour afficher le temps de diffusion restant (la durée moins la position), en minutes et en secondes.

Si le support actuellement chargé n'a pas de durée (par exemple, s'il s'agit d'un flux en direct), s'il n'y a pas de support en cours de chargement 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 posdition de flux.

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

Sincé
3,4
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Indique si la durée de diffusion restante s'affiche sous forme de valeur négative (par exemple, "-1:23:45").

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

- (UIButton*) tracksButton
readwritenonatomicweak

Bouton permettant de sélectionner les pistes audio et/ou les 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 support actuellement chargé ne comporte aucune piste multimédia sélectionnable, s'il n'y a aucun support en cours de chargement 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-titres n'est explicitement défini dans les métadonnées, le libellé affiche le champ de métadonnées le plus approprié en fonction du type de média, par exemple le nom du studio pour un film ou le nom de l'artiste pour un titre musical.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

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