Classe GCKCastSession

Référence de la classe GCKCastSession

Présentation

Une classe qui gère une session Cast avec un appareil récepteur.

Les sessions sont créées et gérées automatiquement par le GCKSessionManager. L'application ne doit pas appeler directement les méthodes de cycle de vie de la session telles que start (GCKSession(Protected)) ou endWithAction: (GCKSession(Protected)).

Depuis
3,0

Hérite de GCKSession.

Résumé des méthodes d'instance

(instancetype) - initWithDevice:sessionID:sessionOptions:castOptions:
 Construit une session Cast avec les options Cast spécifiées. Plus...
 
(BOOL) - addChannel:
 Enregistre un canal avec la session. Plus...
 
(BOOL) - removeChannel:
 Supprime un canal précédemment enregistré de la session. Plus...
 
(void) - addDeviceStatusListener:
 Ajoute un GCKCastDeviceStatusListener à la liste des écouteurs de cet objet. Plus...
 
(void) - removeDeviceStatusListener:
 Supprime un GCKCastDeviceStatusListener de la liste des écouteurs de cet objet. Plus...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 Définit le volume d'un appareil spécifique dans un groupe multizone. Plus...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 Définit l'état du son d'un appareil spécifique dans un groupe multizone. Plus...
 
(GCKRequest *) - requestMultizoneStatus
 Demander l'état multizone à un groupe multizone Plus...
 
(instancetype) - initWithDevice:traits:sessionID:
 Initialise un nouvel objet de session pour l'appareil donné, avec des options par défaut. Plus...
 
(instancetype) - initWithDevice:traits:sessionID:sessionOptions:
 Initialise un nouvel objet de session pour l'appareil donné. Plus...
 
(GCKRequest *) - setDeviceVolume:
 Règle le volume de l'appareil. Plus...
 
(GCKRequest *) - setDeviceMuted:
 Définit le mode silencieux de l'appareil. Plus...
 
(void) - start
 Démarre la session. Plus...
 
(void) - endWithAction:
 Met fin à la session avec l'action spécifiée. Plus...
 
(void) - notifyDidStartWithSessionID:
 Appelée par des sous-classes pour avertir le framework que la session a démarré. Plus...
 
(void) - notifyDidFailToStartWithError:
 Appelée par des sous-classes pour avertir le framework que la session n'a pas pu démarrer. Plus...
 
(void) - notifyDidEndWithError:willTryToResume:
 Appelée par des sous-classes pour avertir le framework que la session est terminée. Plus...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 Appelée par des sous-classes pour avertir le framework que l'appareil a reçu une mise à jour du volume et de l'état de désactivation du son. Plus...
 
(void) - notifyDidReceiveDeviceStatus:
 Appelée par des sous-classes pour avertir le framework que l'appareil a reçu un état mis à jour. Plus...
 
(void) - notifyDidSuspendWithReason:
 Obsolète, ne pas utiliser. Implémenté en tant que no-op. Plus...
 
(void) - notifyDidResume
 Obsolète, ne pas utiliser. Implémenté en tant que no-op. Plus...
 

Résumé de la propriété

GCKActiveInputStatus activeInputStatus
 État "Entrée active " actuel de l'appareil. Plus...
 
GCKStandbyStatus standbyStatus
 État de veille actuel de l'appareil. Plus...
 
GCKApplicationMetadataapplicationMetadata
 Métadonnées de l'application réceptrice en cours d'exécution sur l'appareil récepteur, le cas échéant. Sinon, nil. Plus...
 
GCKDevicedevice
 Appareil auquel cette session est associée. Plus...
 
NSString * sessionID
 L'ID de session actuel, le cas échéant Plus...
 
GCKSessionOptions * sessionOptions
 Options de session, le cas échéant. Plus...
 
GCKConnectionState connectionState
 État actuel de la connexion de la session. Plus...
 
BOOL suspended
 Indique si la session est actuellement suspendue. Plus...
 
NSString * deviceStatusText
 Texte indiquant l'état actuel de l'appareil. Plus...
 
GCKSessionTraitstraits
 Traits de session. Plus...
 
float currentDeviceVolume
 Volume actuel de l'appareil, compris dans la plage [0,0, 1,0]. Plus...
 
BOOL currentDeviceMuted
 État actuel du mode silencieux de l'appareil. Plus...
 
GCKRemoteMediaClientremoteMediaClient
 Objet GCKRemoteMediaClient qui peut être utilisé pour contrôler la lecture des contenus multimédias dans cette session. Plus...
 
GCKMediaMetadatamediaMetadata
 Métadonnées multimédias actuelles, le cas échéant. Plus...
 

Détails sur la méthode

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions
castOptions: (GCKCastOptions *)  castOptions 

Construit une session Cast avec les options Cast spécifiées.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
sessionOptionsThe session options, if any; otherwise nil.
castOptionsThe Cast options.
Depuis
4,0
- (BOOL) addChannel: (GCKCastChannel *)  channel

Enregistre un canal avec la session.

Si la session est connectée et que l'application réceptrice accepte l'espace de noms du canal, le canal est automatiquement connecté. Si la session n'est pas connectée, le canal reste déconnecté jusqu'au démarrage de la session.

Parameters
channelThe channel to register.
Renvoie
YES si la chaîne a bien été enregistrée, ou NO dans le cas contraire.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Supprime un canal précédemment enregistré de la session.

Parameters
channelThe channel to unregister.
Renvoie
YES si l'enregistrement de la chaîne a abouti, NO dans le cas contraire.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Ajoute un GCKCastDeviceStatusListener à la liste des écouteurs de cet objet.

L'écouteur ajouté est faiblement détenu et doit être conservé pour éviter une désallocation inattendue.

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Supprime un GCKCastDeviceStatusListener de la liste des écouteurs de cet objet.

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Définit le volume d'un appareil spécifique dans un groupe multizone.

Il s'agit d'une opération asynchrone.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
Renvoie
Un objet GCKRequest pour suivre la requête.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Définit l'état du son d'un appareil spécifique dans un groupe multizone.

Il s'agit d'une opération asynchrone.

Parameters
mutedThe new muted state.
deviceThe multizone device.
Renvoie
Un objet GCKRequest pour suivre la requête.
- (GCKRequest *) requestMultizoneStatus

Demander l'état multizone à un groupe multizone

Il s'agit d'une opération asynchrone. Lorsque l'état multizone est reçu, la méthode déléguée castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) est envoyée par message.

Renvoie
Un objet GCKRequest pour suivre la requête.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID 

Initialise un nouvel objet de session pour l'appareil donné, avec des options par défaut.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

Initialise un nouvel objet de session pour l'appareil donné.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.
sessionOptionsThe session options, if any; otherwise nil.
Depuis
4,0
- (GCKRequest *) setDeviceVolume: (float)  volume

Règle le volume de l'appareil.

Il s'agit d'une opération asynchrone. L'implémentation par défaut est une opération no-op qui fait échouer la requête avec une erreur GCKErrorCodeUnsupportedFeature.

Parameters
volumeThe new volume.
Renvoie
Un objet GCKRequest pour suivre la requête.
Depuis
3.4 ; dans les versions précédentes du framework, cette méthode renvoyait void.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

Définit le mode silencieux de l'appareil.

Il s'agit d'une opération asynchrone. L'implémentation par défaut est une opération no-op qui fait échouer la requête avec une erreur GCKErrorCodeUnsupportedFeature.

Parameters
mutedThe new mute state.
Renvoie
Un objet GCKRequest pour suivre la requête.
Depuis
3.4 ; dans les versions précédentes du framework, cette méthode renvoyait void.
- (void) start

Démarre la session.

Il s'agit d'une opération asynchrone. Doit être remplacé par les sous-classes.

Fourni par la catégorie GCKSession(Protected).

- (void) endWithAction: (GCKSessionEndAction action

Met fin à la session avec l'action spécifiée.

Il s'agit d'une opération asynchrone. Doit être remplacé par les sous-classes.

Parameters
actionThe action to take when ending the session; see GCKSessionEndAction for more details.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

Appelée par des sous-classes pour avertir le framework que la session a démarré.

Parameters
sessionIDThe session's unique ID.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (GCKError *)  error

Appelée par des sous-classes pour avertir le framework que la session n'a pas pu démarrer.

Parameters
errorThe error that occurred.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidEndWithError: (nullable NSError *)  error
willTryToResume: (BOOL)  willTryToResume 

Appelée par des sous-classes pour avertir le framework que la session est terminée.

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResumeWhether the session will try to resume itself automatically.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidReceiveDeviceVolume: (float)  volume
muted: (BOOL)  muted 

Appelée par des sous-classes pour avertir le framework que l'appareil a reçu une mise à jour du volume et de l'état de désactivation du son.

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidReceiveDeviceStatus: (nullable NSString *)  statusText

Appelée par des sous-classes pour avertir le framework que l'appareil a reçu un état mis à jour.

Parameters
statusTextThe new status.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

Obsolète, ne pas utiliser : implémenté en tant que no-op.

Deprecated:
Ne pas appeler.

Fourni par la catégorie GCKSession(Protected).

- (void) notifyDidResume

Obsolète, ne pas utiliser : implémenté en tant que no-op.

Deprecated:
Ne pas appeler.

Fourni par la catégorie GCKSession(Protected).

Détails de la propriété

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

État "Entrée active " actuel de l'appareil.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

État de veille actuel de l'appareil.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

Métadonnées de l'application réceptrice en cours d'exécution sur l'appareil récepteur, le cas échéant. Sinon, nil.

- (GCKDevice*) device
readnonatomicstronginherited

Appareil auquel cette session est associée.

- (NSString*) sessionID
readnonatomiccopyinherited

L'ID de session actuel, le cas échéant

- (GCKSessionOptions*) sessionOptions
readnonatomicstronginherited

Options de session, le cas échéant.

Depuis
4,0
- (GCKConnectionState) connectionState
readnonatomicassigninherited

État actuel de la connexion de la session.

- (BOOL) suspended
readnonatomicassigninherited

Indique si la session est actuellement suspendue.

Deprecated:
GCKSession ne peut plus être suspendu. Si nécessaire, déplacez cette fonctionnalité vers une sous-classe.
- (NSString*) deviceStatusText
readnonatomiccopyinherited

Texte indiquant l'état actuel de l'appareil.

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

Traits de session.

- (float) currentDeviceVolume
readnonatomicassigninherited

Volume actuel de l'appareil, compris dans la plage [0,0, 1,0].

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

État actuel du mode silencieux de l'appareil.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

Objet GCKRemoteMediaClient qui peut être utilisé pour contrôler la lecture des contenus multimédias dans cette session.

Il est défini sur nil avant le début de la session ou si la session n'est pas compatible avec l'API GCKRemoteMediaClient. Les sous-classes qui fournissent une interface GCKRemoteMediaClient doivent remplacer la méthode getter.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstronginherited

Métadonnées multimédias actuelles, le cas échéant.

La valeur est nil si la session n'est pas compatible avec l'espace de noms multimédia ou si aucun contenu multimédia n'est actuellement chargé sur le récepteur.