Omówienie
Kontroler urządzeń przesyłających.
Te zajęcia pozwalają wysyłać wiadomości do, a także odbierać wiadomości oraz uruchamiać i zamykać aplikacje uruchomione na urządzeniu przesyłającym.
Instancja GCKDeviceManager musi pozostawać w zakresie tak długo, jak nawiązane jest połączenie z urządzeniem przesyłającym, trwa jego tworzenie lub zerwanie. Można bezpiecznie zwolnić obiekt przed uruchomieniem połączenia z connect (GCKDeviceManager) albo po wywołaniu wywołania zwrotnego deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) lub deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).
- Deprecated:
- Używaj GCKSessionManager i GCKCastSession do interakcji z odbiornikami Cast.
Dziedziczy NSObject.
Podsumowanie metody instancji | |
(instancetype) | - initWithDevice:clientPackageName: |
Tworzy nowy obiekt GCKDeviceManager z danym urządzeniem. Więcej... | |
(instancetype) | - initWithDevice:clientPackageName:ignoreAppStateNotifications: |
Wyznaczony inicjator. Więcej... | |
(void) | - connect |
Łączy się z urządzeniem. Więcej... | |
(void) | - disconnect |
Odłącza urządzenie. Więcej... | |
(void) | - disconnectWithLeave: |
Odłącza urządzenie. Więcej... | |
(BOOL) | - addChannel: |
Dodaje kanał, który może wysyłać i odbierać wiadomości na tym urządzeniu w określonej przestrzeni nazw. Więcej... | |
(BOOL) | - removeChannel: |
Usuwa wcześniej dodany kanał. Więcej... | |
(NSInteger) | - launchApplication: |
Uruchamia aplikację. Więcej... | |
(NSInteger) | - launchApplication:withLaunchOptions: |
Uruchamia aplikację przy użyciu podanych opcji uruchamiania. Więcej... | |
(NSInteger) | - launchApplication:relaunchIfRunning: |
Uruchamia aplikację. Opcjonalnie możesz ją uruchomić ponownie, jeśli już działa. Więcej... | |
(NSInteger) | - joinApplication: |
Dołącza do aplikacji. Więcej... | |
(NSInteger) | - joinApplication:sessionID: |
Dołącza do aplikacji z określonym identyfikatorem sesji aplikacji. Więcej... | |
(BOOL) | - leaveApplication |
Opuszcza bieżącą aplikację. Więcej... | |
(NSInteger) | - stopApplication |
Zatrzymuje uruchamianie uruchomionych aplikacji. Więcej... | |
(NSInteger) | - stopApplicationWithSessionID: |
Zatrzymuje aplikację o podanym identyfikatorze sesji aplikacji. Więcej... | |
(NSInteger) | - setVolume: |
Ustawia głośność systemu. Więcej... | |
(NSInteger) | - setMuted: |
Włącza lub wyłącza wyciszenie. Więcej... | |
(NSInteger) | - requestDeviceStatus |
Żąda bieżącego stanu urządzenia. Więcej... | |
Podsumowanie usługi | |
BOOL | ignoreAppStateNotifications |
Określa, czy ten obiekt będzie nasłuchiwać powiadomień o stanie aplikacji. Więcej... | |
GCKConnectionState | connectionState |
Aktualny stan połączenia menedżera urządzenia. Więcej... | |
GCKConnectionState | applicationConnectionState |
Bieżący stan połączenia z menedżerem urządzenia. Więcej... | |
BOOL | isConnected |
Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z urządzeniem. Więcej... | |
BOOL | isConnectedToApp |
Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z aplikacją na urządzeniu. Więcej... | |
BOOL | isReconnecting |
Wartość to „prawda”, jeśli menedżer urządzenia został odłączony z powodu potencjalnie tymczasowego zdarzenia (np. aplikacja jest w tle lub wystąpił błąd sieci, który można rozwiązać przez ponowne połączenie). Więcej... | |
NSTimeInterval | reconnectTimeout |
W takim przypadku zostanie podjęta próba ponownego połączenia, gdy gniazdo zostanie odłączone z powodu potencjalnie przejściowego błędu. Więcej... | |
GCKDevice * | device |
Urządzenie, którym steruje to urządzenie GCKDeviceManager. Więcej... | |
id< GCKDeviceManagerDelegate > | delegate |
Osoba, której przekazano dostęp do powiadomień z GCKDeviceManager. Więcej... | |
float | deviceVolume |
Obecna głośność urządzenia w zakresie [0,0, 1,0], jeśli jest znana. W innych przypadkach 0. Więcej... | |
BOOL | deviceMuted |
Bieżący stan wyciszenia urządzenia, jeśli jest znany. W przeciwnym razie NO . Więcej... | |
GCKActiveInputStatus | activeInputStatus |
Obecny stan aktywności urządzenia. Więcej... | |
GCKStandbyStatus | standbyStatus |
Obecny stan gotowości urządzenia. Więcej... | |
NSString * | applicationSessionID |
Identyfikator sesji aplikacji aktualnie powiązanej aplikacji odbiorcy. W przeciwnym razie nil . Więcej... | |
GCKApplicationMetadata * | applicationMetadata |
Metadane aplikacji odbiorcy, która jest obecnie uruchomiona na odbiorniku. W przeciwnym razie nil . Więcej... | |
NSString * | applicationStatusText |
Ostatni raport o stanie z obecnie uruchomionej aplikacji odbiornika (jeśli istnieje). W przeciwnym razie nil . Więcej... | |
Szczegóły metody
- (instancetype) initWithDevice: | (GCKDevice *) | device | |
clientPackageName: | (NSString *) | clientPackageName | |
Tworzy nowy obiekt GCKDeviceManager z danym urządzeniem.
Będzie nasłuchiwać powiadomień o stanie aplikacji i automatycznie rozłączy się, gdy aplikacja przejdzie w tle, i spróbuje ponownie połączyć się z urządzeniem, gdy aplikacja znów będzie na pierwszym planie.
- Parameters
-
device The device to control. clientPackageName The client package name.
- (instancetype) initWithDevice: | (GCKDevice *) | device | |
clientPackageName: | (NSString *) | clientPackageName | |
ignoreAppStateNotifications: | (BOOL) | ignoreAppStateNotifications | |
Wyznaczony inicjator.
Tworzy nowy element GCKDeviceManager do sterowania podanym urządzeniem.
Jeśli ignoreAppStateNotifications to NO
, obiekt będzie nasłuchiwać zmian w stanie aplikacji i automatycznie rozłączy się, gdy aplikacja przejdzie w tle, i spróbuje ponownie połączyć się z urządzeniem, gdy aplikacja znów będzie na pierwszym planie.
Jeśli ignoreAppStateNotifications to YES
, obiekt nie będzie nasłuchiwać tych powiadomień i odpowiada za zarządzanie cyklem życia połączenia. Pamiętaj, że aplikacje na iOS działające w tle nie mogą działać w nieskończoność, a ich aktywne połączenia sieciowe są ostatecznie zamykane przez system operacyjny.
- Parameters
-
device The device to control. clientPackageName The client package name. ignoreAppStateNotifications Whether this object will ignore app state notifications.
- (void) connect |
Łączy się z urządzeniem.
- (void) disconnect |
Odłącza urządzenie.
To bezpośrednie rozłączenie.
Jedna z metod odłączenia musi zostać wywołana na jakiś czas po wywołaniu connect i przed zwolnieniem tego obiektu przez właściciela.
- (void) disconnectWithLeave: | (BOOL) | leaveApplication |
Odłącza urządzenie.
Jedna z metod odłączenia musi zostać wywołana na jakiś czas po wywołaniu connect i przed zwolnieniem tego obiektu przez właściciela.
- Parameters
-
leaveApplication YES
if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection;NO
if this is an implicit disconnect that should just close the connection.
- (BOOL) addChannel: | (GCKCastChannel *) | channel |
Dodaje kanał, który może wysyłać i odbierać wiadomości na tym urządzeniu w określonej przestrzeni nazw.
- Parameters
-
channel The channel.
- Zwraca
YES
, jeśli kanał został dodany, lubNO
, jeśli nie został dodany, ponieważ w tej przestrzeni nazw jest już połączony kanał.
- (BOOL) removeChannel: | (GCKCastChannel *) | channel |
Usuwa wcześniej dodany kanał.
- Parameters
-
channel The channel.
- Zwraca
YES
, jeśli kanał został usunięty,NO
, jeśli nie został usunięty, ponieważ dany kanał nie był wcześniej do niego dołączony.
- (NSInteger) launchApplication: | (NSString *) | applicationID |
Uruchamia aplikację.
- Parameters
-
applicationID The application ID.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) launchApplication: | (NSString *) | applicationID | |
withLaunchOptions: | (GCKLaunchOptions *__nullable) | launchOptions | |
Uruchamia aplikację przy użyciu podanych opcji uruchamiania.
- Parameters
-
applicationID The application ID. launchOptions The launch options for this request. If nil
, defaults will be used.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) launchApplication: | (NSString *) | applicationID | |
relaunchIfRunning: | (BOOL) | relaunchIfRunning | |
Uruchamia aplikację. Opcjonalnie możesz ją uruchomić ponownie, jeśli już działa.
- Deprecated:
- Zamiast tego użyj launchApplication:withLaunchOptions:.
- Parameters
-
applicationID The application ID. relaunchIfRunning If YES
, relaunches the application if it is already running instead of joining the running application.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) joinApplication: | (NSString *__nullable) | applicationID |
Dołącza do aplikacji.
- Parameters
-
applicationID The application ID. If nil
, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) joinApplication: | (NSString *) | applicationID | |
sessionID: | (NSString *) | sessionID | |
Dołącza do aplikacji z określonym identyfikatorem sesji aplikacji.
Żądanie nie powiedzie się, jeśli dany identyfikator sesji nie jest już aktywny na odbiorniku.
- Parameters
-
applicationID The application ID. sessionID The application session ID.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (BOOL) leaveApplication |
Opuszcza bieżącą aplikację.
- Zwraca
NO
, jeśli nie udało się wysłać wiadomości.
- (NSInteger) stopApplication |
Zatrzymuje uruchamianie uruchomionych aplikacji.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) stopApplicationWithSessionID: | (NSString *__nullable) | sessionID |
Zatrzymuje aplikację o podanym identyfikatorze sesji aplikacji.
Żądanie nie powiedzie się, jeśli dany identyfikator sesji nie jest już aktywny na odbiorniku.
- Parameters
-
sessionID The application session ID, which may not be nil
.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) setVolume: | (float) | volume |
Ustawia głośność systemu.
- Parameters
-
volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) setMuted: | (BOOL) | muted |
Włącza lub wyłącza wyciszenie.
- Parameters
-
muted Whether audio should be muted or unmuted.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
- (NSInteger) requestDeviceStatus |
Żąda bieżącego stanu urządzenia.
Dzięki temu po otrzymaniu zaktualizowanych informacji o stanie wszystkie wywołania zwrotne aktualizacji stanu przekazywania będą wywoływane.
- Zwraca
- Identyfikator lub kGCKInvalidRequestID, jeśli nie udało się wysłać prośby.
Szczegóły usługi
|
readnonatomicassign |
Określa, czy ten obiekt będzie nasłuchiwać powiadomień o stanie aplikacji.
Ta flaga może być określona w inicjatorze. Wartością domyślną jest NO
.
|
readnonatomicassign |
Aktualny stan połączenia menedżera urządzenia.
|
readnonatomicassign |
Bieżący stan połączenia z menedżerem urządzenia.
|
readnonatomicassign |
Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z urządzeniem.
- Deprecated:
- Użyj aplikacji connectionState.
|
readnonatomicassign |
Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z aplikacją na urządzeniu.
- Deprecated:
- Użyj aplikacji applicationConnectionState.
|
readnonatomicassign |
Wartość to „prawda”, jeśli menedżer urządzenia został odłączony z powodu potencjalnie tymczasowego zdarzenia (np. aplikacja jest w tle lub wystąpił błąd sieci, który można rozwiązać przez ponowne połączenie).
Pamiętaj, że wywołania wywołania rozłączenia/połączenia nie będą wywoływane, gdy menedżer urządzenia będzie próbował ponownie nawiązać połączenie po wystąpieniu zdarzenia przejściowego, ale właściwości zawsze odzwierciedlają rzeczywisty stan i można je obserwować.
|
readwritenonatomicassign |
W takim przypadku zostanie podjęta próba ponownego połączenia, gdy gniazdo zostanie odłączone z powodu potencjalnie przejściowego błędu.
Domyślny limit czasu wynosi 15 sekund.
|
readnonatomicassign |
Urządzenie, którym steruje to urządzenie GCKDeviceManager.
|
readwritenonatomicweak |
Osoba, której przekazano dostęp do powiadomień z GCKDeviceManager.
|
readnonatomicassign |
Obecna głośność urządzenia w zakresie [0,0, 1,0], jeśli jest znana. W innych przypadkach 0.
|
readnonatomicassign |
Bieżący stan wyciszenia urządzenia, jeśli jest znany. W przeciwnym razie NO
.
|
readnonatomicassign |
Obecny stan aktywności urządzenia.
|
readnonatomicassign |
Obecny stan gotowości urządzenia.
|
readnonatomiccopy |
Identyfikator sesji aplikacji aktualnie powiązanej aplikacji odbiorcy. W przeciwnym razie nil
.
Nowy, unikalny identyfikator sesji jest generowany przy każdym uruchomieniu aplikacji odbiorcy (w tym po ponownym uruchomieniu tej samej aplikacji) i zachowuje ważność, dopóki aplikacja odbiorcy pozostaje uruchomiona.
|
readnonatomiccopy |
Metadane aplikacji odbiorcy, która jest obecnie uruchomiona na odbiorniku. W przeciwnym razie nil
.
|
readnonatomiccopy |
Ostatni raport o stanie z obecnie uruchomionej aplikacji odbiornika (jeśli istnieje). W przeciwnym razie nil
.