Klasa GCKDeviceManager

Dokumentacja klasy GCKDeviceManager

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...
 
GCKDevicedevice
 Urządzenie, którym steruje to urządzenie GCKDeviceManager. Więcej...
 
id< GCKDeviceManagerDelegatedelegate
 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...
 
GCKApplicationMetadataapplicationMetadata
 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
deviceThe device to control.
clientPackageNameThe 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
deviceThe device to control.
clientPackageNameThe client package name.
ignoreAppStateNotificationsWhether 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
leaveApplicationYES 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
channelThe channel.
Zwraca
YES, jeśli kanał został dodany, lub NO, 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
channelThe 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
applicationIDThe 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
applicationIDThe application ID.
launchOptionsThe 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
applicationIDThe application ID.
relaunchIfRunningIf 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
applicationIDThe 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
applicationIDThe application ID.
sessionIDThe 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
sessionIDThe 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
volumeThe 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
mutedWhether 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

- (BOOL) ignoreAppStateNotifications
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.

- (GCKConnectionState) connectionState
readnonatomicassign

Aktualny stan połączenia menedżera urządzenia.

- (GCKConnectionState) applicationConnectionState
readnonatomicassign

Bieżący stan połączenia z menedżerem urządzenia.

- (BOOL) isConnected
readnonatomicassign

Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z urządzeniem.

Deprecated:
Użyj aplikacji connectionState.
- (BOOL) isConnectedToApp
readnonatomicassign

Wartość to „prawda”, jeśli menedżer urządzenia nawiązał połączenie z aplikacją na urządzeniu.

Deprecated:
Użyj aplikacji applicationConnectionState.
- (BOOL) isReconnecting
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ć.

- (NSTimeInterval) reconnectTimeout
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.

- (GCKDevice*) device
readnonatomicassign

Urządzenie, którym steruje to urządzenie GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate
readwritenonatomicweak

Osoba, której przekazano dostęp do powiadomień z GCKDeviceManager.

- (float) deviceVolume
readnonatomicassign

Obecna głośność urządzenia w zakresie [0,0, 1,0], jeśli jest znana. W innych przypadkach 0.

- (BOOL) deviceMuted
readnonatomicassign

Bieżący stan wyciszenia urządzenia, jeśli jest znany. W przeciwnym razie NO.

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

Obecny stan aktywności urządzenia.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

Obecny stan gotowości urządzenia.

- (NSString*) applicationSessionID
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.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

Metadane aplikacji odbiorcy, która jest obecnie uruchomiona na odbiorniku. W przeciwnym razie nil.

- (NSString*) applicationStatusText
readnonatomiccopy

Ostatni raport o stanie z obecnie uruchomionej aplikacji odbiornika (jeśli istnieje). W przeciwnym razie nil.