Übersicht

Ein Controller für Cast-Geräte.

Mit dieser Klasse können Nachrichten an Anwendungen gesendet und von Anwendungen empfangen werden, die auf einem Cast-Gerät ausgeführt werden. Außerdem können Anwendungen gestartet und geschlossen werden.

Die GCKDeviceManager-Instanz muss im Bereich bleiben, solange eine Verbindung zum Cast-Gerät besteht oder gerade hergestellt oder getrennt wird. Das Objekt kann freigegeben werden, bevor eine Verbindung mit connect (GCKDeviceManager) gestartet wurde oder nachdem der Delegaten-Callback deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) oder deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) aufgerufen wurde.

Deprecated:: Verwende GCKSessionManager und GCKCastSession, um mit Cast-Empfängern zu interagieren.

Erbt von NSObject.

Zusammenfassung der Instanzmethoden
(instancetype)	- initWithDevice:clientPackageName:
	Erstellt ein neues GCKDeviceManager mit dem angegebenen Gerät. Weitere Informationen

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Designated Initializer Weitere Informationen

(void)	- connect
	Verbindung zum Gerät wird hergestellt. Weitere Informationen

(void)	- disconnect
	Die Verbindung zum Gerät wird getrennt. Weitere Informationen

(void)	- disconnectWithLeave:
	Die Verbindung zum Gerät wird getrennt. Weitere Informationen

(BOOL)	- addChannel:
	Fügt einen Kanal hinzu, über den Nachrichten für dieses Gerät in einem bestimmten Namespace gesendet und empfangen werden können. Weitere Informationen

(BOOL)	- removeChannel:
	Entfernt einen zuvor hinzugefügten Kanal. Weitere Informationen

(NSInteger)	- launchApplication:
	Startet eine Anwendung. Weitere Informationen

(NSInteger)	- launchApplication:withLaunchOptions:
	Startet eine Anwendung mit den angegebenen Startoptionen. Weitere Informationen

(NSInteger)	- launchApplication:relaunchIfRunning:
	Startet eine Anwendung und startet sie optional neu, wenn sie bereits ausgeführt wird. Weitere Informationen

(NSInteger)	- joinApplication:
	Tritt einer Anwendung bei. Weitere Informationen

(NSInteger)	- joinApplication:sessionID:
	Stellt eine Verbindung zu einer Anwendung mit einer bestimmten Anwendungssitzungs-ID her. Weitere Informationen

(BOOL)	- leaveApplication
	Verlässt die aktuelle Anwendung. Weitere Informationen

(NSInteger)	- stopApplication
	Beendet alle laufenden Anwendungen. Weitere Informationen

(NSInteger)	- stopApplicationWithSessionID:
	Beendet die Anwendung mit der angegebenen Anwendungs-Sitzungs-ID. Weitere Informationen

(NSInteger)	- setVolume:
	Legt die Systemlautstärke fest. Weitere Informationen

(NSInteger)	- setMuted:
	Aktiviert oder deaktiviert die Stummschaltung. Weitere Informationen

(NSInteger)	- requestDeviceStatus
	Fordert den aktuellen Status des Geräts an. Weitere Informationen

Zusammenfassung der Property
BOOL	ignoreAppStateNotifications
	Gibt an, ob dieses Objekt auf Benachrichtigungen zum App-Status reagiert. Weitere Informationen

GCKConnectionState	connectionState
	Der aktuelle Verbindungsstatus des Geräte-Managers. Weitere Informationen

GCKConnectionState	applicationConnectionState
	Der aktuelle Verbindungsstatus der Anwendung des Geräteadministrators. Weitere Informationen

BOOL	isConnected
	„True“, wenn der Gerätemanager eine Verbindung zum Gerät hergestellt hat. Weitere Informationen

BOOL	isConnectedToApp
	„True“, wenn der Gerätemanager eine Verbindung zu einer Anwendung auf dem Gerät hergestellt hat. Weitere Informationen

BOOL	isReconnecting
	„True“, wenn die Geräteverwaltung aufgrund eines möglicherweise vorübergehenden Ereignisses getrennt wurde (z. B. wenn die App im Hintergrund ausgeführt wird oder ein Netzwerkfehler aufgetreten ist, der durch erneutes Verbinden behoben werden kann). Weitere Informationen

NSTimeInterval	reconnectTimeout
	So lange wird versucht, die Verbindung wiederherzustellen, wenn die Socketverbindung aufgrund eines möglicherweise vorübergehenden Fehlers getrennt wird. Weitere Informationen

GCKDevice *	device
	Das Gerät, das von diesem GCKDeviceManager gesteuert wird. Weitere Informationen

id< GCKDeviceManagerDelegate >	delegate
	Der Delegat für den Empfang von Benachrichtigungen von der GCKDeviceManager. Weitere Informationen

float	deviceVolume
	Die aktuelle Lautstärke des Geräts im Bereich [0,0, 1,0], sofern bekannt. Andernfalls 0. Weitere Informationen

BOOL	deviceMuted
	Der aktuelle Stummschaltungsstatus des Geräts, falls bekannt; andernfalls `NO`. Weitere Informationen

GCKActiveInputStatus	activeInputStatus
	Der aktuelle Status der „aktiven Eingabe“ des Geräts. Weitere Informationen

GCKStandbyStatus	standbyStatus
	Der aktuelle Standby-Status des Geräts. Weitere Informationen

NSString *	applicationSessionID
	Die ID der Anwendungssitzung für die aktuell verbundene Empfängeranwendung, falls vorhanden. Andernfalls `nil`. Weitere Informationen

GCKApplicationMetadata *	applicationMetadata
	Die Metadaten für die Empfängeranwendung, die derzeit auf dem Empfänger ausgeführt wird, falls vorhanden. Andernfalls `nil`. Weitere Informationen

NSString *	applicationStatusText
	Der zuletzt gemeldete Statustext der aktuell ausgeführten Empfängeranwendung, falls vorhanden. Andernfalls `nil`. Weitere Informationen

Methodendetail

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

Erstellt ein neues GCKDeviceManager mit dem angegebenen Gerät.

Das Objekt wartet auf Benachrichtigungen zum App-Status und trennt die Verbindung zum Gerät automatisch, wenn die App in den Hintergrund wechselt. Wenn die App wieder in den Vordergrund wechselt, wird versucht, die Verbindung zum Gerät wiederherzustellen.

Parameters

device	The device to control.
clientPackageName	The client package name.

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

Designated Initializer

Erstellt ein neues GCKDeviceManager zur Steuerung des angegebenen Geräts.

Wenn ignoreAppStateNotifications NO ist, werden Änderungen am App-Status erkannt und die Verbindung zum Gerät wird automatisch getrennt, wenn die App in den Hintergrund wechselt. Wenn die App wieder in den Vordergrund wechselt, wird versucht, die Verbindung zum Gerät wiederherzustellen.

Wenn ignoreAppStateNotifications YES ist, werden diese Benachrichtigungen vom Objekt nicht berücksichtigt und der Lebenszyklus der Verbindung muss von der App verwaltet werden. Beachten Sie, dass eine im Hintergrund ausgeführte iOS-App in der Regel nicht unbegrenzt weiter ausgeführt werden kann und ihre aktiven Netzwerkverbindungen schließlich vom Betriebssystem geschlossen werden.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

Verbindung zum Gerät wird hergestellt.

- (void) disconnect

Die Verbindung zum Gerät wird getrennt.

Dies ist eine explizite Trennung.

Eine der Trennungsmethoden muss irgendwann nach dem Aufruf von connect und vor der Freigabe dieses Objekts durch seinen Eigentümer aufgerufen werden.

- (void) disconnectWithLeave: (BOOL) leaveApplication

Die Verbindung zum Gerät wird getrennt.

Eine der Trennungsmethoden muss irgendwann nach dem Aufruf von connect und vor der Freigabe dieses Objekts durch seinen Eigentümer aufgerufen werden.

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

Fügt einen Kanal hinzu, über den Nachrichten für dieses Gerät in einem bestimmten Namespace gesendet und empfangen werden können.

Parameters

channel The channel.

Ausgabe: YES, wenn der Kanal hinzugefügt wurde, NO, wenn er nicht hinzugefügt wurde, weil für diesen Namespace bereits ein Kanal verknüpft war.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Entfernt einen zuvor hinzugefügten Kanal.

Parameters

channel The channel.

Ausgabe: YES, wenn der Kanal entfernt wurde, NO, wenn er nicht entfernt wurde, weil der angegebene Kanal zuvor nicht verknüpft war.

- (NSInteger) launchApplication: (NSString *) applicationID

Startet eine Anwendung.

Parameters

applicationID The application ID.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

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

Startet eine Anwendung mit den angegebenen Startoptionen.

Parameters

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

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

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

Startet eine Anwendung und startet sie optional neu, wenn sie bereits ausgeführt wird.

Deprecated:: Verwenden Sie stattdessen launchApplication:withLaunchOptions:.

Parameters

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

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

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

Tritt einer Anwendung bei.

Parameters

applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

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

Stellt eine Verbindung zu einer Anwendung mit einer bestimmten Anwendungssitzungs-ID her.

Die Anfrage schlägt fehl, wenn die angegebene Sitzungs-ID auf dem Empfänger nicht mehr aktiv ist.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

- (BOOL) leaveApplication

Verlässt die aktuelle Anwendung.

Ausgabe: NO, wenn die Nachricht nicht gesendet werden konnte.

- (NSInteger) stopApplication

Beendet alle laufenden Anwendungen.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

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

Beendet die Anwendung mit der angegebenen Anwendungs-Sitzungs-ID.

Die Anfrage schlägt fehl, wenn die angegebene Sitzungs-ID auf dem Empfänger nicht mehr aktiv ist.

Parameters

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

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

- (NSInteger) setVolume: (float) volume

Legt die Systemlautstärke fest.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

- (NSInteger) setMuted: (BOOL) muted

Aktiviert oder deaktiviert die Stummschaltung.

Parameters

muted Whether audio should be muted or unmuted.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

- (NSInteger) requestDeviceStatus

Fordert den aktuellen Status des Geräts an.

Dadurch werden alle Statusaktualisierungs-Callbacks des Delegaten aufgerufen, sobald die aktualisierten Statusinformationen empfangen werden.

Ausgabe: Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Anfrage nicht gesendet werden konnte.

Property-Details

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Gibt an, ob dieses Objekt auf Benachrichtigungen zum App-Status reagiert.

Dieses Flag kann im Initialisierer angegeben werden. Der Standardwert ist NO.

- (GCKConnectionState) connectionState

readnonatomicassign

Der aktuelle Verbindungsstatus des Geräte-Managers.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Der aktuelle Verbindungsstatus der Anwendung des Geräteadministrators.

- (BOOL) isConnected

readnonatomicassign

„True“, wenn der Gerätemanager eine Verbindung zum Gerät hergestellt hat.

Deprecated:: Verwenden Sie connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

„True“, wenn der Gerätemanager eine Verbindung zu einer Anwendung auf dem Gerät hergestellt hat.

Deprecated:: Verwenden Sie applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

„True“, wenn die Geräteverwaltung aufgrund eines möglicherweise vorübergehenden Ereignisses getrennt wurde (z. B. wenn die App im Hintergrund ausgeführt wird oder ein Netzwerkfehler aufgetreten ist, der durch erneutes Verbinden behoben werden kann).

Die Rückrufe für das Trennen und Herstellen der Verbindung werden nicht aufgerufen, während der Geräte-Manager versucht, nach einem möglicherweise vorübergehenden Ereignis die Verbindung wiederherzustellen. Die Eigenschaften spiegeln jedoch immer den aktuellen Status wider und können beobachtet werden.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

So lange wird versucht, die Verbindung wiederherzustellen, wenn die Socketverbindung aufgrund eines möglicherweise vorübergehenden Fehlers getrennt wird.

Das Standardzeitlimit beträgt 15 Sekunden.

- (GCKDevice*) device

readnonatomicassign

Das Gerät, das von diesem GCKDeviceManager gesteuert wird.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Der Delegat für den Empfang von Benachrichtigungen von der GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Die aktuelle Lautstärke des Geräts im Bereich [0,0, 1,0], sofern bekannt. Andernfalls 0.

- (BOOL) deviceMuted

readnonatomicassign

Der aktuelle Stummschaltungsstatus des Geräts, falls bekannt; andernfalls NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

Der aktuelle Status der „aktiven Eingabe“ des Geräts.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

Der aktuelle Standby-Status des Geräts.

- (NSString*) applicationSessionID

readnonatomiccopy

Die ID der Anwendungssitzung für die aktuell verbundene Empfängeranwendung, falls vorhanden. Andernfalls nil.

Eine neue, eindeutige Sitzungs-ID wird immer dann generiert, wenn eine Receiver-Anwendung gestartet wird (auch wenn dieselbe Anwendung neu gestartet wird). Sie bleibt so lange gültig, wie die Receiver-Anwendung ausgeführt wird.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Die Metadaten für die Empfängeranwendung, die derzeit auf dem Empfänger ausgeführt wird, falls vorhanden. Andernfalls nil.

- (NSString*) applicationStatusText

readnonatomiccopy

Der zuletzt gemeldete Statustext der aktuell ausgeführten Empfängeranwendung, falls vorhanden. Andernfalls nil.

GCKDeviceManager-Klasse Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Zusammenfassung der Instanzmethoden

Zusammenfassung der Property

Methodendetail

Property-Details

GCKDeviceManager-Klasse