Classe GCKSessionManager

Méthodes d'instance | Propriétés
Documentation de référence de la classe GCKSessionManager

Présentation

Classe qui gère les sessions.

La méthode startSessionWithDevice: (GCKSessionManager) permet de créer une session avec un GCKDevice donné. Le gestionnaire de sessions utilise le GCKDeviceProvider pour ce type d'appareil afin de construire un nouvel objet GCKSession, auquel il délègue ensuite toutes les requêtes de session.

GCKSessionManager gère la reprise automatique des sessions suspendues (c'est-à-dire les sessions qui ont pris fin lorsque l'application est passée en arrière-plan, ou en cas de plantage de l'application ou d'arrêt forcé par l'utilisateur). Lorsque l'application reprend ou redémarre, le gestionnaire de session attend un court instant que le fournisseur d'appareil de l'appareil de la session suspendue redécouvre cet appareil. Si c'est le cas, il tente de se reconnecter à cet appareil et de rétablir la session automatiquement.

Si l'application a créé un GCKUICastButton sans fournir de cible ni de sélecteur, un appui de l'utilisateur sur le bouton affichera la boîte de dialogue Cast par défaut, et les sessions démarreront et s'arrêteront automatiquement en fonction de la sélection ou de la déconnexion d'un appareil par l'utilisateur. Toutefois, si l'application fournit sa propre UI de boîte de dialogue de sélection/contrôle des appareils, elle doit utiliser GCKSessionManager directement pour créer et contrôler les sessions.

Que l'application utilise ou non GCKSessionManager pour contrôler les sessions, elle peut associer un GCKSessionManagerListener pour être avertie des événements de session et peut également utiliser KVO pour surveiller la propriété connectionState afin de suivre l'état actuel du cycle de vie de la session.

Depuis
3.0

Hérite de NSObject.

Récapitulatif des méthodes d'instance

(instancetype) - init
 L'initialiseur par défaut n'est pas disponible. Plus
 
(BOOL) - startSessionWithDevice:
 Démarre une nouvelle session avec l'appareil spécifié. Plus
 
(BOOL) - suspendSessionWithReason:
 Suspend la session en cours. Plus
 
(BOOL) - endSession
 Met fin à la session en cours. Plus
 
(BOOL) - endSessionAndStopCasting:
 Met fin à la session en cours et arrête éventuellement la diffusion. Plus
 
(BOOL) - hasConnectedSession
 Teste si une session est actuellement gérée par ce gestionnaire de session et si elle est actuellement connectée. Plus
 
(BOOL) - hasConnectedCastSession
 Teste si une session Cast est actuellement gérée par ce gestionnaire de sessions et si elle est actuellement connectée. Plus
 
(void) - addListener:
 Ajoute un écouteur pour recevoir les notifications. Plus
 
(void) - removeListener:
 Supprime un écouteur précédemment ajouté avec addListener:. Plus
 

Récapitulatif des propriétés

GCKSession * currentSession
 Session en cours, le cas échéant. Plus
 
GCKCastSession * currentCastSession
 Session Cast en cours, le cas échéant. Plus
 
GCKConnectionState connectionState
 État de la connexion de la session en cours. Plus
 

Détails sur la méthode

- (instancetype) init

L'initialiseur par défaut n'est pas disponible.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

Démarre une nouvelle session avec l'appareil spécifié.

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

Parameters
deviceThe device to use for this session.
Renvoie
YES si l'opération a bien démarré, NO si une session est actuellement établie ou si l'opération n'a pas pu démarrer.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason)  reason

Suspend la session en cours.

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

Parameters
reasonThe reason for the suspension.
Renvoie
YES si l'opération a bien démarré, NO s'il n'y a pas de session établie actuellement ou si l'opération n'a pas pu démarrer.
- (BOOL) endSession

Met fin à la session en cours.

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

Renvoie
YES si l'opération a bien démarré, NO s'il n'y a pas de session établie actuellement ou si l'opération n'a pas pu démarrer.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Met fin à la session en cours et arrête éventuellement la diffusion.

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

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
Renvoie
YES si l'opération a bien démarré, NO s'il n'y a pas de session établie actuellement ou si l'opération n'a pas pu démarrer.
- (BOOL) hasConnectedSession

Teste si une session est actuellement gérée par ce gestionnaire de session et si elle est actuellement connectée.

La valeur est YES si l'état de la session est GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

Teste si une session Cast est actuellement gérée par ce gestionnaire de sessions et si elle est actuellement connectée.

La valeur sera YES si l'état de la session est GCKConnectionStateConnected et qu'il s'agit d'une session Cast.

- (void) addListener: (id< GCKSessionManagerListener >)  listener

Ajoute un écouteur pour recevoir les notifications.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

Supprime un écouteur précédemment ajouté avec addListener:.

Parameters
listenerThe listener to remove.

Détails de la propriété

- (GCKSession*) currentSession
readnonatomicstrong

Session en cours, le cas échéant.

- (GCKCastSession*) currentCastSession
readnonatomicstrong

Session Cast en cours, le cas échéant.

- (GCKConnectionState) connectionState
readnonatomicassign

État de la connexion de la session en cours.