Klasa GCKSessionManager

Dokumentacja klasy GCKSessionManager

Opis

Zajęcia do zarządzania sesjami.

Metoda startSessionWithDevice: (GCKSessionManager) służy do tworzenia nowej sesji z określonym GCKDevice. Menedżer sesji używa metody GCKDeviceProvider przeznaczonej dla tego typu urządzenia do utworzenia nowego obiektu GCKSession, do którego przekazuje wszystkie żądania sesji.

GCKSessionManager obsługuje automatyczne wznawianie zawieszonych sesji (czyli wznawiania sesji, które zostały zakończone, gdy aplikacja działała w tle lub w przypadku awarii aplikacji lub wymuszonego zakończenia jej przez użytkownika). Po wznowieniu lub ponownym uruchomieniu aplikacji menedżer sesji poczeka przez krótki czas, aż dostawca urządzenia zawieszonej sesji ponownie wykryje to urządzenie. Jeśli tak się stanie, spróbuje ponownie połączyć się z tym urządzeniem i automatycznie wznowić sesję.

Jeśli aplikacja utworzyła obiekt GCKUICastButton bez ustawienia elementu docelowego i selektora, użytkownik kliknie przycisk, aby wyświetlić domyślne okno przesyłania. Sesje będą się automatycznie rozpoczynać i zatrzymywać w zależności od wyboru użytkownika lub odłączenia urządzenia. Jeśli jednak aplikacja udostępnia własny interfejs okna wyboru urządzenia i sterowania, powinna używać GCKSessionManager bezpośrednio do tworzenia sesji i sterowania nimi.

Niezależnie od tego, czy aplikacja używa GCKSessionManager do sterowania sesjami, czy nie, może dołączyć element GCKSessionManagerListener, aby otrzymywać powiadomienia o zdarzeniach sesji. Może też używać KVO do monitorowania właściwości connectionState w celu śledzenia bieżącego stanu cyklu życia sesji.

Od
3,0

Dziedziczy NSObject.

Podsumowanie metody instancji

(instancetype) - init
 Domyślny inicjator jest niedostępny. Więcej...
 
(BOOL) - startSessionWithDevice:
 Rozpoczyna nową sesję na danym urządzeniu z użyciem domyślnych opcji sesji zarejestrowanych dla danej kategorii urządzenia (jeśli wystąpiły). Więcej...
 
(BOOL) - startSessionWithDevice:sessionOptions:
 Rozpoczyna nową sesję z określonym urządzeniem i opcjami. Więcej...
 
(BOOL) - startSessionWithOpenURLOptions:sessionOptions:
 Próby dołączenia do sesji lub jej rozpoczęcia przy użyciu opcji udostępnionych w metodzie UIApplicationTax::application:openURL:options:. Więcej...
 
(BOOL) - suspendSessionWithReason:
 Zawiesza bieżącą sesję. Więcej...
 
(BOOL) - endSession
 Kończy bieżącą sesję. Więcej...
 
(BOOL) - endSessionAndStopCasting:
 Kończy bieżącą sesję i zatrzymuje przesyłanie, jeśli jest połączone jedno urządzenie nadawcy. W przeciwnym razie opcjonalnie zatrzymuje przesyłanie, jeśli jest połączonych wiele urządzeń nadawcy. Więcej...
 
(BOOL) - hasConnectedSession
 Sprawdza, czy sesja jest obecnie zarządzana przez tego menedżera sesji i czy jest ona obecnie połączona. Więcej...
 
(BOOL) - hasConnectedCastSession
 Sprawdza, czy sesja przesyłania jest aktualnie zarządzana przez tego menedżera sesji i czy jest już połączona. Więcej...
 
(void) - setDefaultSessionOptions:forDeviceCategory:
 Ustawia domyślne opcje sesji w przypadku danej kategorii urządzenia.Opcje sesji są przekazywane do metody createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider), gdy użytkownik wybiera urządzenie w oknie przesyłania. Więcej...
 
(nullable GCKSessionOptions *) - defaultSessionOptionsForDeviceCategory:
 Pobiera domyślne opcje sesji dla danej kategorii urządzenia. Więcej...
 
(void) - addListener:
 Dodaje detektor odbierania powiadomień. Więcej...
 
(void) - removeListener:
 Usuwa detektor, który został wcześniej dodany za pomocą funkcji addListener:. Więcej...
 

Podsumowanie usługi

GCKSessioncurrentSession
 Bieżąca sesja (jeśli istnieje). Więcej...
 
GCKCastSessioncurrentCastSession
 Bieżąca sesja przesyłania (jeśli trwa). Więcej...
 
GCKConnectionState connectionState
 Bieżący stan połączenia w sesji. Więcej...
 

Szczegóły metody

- (instancetype) init

Domyślny inicjator jest niedostępny.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

Rozpoczyna nową sesję na danym urządzeniu z użyciem domyślnych opcji sesji zarejestrowanych dla danej kategorii urządzenia (jeśli wystąpiły).

Jest to operacja asynchroniczna.

Parameters
deviceThe device to use for this session.
Akcje powrotne
YES, jeśli operacja została uruchomiona prawidłowo, NO, jeśli trwa sesja lub jeśli nie udało się jej rozpocząć.
- (BOOL) startSessionWithDevice: (GCKDevice *)  device
sessionOptions: (nullable GCKSessionOptions *)  options 

Rozpoczyna nową sesję z określonym urządzeniem i opcjami.

Jest to operacja asynchroniczna.

Parameters
deviceThe device to use for this session.
optionsThe options for this session, if any. May be nil.
Akcje powrotne
YES, jeśli operacja została uruchomiona prawidłowo, NO, jeśli trwa sesja lub gdy nie można jej rozpocząć.
Od
4,0
- (BOOL) startSessionWithOpenURLOptions: (GCKOpenURLOptions *)  openURLOptions
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

Próby dołączenia do sesji lub jej rozpoczęcia przy użyciu opcji udostępnionych w metodzie UIApplicationTax::application:openURL:options:.

Zwykle jest to prośba o dołączenie do istniejącej sesji przesyłania na danym urządzeniu zainicjowanej przez inną aplikację.

Parameters
openURLOptionsThe options that were extracted from the URL.
sessionOptionsThe options for this session, if any. May be nil.
Akcje powrotne
YES, jeśli operacja została uruchomiona prawidłowo, NO, jeśli trwa sesja lub opcje openURL nie zawierają wymaganych opcji przesyłania.
Od
4,0
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

Zawiesza bieżącą sesję.

Jest to operacja asynchroniczna.

Parameters
reasonThe reason for the suspension.
Akcje powrotne
YES, jeśli operacja została uruchomiona prawidłowo, NO, jeśli obecnie nie jest prowadzona żadna sesja lub jeśli nie udało się jej rozpocząć.
- (BOOL) endSession

Kończy bieżącą sesję.

Jest to operacja asynchroniczna.

Akcje powrotne
YES, jeśli operacja została uruchomiona prawidłowo, NO, jeśli obecnie nie jest prowadzona żadna sesja lub jeśli nie udało się jej rozpocząć.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Kończy bieżącą sesję i zatrzymuje przesyłanie, jeśli jest połączone jedno urządzenie nadawcy. W przeciwnym razie opcjonalnie zatrzymuje przesyłanie, jeśli jest połączonych wiele urządzeń nadawcy.

Parametr stopCasting pozwala określić, czy po zakończeniu sesji przesyłanie na odbiornik ma zostać zatrzymane. Ten parametr ma zastosowanie tylko wtedy, gdy połączonych jest więcej urządzeń nadawcy. Na przykład ta sama aplikacja jest otwarta na wielu urządzeniach nadawcy, a każde urządzenie ma aktywną sesję przesyłania z tym samym urządzeniem odbierającym.

  • Jeśli w ustawieniu stopCasting ustawisz YES, aplikacja odbiornika przestanie przesyłać treści, gdy do połączenia będzie podłączonych się kilka urządzeń.
  • Jeśli stopCasting ma wartość NO, a inne urządzenia mają aktywną sesję, odbiornik kontynuuje odtwarzanie.
  • Jeśli połączone jest tylko jedno urządzenie nadawcy, aplikacja odbierająca przestaje przesyłać multimedia i ignoruje wartość stopCasting, nawet jeśli jest ustawiona na NO.
Parameters
stopCastingWhether casting on the receiver should stop when the session ends. Only used when multiple sender devices are connected.
Akcje powrotne
YES, jeśli operacja zakończenia sesji rozpoczęła się prawidłowo, NO, jeśli w tej chwili nie ma żadnej sesji lub nie udało się jej rozpocząć.
- (BOOL) hasConnectedSession

Sprawdza, czy sesja jest obecnie zarządzana przez tego menedżera sesji i czy jest ona obecnie połączona.

Jeśli stan sesji to GCKConnectionStateConnected, wartość to YES.

- (BOOL) hasConnectedCastSession

Sprawdza, czy sesja przesyłania jest aktualnie zarządzana przez tego menedżera sesji i czy jest już połączona.

Jeśli stan sesji to GCKConnectionStateConnected, a sesja jest sesją przesyłania, przyjmuje wartość YES.

- (void) setDefaultSessionOptions: (nullable GCKSessionOptions *)  sessionOptions
forDeviceCategory: (NSString *)  category 

Ustawia domyślne opcje sesji w przypadku danej kategorii urządzenia.Opcje sesji są przekazywane do metody createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider), gdy użytkownik wybiera urządzenie w oknie przesyłania.

W przypadku sesji przesyłania opcje sesji mogą określać, którą aplikację odbiornika uruchomić.

Parameters
sessionOptionsThe session options. May be nil to remove any previously set options.
categoryThe device category.
Od
4,0
- (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: (NSString *)  category

Pobiera domyślne opcje sesji dla danej kategorii urządzenia.

Parameters
categoryThe device category.
Akcje powrotne
Domyślne opcje sesji lub nil, jeśli nie ma żadnej.
Od
4,0
- (void) addListener: (id< GCKSessionManagerListener >)  listener

Dodaje detektor odbierania powiadomień.

Dodany detektor jest słabo zatrzymany i należy go zachować, aby uniknąć nieoczekiwanej utraty danych.

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

Usuwa detektor, który został wcześniej dodany za pomocą funkcji addListener:.

Parameters
listenerThe listener to remove.

Szczegóły nieruchomości

- (GCKSession*) currentSession
readnonatomicstrong

Bieżąca sesja (jeśli istnieje).

- (GCKCastSession*) currentCastSession
readnonatomicstrong

Bieżąca sesja przesyłania (jeśli trwa).

- (GCKConnectionState) connectionState
readnonatomicassign

Bieżący stan połączenia w sesji.