Przegląd

Kontroler urządzeń przesyłających.

Ta klasa może wysyłać i odbierać wiadomości, uruchamiać i zamykać aplikacje działające na urządzeniu Cast.

Instancja GCKDeviceManager musi pozostawać w zakresie tak długo, jak długo połączenie z urządzeniem Cast jest nawiązane, tworzone lub zamykane. Obiekt można bezpiecznie zwolnić przed rozpoczęciem połączenia za pomocą connect (GCKDeviceManager) lub po wywołaniu zwrotnej funkcji delegata deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) lub deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:: Używaj przycisków GCKSessionManager i GCKCastSession do interakcji z odbiornikami Cast.

Dziedziczy z klasy NSObject.

Podsumowanie metod instancji
(instancetype)	- initWithDevice:clientPackageName:
	Tworzy nowy obiekt GCKDeviceManager z podanym 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 się od urządzenia. Więcej…

(void)	- disconnectWithLeave:
	Odłącza się od urządzenia. 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ę, korzystając z podanych opcji uruchamiania. Więcej…

(NSInteger)	- launchApplication:relaunchIfRunning:
	Uruchamia aplikację, a w razie potrzeby uruchamia ją ponownie, jeśli jest już uruchomiona. 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
	Powoduje wyjście z bieżącej aplikacji. Więcej…

(NSInteger)	- stopApplication
	Zatrzymuje wszystkie uruchomione aplikacje. 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 i wyłącza wyciszanie. Więcej informacji

(NSInteger)	- requestDeviceStatus
	Wysyła żądanie dotyczące 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
	Bieżący stan połączenia menedżera urządzeń. Więcej…

GCKConnectionState	applicationConnectionState
	Bieżący stan połączenia aplikacji menedżera urządzeń. Więcej…

BOOL	isConnected
	Wartość Prawda, jeśli menedżer urządzeń nawiązał połączenie z urządzeniem. Więcej…

BOOL	isConnectedToApp
	Wartość Prawda, jeśli menedżer urządzeń nawiązał połączenie z aplikacją na urządzeniu. Więcej…

BOOL	isReconnecting
	Wartość „true”, jeśli menedżer urządzeń został odłączony z powodu potencjalnie przejściowego zdarzenia (np. aplikacja działa w tle lub wystąpił błąd sieci, który można rozwiązać, ponownie łącząc się z siecią). Więcej…

NSTimeInterval	reconnectTimeout
	W przypadku rozłączenia gniazda z powodu potencjalnie przejściowego błędu ponowna próba połączenia będzie podejmowana przez ten czas. Więcej…

GCKDevice *	device
	Urządzenie, którym zarządza ta aplikacja GCKDeviceManager. Więcej…

id< GCKDeviceManagerDelegate >	delegate
	Delegat do otrzymywania powiadomień z usługi GCKDeviceManager. Więcej…

float	deviceVolume
	Aktualna głośność urządzenia w zakresie [0,0, 1,0], jeśli jest znana; w przeciwnym razie 0. Więcej…

BOOL	deviceMuted
	Bieżący stan wyciszenia urządzenia, jeśli jest znany; w przeciwnym razie `NO`. Więcej…

GCKActiveInputStatus	activeInputStatus
	Bieżący stan „aktywnego wejścia” urządzenia. Więcej…

GCKStandbyStatus	standbyStatus
	Bieżący stan „gotowości” urządzenia. Więcej…

NSString *	applicationSessionID
	Identyfikator sesji aplikacji dla aktualnie połączonej aplikacji odbiorczej (jeśli istnieje); w przeciwnym razie `nil`. Więcej…

GCKApplicationMetadata *	applicationMetadata
	Metadane aplikacji odbiorcy, która jest obecnie uruchomiona na odbiorniku (jeśli taka aplikacja istnieje); w przeciwnym razie `nil`. Więcej…

NSString *	applicationStatusText
	Ostatnio zgłoszony tekst stanu z aktualnie działającej aplikacji odbiornika, jeśli taki istnieje; w przeciwnym razie `nil`. Więcej…

Szczegóły metody

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

Tworzy nowy obiekt GCKDeviceManager z podanym urządzeniem.

Obiekt będzie nasłuchiwać powiadomień o stanie aplikacji i automatycznie rozłączać się z urządzeniem, gdy aplikacja przejdzie w tło, oraz próbować ponownie połączyć się z urządzeniem, gdy aplikacja wróci na pierwszy plan.

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 obiekt GCKDeviceManager do sterowania danym urządzeniem.

Jeśli wartość ignoreAppStateNotifications to NO, obiekt będzie nasłuchiwać zmian stanu aplikacji i automatycznie rozłączać się z urządzeniem, gdy aplikacja przejdzie w tło, oraz próbować ponownie połączyć się z urządzeniem, gdy aplikacja wróci na pierwszy plan.

Jeśli wartość ignoreAppStateNotifications to YES, obiekt nie będzie nasłuchiwać tych powiadomień, a zarządzanie cyklem życia połączenia będzie należeć do aplikacji. Pamiętaj, że aplikacja na iOS działająca w tle nie może działać w nieskończoność, a aktywne połączenia sieciowe zostaną w końcu zamknięte 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 się od urządzenia.

Jest to wyraźne odłączenie.

Jedna z metod odłączania musi zostać wywołana w pewnym momencie po wywołaniu metody connect i przed zwolnieniem tego obiektu przez jego właściciela.

- (void) disconnectWithLeave: (BOOL) leaveApplication

Odłącza się od urządzenia.

Jedna z metod odłączania musi zostać wywołana w pewnym momencie po wywołaniu metody connect i przed zwolnieniem tego obiektu przez jego 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.

Zwroty: YES – jeśli kanał został dodany, NO – jeśli nie został dodany, ponieważ do tej przestrzeni nazw był już przypisany kanał.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Usuwa wcześniej dodany kanał.

Parameters

channel The channel.

Zwroty: YES – jeśli kanał został usunięty; NO – jeśli nie został usunięty, ponieważ nie był wcześniej połączony.

- (NSInteger) launchApplication: (NSString *) applicationID

Uruchamia aplikację.

Parameters

applicationID The application ID.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	(GCKLaunchOptions *__nullable)	launchOptions

Uruchamia aplikację, korzystając z podanych opcji uruchamiania.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil`, defaults will be used.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

Uruchamia aplikację, a w razie potrzeby uruchamia ją ponownie, jeśli jest już uruchomiona.

Deprecated:: Zamiast niej używaj kolumny launchApplication:withLaunchOptions:.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES`, relaunches the application if it is already running instead of joining the running application.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (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.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

Dołącza do aplikacji z określonym identyfikatorem sesji aplikacji.

Żądanie zakończy się niepowodzeniem, jeśli podany identyfikator sesji nie jest już aktywny na odbiorniku.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (BOOL) leaveApplication

Powoduje wyjście z bieżącej aplikacji.

Zwroty: NO – jeśli nie udało się wysłać wiadomości.

- (NSInteger) stopApplication

Zatrzymuje wszystkie uruchomione aplikacje.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

Zatrzymuje aplikację o podanym identyfikatorze sesji aplikacji.

Żądanie zakończy się niepowodzeniem, jeśli podany identyfikator sesji nie jest już aktywny na odbiorniku.

Parameters

sessionID The application session ID, which may not be nil.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (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.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) setMuted: (BOOL) muted

Włącza lub wyłącza wyciszenie.

Parameters

muted Whether audio should be muted or unmuted.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

- (NSInteger) requestDeviceStatus

Wysyła żądanie dotyczące bieżącego stanu urządzenia.

Spowoduje to wywołanie wszystkich wywołań zwrotnych aktualizacji stanu delegata po otrzymaniu zaktualizowanych informacji o stanie.

Zwroty: Identyfikator żądania lub kGCKInvalidRequestID, jeśli nie udało się wysłać żądania.

Szczegóły usługi

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Określa, czy ten obiekt będzie nasłuchiwać powiadomień o stanie aplikacji.

Tę flagę można określić w inicjatorze. Wartością domyślną jest NO.

- (GCKConnectionState) connectionState

readnonatomicassign

Bieżący stan połączenia menedżera urządzeń.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Bieżący stan połączenia aplikacji menedżera urządzeń.

- (BOOL) isConnected

readnonatomicassign

Wartość Prawda, jeśli menedżer urządzeń nawiązał połączenie z urządzeniem.

Deprecated:: Użyj connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

Wartość Prawda, jeśli menedżer urządzeń nawiązał połączenie z aplikacją na urządzeniu.

Deprecated:: Użyj applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Wartość „true”, jeśli menedżer urządzeń został odłączony z powodu potencjalnie przejściowego zdarzenia (np. aplikacja działa w tle lub wystąpił błąd sieci, który można rozwiązać, ponownie łącząc się z siecią).

Pamiętaj, że wywołania zwrotne odłączenia/połączenia nie będą wywoływane, gdy menedżer urządzeń próbuje ponownie nawiązać połączenie po potencjalnie przejściowym zdarzeniu, ale właściwości zawsze będą odzwierciedlać aktualny stan i można je obserwować.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

W przypadku rozłączenia gniazda z powodu potencjalnie przejściowego błędu ponowna próba połączenia będzie podejmowana przez ten czas.

Domyślny czas oczekiwania to 15 sekund.

- (GCKDevice*) device

readnonatomicassign

Urządzenie, którym zarządza ta aplikacja GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Delegat do otrzymywania powiadomień z usługi GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Aktualna głośność urządzenia w zakresie [0,0, 1,0], jeśli jest znana; w przeciwnym razie 0.

- (BOOL) deviceMuted

readnonatomicassign

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

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

Bieżący stan „aktywnego wejścia” urządzenia.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

Bieżący stan „gotowości” urządzenia.

- (NSString*) applicationSessionID

readnonatomiccopy

Identyfikator sesji aplikacji dla aktualnie połączonej aplikacji odbiorczej (jeśli istnieje); w przeciwnym razie nil.

Nowy, unikalny identyfikator sesji jest generowany za każdym razem, gdy uruchamiana jest aplikacja odbiorcy (w tym gdy ta sama aplikacja jest uruchamiana ponownie), i pozostaje aktywny, dopóki aplikacja odbiorcy jest uruchomiona.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Metadane aplikacji odbiorcy, która jest obecnie uruchomiona na odbiorniku (jeśli taka aplikacja istnieje); w przeciwnym razie nil.

- (NSString*) applicationStatusText

readnonatomiccopy

Ostatnio zgłoszony tekst stanu z aktualnie działającej aplikacji odbiornika, jeśli taki istnieje; w przeciwnym razie nil.

Klasa GCKDeviceManager Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Przegląd

Podsumowanie metod instancji

Podsumowanie usługi

Szczegóły metody

Szczegóły usługi

Klasa GCKDeviceManager