Classe GCKSessionManager

Documentation de référence sur la classe GCKSessionManager

Présentation

Une 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 GCKDeviceProvider pour ce type d'appareil afin de créer un 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 en réactivant les sessions qui ont pris fin lorsque l'application est passée en arrière-plan, ou en cas de plantage ou d'arrêt forcé de l'utilisateur. Lorsque l'application redémarre ou redémarre, le gestionnaire de sessions attend un court instant jusqu'à ce que le fournisseur de l'appareil de la session suspendue découvre à nouveau l'appareil. Si c'est le cas, il tente de se reconnecter à cet appareil et de rétablir automatiquement la session.

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

Que l'application utilise ou non GCKSessionManager pour contrôler les sessions, elle peut associer une GCKSessionManagerListener pour être informé des événements de session. Elle peut également surveiller les propriétés du cycle de vie de ces sessions à l'aide de KVO pour surveiller la propriété connectionState.

Sincé
3,0

Hérite de NSObject.

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

(instancetype) - init
 L'initialiseur par défaut n'est pas disponible. Plus...
 
(BOOL) - startSessionWithDevice:
 Démarre une nouvelle session avec l'appareil donné. 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 peut éventuellement arrêter 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
 Vérifie si ce gestionnaire de session gère actuellement une session Cast. Plus...
 
(void) - addListener:
 Ajoute un écouteur pour la réception des notifications. Plus...
 
(void) - removeListener:
 Supprime un écouteur précédemment ajouté avec addListener:. Plus...
 

Récapitulatif de la propriété

GCKSessioncurrentSession
 Session en cours, le cas échéant. Plus...
 
GCKCastSessioncurrentCastSession
 Session de diffusion actuelle, le cas échéant. Plus...
 
GCKConnectionState connectionState
 État actuel de la connexion à la session. 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 donné.

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

Parameters
deviceThe device to use for this session.
Retours
YES si l'opération a réussi, NO si une session est actuellement établie ou si l'opération n'a pas pu être lancée.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

Suspend la session en cours.

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

Parameters
reasonThe reason for the suspension.
Retours
YES si l'opération a réussi, NO si aucune session n'est actuellement établie ou si l'opération n'a pas pu être lancée.
- (BOOL) endSession

Met fin à la session en cours.

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

Retours
YES si l'opération a réussi, NO si aucune session n'est actuellement établie ou si l'opération n'a pas pu être lancée.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Met fin à la session en cours, et peut éventuellement arrêter 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.
Retours
YES si l'opération a réussi, NO si aucune session n'est actuellement établie ou si l'opération n'a pas pu être lancée.
- (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 sera YES si l'état de la session est GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

Vérifie si ce gestionnaire de session gère actuellement une session Cast.

La valeur sera YES si l'état de la session est GCKConnectionStateConnected et que la session est une session Cast.

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

Ajoute un écouteur pour la réception des 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 de diffusion actuelle, le cas échéant.

- (GCKConnectionState) connectionState
readnonatomicassign

État actuel de la connexion à la session.