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< GCKUIMediaControllerDelegate > | delegate |
| Délégué pour recevoir les notifications de GCKUIMediaController. Plus... | |
| GCKSession * | session |
| 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... | |
| GCKUIMultistateButton * | playPauseToggleButton |
| Un bouton bascule "Lecture/Pause" Plus... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| 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... | |
| GCKUIMultistateButton * | repeatModeButton |
| 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... | |
| GCKUIStreamPositionController * | streamPositionController |
| Contrôleur de position du flux Plus... | |
| GCKUIPlaybackRateController * | playbackRateController |
| 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
-
label The UILabel that will display the value. key The 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
-
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 | |
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
-
textView The UITextView that will display the value. key The 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
-
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 | |
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
-
imageView The UIImageView that will display the selected image. imageHints The 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
-
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 | |
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
-
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 |
Annule la liaison de la vue spécifiée.
- Parameters
-
view The 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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- 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é
|
readwritenonatomicweak |
Délégué pour recevoir les notifications de GCKUIMediaController.
|
readnonatomicstrong |
Session associée à ce contrôleur.
|
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.
|
readnonatomicassign |
Indique si un élément en cours se trouve dans la file d'attente.
|
readnonatomicassign |
Indique si un élément est préchargé dans la file d'attente.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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
|
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.
|
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.
|
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.
|
readwritenonatomicweak |
Bouton permettant de suspendre la lecture de la file d'attente une fois la lecture de l'élément en cours terminée.
|
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.
|
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.
|
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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Le bouton est désactivé si aucune session Cast n'est actuellement active.
|
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.
|
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.
|
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 "--:--".
|
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 "--:--".
|
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 "--:--".
|
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
|
readwritenonatomicstrong |
Un régulateur de vitesse de lecture de flux.
Pour en savoir plus, consultez GCKUIPlaybackRateController.
- Depuis
- 4,0
|
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.
|
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
|
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.
|
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).
|
readwritenonatomicweak |
Affichage d'un indicateur d'activité indiquant que le contenu multimédia est en cours de chargement.
|
readwritenonatomicweak |
Libellé indiquant la durée restante avant que l'annonce ne puisse être ignorée.
- Depuis
- 4,3
|
readwritenonatomicweak |
Un bouton pour ignorer l'annonce actuelle.
- Depuis
- 4,3