Classe GCKUIMediaController

Méthodes d'instance | Propriétés

Documentation de référence de la classe GCKUIMediaController

Présentation

Contrôleur pour les vues d'interface utilisateur utilisées pour contrôler ou afficher l'état de la lecture multimédia sur un récepteur Cast.

L'application appelante enregistre ses commandes d'interface utilisateur liées au contenu multimédia auprès du contrôleur en définissant les propriétés appropriées. Le contrôleur répond ensuite aux événements tactiles sur les commandes en émettant les commandes multimédias appropriées au récepteur et met à jour les commandes en fonction des informations sur l'é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'UI en fonction de l'état actuel de la session et du lecteur multimédia. Il désactive également toutes les commandes pendant le traitement d'une requête.

Consultez GCKUIMediaControllerDelegate pour le protocole de délégué.

Depuis

3.0

Hérite de NSObject.

Récapitulatif des méthodes 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 UITextView à une clé de métadonnées. Plus
(void)	- bindTextView:toMetadataKey:withFormatter:
	Lie un UITextView à une clé de métadonnées. Plus
(void)	- bindImageView:toImageHints:
	Lie un UIImageView à une instance GCKUIImageHints. Plus
(void)	- unbindView:
	Dissocie la vue spécifiée. Plus
(void)	- unbindAllViews
	Dissocie toutes les vues liées. Plus
(GCKMediaRepeatMode)	- cycleRepeatMode
	Modifie le mode de répétition de la file d'attente en passant au mode suivant du cycle : Plus d'infos
(void)	- selectTracks
	Méthode pratique pour afficher l'UI de sélection des pistes multimédias. Plus

Récapitulatif des propriétés
id< GCKUIMediaControllerDelegate >	delegate
	Délégué pour la réception des notifications de GCKUIMediaController. Plus
GCKSession *	session
	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 en cours 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
GCKUIButton *	playPauseToggleButton
	Un bouton bascule "Lecture/Pause". Plus
GCKUIPlayPauseToggleController *	playPauseToggleController
	Contrôleur d'activation/désactivation de la lecture/pause. Plus
UIButton *	stopButton
	Un bouton "Arrêter". Plus
GCKUIButton *	forward30SecondsButton
	Bouton permettant d'avancer de 30 secondes dans l'élément multimédia en cours de lecture. Plus
GCKUIButton *	rewind30SecondsButton
	Bouton permettant de revenir 30 secondes en arrière dans l'élément multimédia en cours de lecture. Plus
UIButton *	pauseQueueButton
	Bouton permettant de mettre en pause la lecture de la file d'attente une fois l'élément en cours terminé. Plus
UIButton *	nextButton
	Bouton "Suivant". Plus
UIButton *	previousButton
	Un bouton "Précédent". Plus
GCKUIButton *	repeatModeButton
	Bouton permettant de parcourir les modes de répétition de la 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 du flux actuel. 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 le temps restant de la diffusion (durée moins position), en minutes et en secondes. Plus
GCKUIStreamPositionController *	streamPositionController
	Contrôleur de position de flux. Plus
BOOL	displayTimeRemainingAsNegativeValue
	Indique si le temps de streaming restant doit être affiché sous forme de valeur négative (par exemple, "-1:23:45"). 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
	Vue d'un 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

label	The UILabel that will display the value.
key	The 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

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

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

textView	The UITextView that will display the value.
key	The metadata key.

- (void) bindTextView:		(UITextView *)	textView
toMetadataKey:		(NSString *)	key
withFormatter:		(GCKUIValueFormatter)	formatter

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

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

Lie un UIImageView à une instance GCKUIImageHints.

Le UIImagePicker actuellement installé sera utilisé pour sélectionner une image à partir des métadonnées de la vue.

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView:

(UIView *)

view

Dissocie la vue spécifiée.

Parameters

view	The view to unbind.

- (void) unbindAllViews

Dissocie toutes les vues liées.

- (GCKMediaRepeatMode) cycleRepeatMode

Modifie le mode de répétition de la file d'attente pour passer au mode suivant du cycle :

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Renvoie

Le nouveau mode de répétition.

- (void) selectTracks

Méthode pratique pour afficher l'UI de sélection des pistes multimédias.

Détails de la propriété

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

Délégué pour la réception des notifications de 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, la valeur sera NO.

- (BOOL) hasCurrentQueueItem

readnonatomicassign

Indique s'il y a un élément en cours 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, il s'agit de l'état du lecteur juste avant la fin de la dernière session. Si aucune session précédente n'a eu lieu, la valeur sera GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

Dernière position connue du flux multimédia.

Si aucune session Cast n'est active, il s'agit de la position du flux du contenu multimédia juste avant la fin de la dernière session. Si aucune session précédente n'a eu lieu, la valeur sera kGCKInvalidTimeInterval.

- (UIButton*) playButton

readwritenonatomicweak

Un bouton de lecture

Lorsque l'utilisateur appuie sur le bouton, la lecture du contenu multimédia actuellement chargé démarre 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 chargé ou si aucune session Cast n'est active.

- (UIButton*) pauseButton

readwritenonatomicweak

Un bouton "Pause".

Lorsque l'utilisateur appuie 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é ne permet pas 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 actuellement active.

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

Un bouton bascule "Lecture/Pause".

L'appelant doit définir les icônes appropriées pour les états GCKUIControlStatePlay et GCKUIControlStatePause du bouton, à savoir une icône de 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 l'utilisateur appuie sur le bouton, la lecture du contenu multimédia actuellement chargé est mise en pause ou reprise sur le récepteur. Le bouton sera désactivé si le contenu multimédia actuellement chargé ne permet pas 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 actuellement active.

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

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

Utilisé comme substitut à une UI de bouton bascule lecture/pause personnalisée fournie par l'application. Pour en savoir plus, consultez GCKUIPlayPauseToggleController.

Depuis

3.4

- (UIButton*) stopButton

readwritenonatomicweak

Un bouton "Arrêter".

Lorsque l'utilisateur appuie sur le bouton, la lecture du contenu multimédia actuellement chargé est arrêtée sur le récepteur. Le bouton est désactivé si aucun contenu multimédia n'est chargé ou si aucune session Cast n'est active.

- (GCKUIButton*) 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 chargé ou si aucune session Cast n'est active.

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

Bouton permettant de 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 chargé ou si aucune session Cast n'est active.

- (UIButton*) pauseQueueButton

readwritenonatomicweak

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

- (UIButton*) nextButton

readwritenonatomicweak

Bouton "Suivant".

Lorsque l'utilisateur appuie sur le bouton, la lecture passe à l'élément multimédia suivant de la file d'attente. Le bouton sera désactivé si l'opération n'est pas prise en charge, s'il n'y a pas de contenu multimédia actuellement chargé ou s'il n'y a pas de session Cast 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 de la file d'attente. Le bouton sera désactivé si l'opération n'est pas prise en charge, s'il n'y a pas de contenu multimédia actuellement chargé ou s'il n'y a pas de session Cast active.

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

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

(Voir GCKMediaRepeatMode.) L'appelant doit définir les icônes appropriées pour les états UIControlStateNormal (répétition désactivée), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll et GCKUIControlStateShuffle du bouton. L'état du bouton est automatiquement mis à jour pour refléter le mode Répéter actuel de la file d'attente sur le récepteur. Appuyez sur le bouton pour passer au mode de répétition suivant, dans l'ordre :

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Le bouton sera 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 l'utilisateur modifie la valeur du curseur, la position du flux du contenu multimédia actuellement chargé est mise à jour sur le récepteur. Lorsque la lecture d'un contenu multimédia est en cours 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 sera désactivé si le contenu multimédia actuellement chargé ne permet pas la recherche, s'il n'y a aucun contenu multimédia chargé ou s'il n'y a aucune session Cast active.

- (UIProgressView*) streamProgressView

readwritenonatomicweak

Vue permettant d'afficher la progression du flux actuel.

Pendant la lecture du contenu multimédia sur le récepteur, la valeur de la vue est mise à jour en temps réel pour refléter la position actuelle du flux. La vue sera désactivée si le contenu multimédia actuellement chargé est une diffusion en direct, s'il n'y a aucun contenu multimédia chargé ou s'il n'y a aucune session Cast 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 chargé ou si aucune session Cast n'est active, le libellé affiche "--:--" dans la langue de l'utilisateur.

- (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 (par exemple, s'il s'agit d'un flux en direct), ou si aucun contenu multimédia n'est actuellement chargé, ou si aucune session Cast n'est actuellement active, le libellé affiche "--:--" dans la langue de l'utilisateur.

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

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

Si le contenu multimédia actuellement chargé n'a pas de durée (par exemple, s'il s'agit d'un flux en direct), ou si aucun contenu multimédia n'est actuellement chargé, ou si aucune session Cast n'est actuellement active, le libellé affiche "--:--" dans la langue de l'utilisateur.

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

Contrôleur de position de flux.

Utilisé comme substitut pour une position de flux et/ou une UI de recherche personnalisées fournies par l'application. Pour en savoir plus, consultez GCKUIStreamPositionController.

Depuis

3.4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

Indique si le temps de streaming restant doit être affiché 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 des pistes audio et/ou des sous-titres.

Lorsque l'utilisateur appuie sur le bouton, l'UI de sélection des pistes multimédias s'affiche. Le bouton sera désactivé si le contenu multimédia actuellement chargé ne comporte aucune piste multimédia sélectionnable, s'il n'y a aucun contenu multimédia chargé ou s'il n'y a aucune session Cast 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 explicitement défini dans les métadonnées, le libellé affichera 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 le nom de l'artiste pour un titre musical).

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

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