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 | |
| GCKSession * | currentSession |
| Bieżąca sesja (jeśli istnieje). Więcej... | |
| GCKCastSession * | currentCastSession |
| 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
-
device The 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
-
device The device to use for this session. options The 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
-
openURLOptions The options that were extracted from the URL. sessionOptions The 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
-
reason The 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
stopCastingustawiszYES, aplikacja odbiornika przestanie przesyłać treści, gdy do połączenia będzie podłączonych się kilka urządzeń. - Jeśli
stopCastingma 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 naNO.
- Parameters
-
stopCasting Whether 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
-
sessionOptions The session options. May be nilto remove any previously set options.category The device category.
- Od
- 4,0
| - (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: | (NSString *) | category |
Pobiera domyślne opcje sesji dla danej kategorii urządzenia.
- Parameters
-
category The 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
-
listener The listener to add.
| - (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
Usuwa detektor, który został wcześniej dodany za pomocą funkcji addListener:.
- Parameters
-
listener The listener to remove.
Szczegóły nieruchomości
|
readnonatomicstrong |
Bieżąca sesja (jeśli istnieje).
|
readnonatomicstrong |
Bieżąca sesja przesyłania (jeśli trwa).
|
readnonatomicassign |
Bieżący stan połączenia w sesji.