GCKDeviceManager-Klasse

Instanzmethoden | Attribute

Referenz zur GCKDeviceManager-Klasse

Übersicht

Ein Controller für Cast-Geräte.

Diese Klasse kann Nachrichten an Apps auf einem Übertragungsgerät senden sowie von diesen Apps starten und schließen.

Die Instanz GCKDeviceManager muss innerhalb des Bereichs bleiben, solange eine Verbindung zum Übertragungsgerät hergestellt wird oder gerade erstellt oder gelöscht wird. Es ist sicher, das Objekt freizugeben, bevor eine Verbindung mit connect (GCKDeviceManager) gestartet wurde oder nachdem der Callback deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) oder deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) aufgerufen wurde.

Deprecated:

Über GCKSessionManager und GCKCastSession mit Cast-Empfängern interagieren.

Übernimmt NSObject.

Zusammenfassung der Instanzmethoden
(instancetype)	- initWithDevice:clientPackageName:
	Erstellt ein neues GCKDeviceManager mit dem angegebenen Gerät. Mehr...
(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Angegebener Initialisierer. Mehr...
(void)	- connect
	Stellt eine Verbindung zum Gerät her. Mehr...
(void)	- disconnect
	Verbindung zum Gerät wird getrennt. Mehr...
(void)	- disconnectWithLeave:
	Verbindung zum Gerät wird getrennt. Mehr...
(BOOL)	- addChannel:
	Fügt einen Kanal hinzu, der Nachrichten für dieses Gerät in einem bestimmten Namespace senden und empfangen kann. Mehr...
(BOOL)	- removeChannel:
	Entfernt einen zuvor hinzugefügten Kanal. Mehr...
(NSInteger)	- launchApplication:
	Startet eine Anwendung. Mehr...
(NSInteger)	- launchApplication:withLaunchOptions:
	Startet eine Anwendung mit den angegebenen Startoptionen. Mehr...
(NSInteger)	- launchApplication:relaunchIfRunning:
	Startet eine Anwendung und kann sie optional neu starten, wenn sie bereits ausgeführt wird. Mehr...
(NSInteger)	- joinApplication:
	Nimmt an einer Anwendung teil. Mehr...
(NSInteger)	- joinApplication:sessionID:
	Führt eine Anwendung mit einer bestimmten Anwendungssitzungs-ID zusammen. Mehr...
(BOOL)	- leaveApplication
	Beendet die aktuelle Anwendung. Mehr...
(NSInteger)	- stopApplication
	Beendet alle laufenden Anwendungen. Mehr...
(NSInteger)	- stopApplicationWithSessionID:
	Stoppt die Anwendung mit der angegebenen Anwendungssitzungs-ID. Mehr...
(NSInteger)	- setVolume:
	Legt die Systemlautstärke fest. Mehr...
(NSInteger)	- setMuted:
	Schaltet die Stummschaltung ein oder aus. Mehr...
(NSInteger)	- requestDeviceStatus
	Fordert den aktuellen Status des Geräts an. Mehr...

Property-Zusammenfassung
BOOL	ignoreAppStateNotifications
	Gibt an, ob dieses Objekt auf App-Statusbenachrichtigungen wartet. Mehr...
GCKConnectionState	connectionState
	Der aktuelle Verbindungsstatus des Gerätemanagers. Mehr...
GCKConnectionState	applicationConnectionState
	Der aktuelle Verbindungsstatus des Anwendungsmanagers. Mehr...
BOOL	isConnected
	Dieser Wert ist „True“, wenn der Gerätemanager eine Verbindung zum Gerät hergestellt hat. Mehr...
BOOL	isConnectedToApp
	Dieser Wert ist „True“, wenn der Gerätemanager eine Verbindung zu einer App auf dem Gerät hergestellt hat. Mehr...
BOOL	isReconnecting
	Dieser Wert ist „True“, wenn der Gerätemanager aufgrund eines möglicherweise vorübergehenden Ereignisses getrennt wird, z. B. wenn die App im Hintergrund läuft oder ein Netzwerkfehler aufgetreten ist, der durch eine Neuverbindung behoben werden konnte. Mehr...
NSTimeInterval	reconnectTimeout
	Sollte das Socket getrennt werden, wird für einen längeren Zeitraum versucht, die Verbindung wiederherzustellen. Mehr...
GCKDevice *	device
	Das Gerät, das von diesem GCKDeviceManager gesteuert wird. Mehr...
id< GCKDeviceManagerDelegate >	delegate
	Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKDeviceManager. Mehr...
float	deviceVolume
	Die aktuelle Lautstärke des Geräts im Bereich [0.0, 1.0], falls bekannt, ansonsten 0. Mehr...
BOOL	deviceMuted
	Der aktuelle Stummschaltungsstatus des Geräts, sofern bekannt. Andernfalls NO. Mehr...
GCKActiveInputStatus	activeInputStatus
	Der aktuelle Status „Aktive Eingabe“ des Geräts. Mehr...
GCKStandbyStatus	standbyStatus
	Der aktuelle Standby-Status des Geräts. Mehr...
NSString *	applicationSessionID
	Die Anwendungssitzungs-ID für die aktuell verbundene Empfängeranwendung, falls vorhanden. Andernfalls nil. Mehr...
GCKApplicationMetadata *	applicationMetadata
	Die Metadaten für die Empfängeranwendung, die derzeit auf dem Empfänger ausgeführt wird, falls vorhanden. Andernfalls nil. Mehr...
NSString *	applicationStatusText
	Der zuletzt gemeldete Statustext der aktuell ausgeführten Empfängeranwendung, falls vorhanden. Andernfalls nil. Mehr...

Methodendetail

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

Erstellt ein neues GCKDeviceManager mit dem angegebenen Gerät.

Das Objekt wartet auf App-Statusbenachrichtigungen und wird automatisch vom Gerät getrennt, wenn die App in den Hintergrund wechselt, und versucht, sich wieder mit dem Gerät zu verbinden, wenn die App wieder in den Vordergrund wechselt.

Parameters

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

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

Angegebener Initialisierer.

Erstellt ein neues GCKDeviceManager-Objekt zum Steuern des angegebenen Geräts.

Wenn ignoreAppStateNotifications auf NO gesetzt ist, wartet das Objekt auf Änderungen des App-Status und wird automatisch vom Gerät getrennt, wenn die App in den Hintergrund wechselt. Sobald die App wieder in den Vordergrund wechselt, wird versucht, die Verbindung zum Gerät wiederherzustellen.

Wenn ignoreAppStateNotifications auf YES gesetzt ist, wartet das Objekt nicht auf diese Benachrichtigungen und es liegt in der Verantwortung der App, den Verbindungslebenszyklus zu verwalten. Hinweis: Eine iOS-App im Hintergrund kann nicht unbegrenzt laufen. Die aktiven Netzwerkverbindungen werden schließlich vom Betriebssystem beendet.

Parameters

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

- (void) connect

Stellt eine Verbindung zum Gerät her.

- (void) disconnect

Verbindung zum Gerät wird getrennt.

Das ist eine explizite Trennung.

Eine der Methoden zum Trennen einer Verbindung muss irgendwann aufgerufen werden, nachdem connect aufgerufen wurde und bevor dieses Objekt vom Inhaber freigegeben wurde.

- (void) disconnectWithLeave:

(BOOL)

leaveApplication

Verbindung zum Gerät wird getrennt.

Eine der Methoden zum Trennen einer Verbindung muss irgendwann aufgerufen werden, nachdem connect aufgerufen wurde und bevor dieses Objekt vom Inhaber freigegeben wurde.

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, der Nachrichten für dieses Gerät in einem bestimmten Namespace senden und empfangen kann.

Parameters

channel

The channel.

Gibt Folgendes zurück:

YES, wenn der Kanal hinzugefügt wurde, NO, wenn er nicht hinzugefügt wurde, weil diesem Namespace bereits ein Kanal angehängt war.

- (BOOL) removeChannel:

(GCKCastChannel *)

channel

Entfernt einen zuvor hinzugefügten Kanal.

Parameters

channel

The channel.

Gibt Folgendes zurück:

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

- (NSInteger) launchApplication:

(NSString *)

applicationID

Startet eine Anwendung.

Parameters

applicationID

The application ID.

Gibt Folgendes zurück:

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.

Gibt Folgendes zurück:

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

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

Startet eine Anwendung und kann sie optional neu starten, 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.

Gibt Folgendes zurück:

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

- (NSInteger) joinApplication:

(NSString *__nullable)

applicationID

Nimmt an einer Anwendung teil.

Parameters

applicationID

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

Gibt Folgendes zurück:

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

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

Führt eine Anwendung mit einer bestimmten Anwendungssitzungs-ID zusammen.

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.

Gibt Folgendes zurück:

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

- (BOOL) leaveApplication

Beendet die aktuelle Anwendung.

Gibt Folgendes zurück:

NO, wenn die Nachricht nicht gesendet werden konnte.

- (NSInteger) stopApplication

Beendet alle laufenden Anwendungen.

Gibt Folgendes zurück:

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

- (NSInteger) stopApplicationWithSessionID:

(NSString *__nullable)

sessionID

Stoppt die Anwendung mit der angegebenen Anwendungssitzungs-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.

Gibt Folgendes zurück:

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.

Gibt Folgendes zurück:

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

- (NSInteger) setMuted:

(BOOL)

muted

Schaltet die Stummschaltung ein oder aus.

Parameters

muted

Whether audio should be muted or unmuted.

Gibt Folgendes zurück:

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

- (NSInteger) requestDeviceStatus

Fordert den aktuellen Status des Geräts an.

Dies führt dazu, dass alle Callbacks für den Status der Delegierung aufgerufen werden, sobald die aktualisierten Statusinformationen empfangen wurden.

Gibt Folgendes zurück:

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

Property-Details

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Gibt an, ob dieses Objekt auf App-Statusbenachrichtigungen wartet.

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

- (GCKConnectionState) connectionState

readnonatomicassign

Der aktuelle Verbindungsstatus des Gerätemanagers.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Der aktuelle Verbindungsstatus des Anwendungsmanagers.

- (BOOL) isConnected

readnonatomicassign

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

Deprecated:

Verwenden Sie connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

Dieser Wert ist „True“, wenn der Gerätemanager eine Verbindung zu einer App auf dem Gerät hergestellt hat.

Deprecated:

Verwenden Sie applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Dieser Wert ist „True“, wenn der Gerätemanager aufgrund eines möglicherweise vorübergehenden Ereignisses getrennt wird, z. B. wenn die App im Hintergrund läuft oder ein Netzwerkfehler aufgetreten ist, der durch eine Neuverbindung behoben werden konnte.

Die Callbacks zum Trennen und Verbinden werden nicht aufgerufen, während der Gerätemanager versucht, nach einem möglicherweise vorübergehenden Ereignis die Verbindung wiederherzustellen. Die Eigenschaften spiegeln jedoch immer den aktuellen Status wider und können erfasst werden.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

Sollte das Socket getrennt werden, wird für einen längeren Zeitraum versucht, die Verbindung wiederherzustellen.

Das Standardzeitlimit beträgt 15 Sekunden.

- (GCKDevice*) device

readnonatomicassign

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

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Die aktuelle Lautstärke des Geräts im Bereich [0.0, 1.0], falls bekannt, ansonsten 0.

- (BOOL) deviceMuted

readnonatomicassign

Der aktuelle Stummschaltungsstatus des Geräts, sofern bekannt. Andernfalls NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

Der aktuelle Status „Aktive Eingabe“ des Geräts.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

Der aktuelle Standby-Status des Geräts.

- (NSString*) applicationSessionID

readnonatomiccopy

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

Eine neue, eindeutige Sitzungs-ID wird immer dann generiert, wenn eine Empfängeranwendung gestartet wird (auch wenn die gleiche Anwendung neu gestartet wird) und gültig bleibt, solange die Empfängeranwendung weiter 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.