Classe GCKDeviceManager

Riferimento alla classe GCKDeviceManager

Panoramica

Un controller per dispositivi di trasmissione.

Questo corso può inviare messaggi a, ricevere messaggi da, avviare e chiudere applicazioni in esecuzione su un dispositivo di trasmissione.

L'ambito dell'istanza GCKDeviceManager deve rimanere attivo finché la connessione al dispositivo di trasmissione è stabilita o in fase di creazione o eliminazione. Puoi rilasciare l'oggetto prima dell'avvio di una connessione con connect (GCKDeviceManager) o dopo che è stato richiamato il callback delegato deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) o deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:
Usa GCKSessionManager e GCKCastSession per interagire con i ricevitori di Google Cast.

Eredita NSObject.

Riepilogo del metodo dell'istanza

(instancetype) - initWithDevice:clientPackageName:
 Crea un nuovo GCKDeviceManager con il dispositivo specificato. Altro...
 
(instancetype) - initWithDevice:clientPackageName:ignoreAppStateNotifications:
 Inizializzatore designato. Altro...
 
(void) - connect
 Si connette al dispositivo. Altro...
 
(void) - disconnect
 Si disconnette dal dispositivo. Altro...
 
(void) - disconnectWithLeave:
 Si disconnette dal dispositivo. Altro...
 
(BOOL) - addChannel:
 Aggiunge un canale che può inviare e ricevere messaggi per questo dispositivo in un determinato spazio dei nomi. Altro...
 
(BOOL) - removeChannel:
 Rimuove un canale aggiunto in precedenza. Altro...
 
(NSInteger) - launchApplication:
 Avvia un'applicazione. Altro...
 
(NSInteger) - launchApplication:withLaunchOptions:
 Avvia un'applicazione utilizzando le opzioni di avvio specificate. Altro...
 
(NSInteger) - launchApplication:relaunchIfRunning:
 Avvia un'applicazione, se necessario, se è già in esecuzione. Altro...
 
(NSInteger) - joinApplication:
 Partecipa a un'applicazione. Altro...
 
(NSInteger) - joinApplication:sessionID:
 Partecipa a un'applicazione con un particolare ID sessione di applicazione. Altro...
 
(BOOL) - leaveApplication
 Abbandona l'applicazione corrente. Altro...
 
(NSInteger) - stopApplication
 Arresta tutte le applicazioni in esecuzione. Altro...
 
(NSInteger) - stopApplicationWithSessionID:
 Arresta l'applicazione con l'ID sessione dell'applicazione specificato. Altro...
 
(NSInteger) - setVolume:
 Imposta il volume del sistema. Altro...
 
(NSInteger) - setMuted:
 Attiva o disattiva l'audio. Altro...
 
(NSInteger) - requestDeviceStatus
 Richiedi lo stato attuale del dispositivo. Altro...
 

Riepilogo proprietà

BOOL ignoreAppStateNotifications
 Indica se questo oggetto ascolterà le notifiche sullo stato dell'app. Altro...
 
GCKConnectionState connectionState
 Lo stato attuale della connessione del gestore dei dispositivi. Altro...
 
GCKConnectionState applicationConnectionState
 Lo stato attuale della connessione dell'applicazione del gestore dei dispositivi. Altro...
 
BOOL isConnected
 True se il gestore del dispositivo ha stabilito una connessione al dispositivo. Altro...
 
BOOL isConnectedToApp
 True se il gestore di dispositivi ha stabilito una connessione a un'applicazione sul dispositivo. Altro...
 
BOOL isReconnecting
 True se il gestore dispositivi è disconnesso a causa di un evento potenzialmente temporaneo (ad esempio, l'app è in background o si è verificato un errore di rete che potrebbe essere risolto riconnettendosi). Altro...
 
NSTimeInterval reconnectTimeout
 Se la presa si disconnette con un errore potenzialmente temporaneo, verrà effettuato un nuovo tentativo di connessione per questo tempo. Altro...
 
GCKDevicedevice
 Il dispositivo controllato da questo GCKDeviceManager. Altro...
 
id< GCKDeviceManagerDelegatedelegate
 Il delegato per la ricezione delle notifiche da GCKDeviceManager. Altro...
 
float deviceVolume
 Il volume attuale del dispositivo nell'intervallo [0.0, 1.0], se noto; altrimenti 0. Altro...
 
BOOL deviceMuted
 L'attuale stato di disattivazione del dispositivo, se noto; altrimenti NO. Altro...
 
GCKActiveInputStatus activeInputStatus
 Lo stato attuale dell'input attivo del dispositivo. Altro...
 
GCKStandbyStatus standbyStatus
 Lo stato attuale "in standby". Altro...
 
NSString * applicationSessionID
 L'ID sessione dell'applicazione, se presente, per l'applicazione attualmente ricevuta, altrimenti nil. Altro...
 
GCKApplicationMetadataapplicationMetadata
 I metadati per l'applicazione del destinatario attualmente in esecuzione sul destinatario, se presenti. Altrimenti nil. Altro...
 
NSString * applicationStatusText
 Il testo di stato più recente segnalato dall'eventuale applicazione di ricezione attualmente in esecuzione, altrimenti nil. Altro...
 

Dettaglio metodo

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

Crea un nuovo GCKDeviceManager con il dispositivo specificato.

L'oggetto ascolta le notifiche di stato dell'app e si disconnette automaticamente dal dispositivo quando l'app passa in background e tenta di riconnettersi al dispositivo quando l'app torna in primo piano.

Parameters
deviceThe device to control.
clientPackageNameThe client package name.
- (instancetype) initWithDevice: (GCKDevice *)  device
clientPackageName: (NSString *)  clientPackageName
ignoreAppStateNotifications: (BOOL)  ignoreAppStateNotifications 

Inizializzatore designato.

Crea un nuovo GCKDeviceManager per il controllo del dispositivo specificato.

Se ignoreAppStateNotifications è impostato su NO, l'oggetto ascolta le modifiche allo stato dell'app e si disconnette automaticamente dal dispositivo quando l'app passa in background e prova a riconnettersi al dispositivo quando l'app torna in primo piano.

Se ignoreAppStateNotifications è YES, l'oggetto non ascolterà queste notifiche e sarà la responsabilità dell'app gestire il ciclo di vita della connessione. Tieni presente che, in generale, un'app per iOS in background non può continuare a essere eseguita a tempo indeterminato e le sue connessioni di rete attive verranno chiuse dal sistema operativo.

Parameters
deviceThe device to control.
clientPackageNameThe client package name.
ignoreAppStateNotificationsWhether this object will ignore app state notifications.
- (void) connect

Si connette al dispositivo.

- (void) disconnect

Si disconnette dal dispositivo.

Questa è una disconnessione esplicita.

Uno dei metodi di disconnessione deve essere chiamato a un certo punto dopo la chiamata di connect e prima che l'oggetto venga rilasciato dal suo proprietario.

- (void) disconnectWithLeave: (BOOL)  leaveApplication

Si disconnette dal dispositivo.

Uno dei metodi di disconnessione deve essere chiamato a un certo punto dopo la chiamata di connect e prima che l'oggetto venga rilasciato dal suo proprietario.

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

Aggiunge un canale che può inviare e ricevere messaggi per questo dispositivo in un determinato spazio dei nomi.

Parameters
channelThe channel.
Valori restituiti
YES se il canale è stato aggiunto, NO se non è stato aggiunto perché esisteva già un canale associato a quello spazio dei nomi.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Rimuove un canale aggiunto in precedenza.

Parameters
channelThe channel.
Valori restituiti
YES se il canale è stato rimosso, NO se non è stato rimosso perché il canale indicato non era stato associato in precedenza.
- (NSInteger) launchApplication: (NSString *)  applicationID

Avvia un'applicazione.

Parameters
applicationIDThe application ID.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) launchApplication: (NSString *)  applicationID
withLaunchOptions: (GCKLaunchOptions *__nullable)  launchOptions 

Avvia un'applicazione utilizzando le opzioni di avvio specificate.

Parameters
applicationIDThe application ID.
launchOptionsThe launch options for this request. If nil, defaults will be used.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) launchApplication: (NSString *)  applicationID
relaunchIfRunning: (BOOL)  relaunchIfRunning 

Avvia un'applicazione, se necessario, se è già in esecuzione.

Deprecated:
Utilizza il criterio launchApplication:withLaunchOptions:.
Parameters
applicationIDThe application ID.
relaunchIfRunningIf YES, relaunches the application if it is already running instead of joining the running application.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) joinApplication: (NSString *__nullable)  applicationID

Partecipa a un'applicazione.

Parameters
applicationIDThe application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) joinApplication: (NSString *)  applicationID
sessionID: (NSString *)  sessionID 

Partecipa a un'applicazione con un particolare ID sessione di applicazione.

Se l'ID sessione specificato non è più attivo sul destinatario, la richiesta avrà esito negativo.

Parameters
applicationIDThe application ID.
sessionIDThe application session ID.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (BOOL) leaveApplication

Abbandona l'applicazione corrente.

Valori restituiti
NO se il messaggio non è stato inviato.
- (NSInteger) stopApplication

Arresta tutte le applicazioni in esecuzione.

Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable)  sessionID

Arresta l'applicazione con l'ID sessione dell'applicazione specificato.

Se l'ID sessione specificato non è più attivo sul destinatario, la richiesta avrà esito negativo.

Parameters
sessionIDThe application session ID, which may not be nil.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) setVolume: (float)  volume

Imposta il volume del sistema.

Parameters
volumeThe new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) setMuted: (BOOL)  muted

Attiva o disattiva l'audio.

Parameters
mutedWhether audio should be muted or unmuted.
Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.
- (NSInteger) requestDeviceStatus

Richiedi lo stato attuale del dispositivo.

Di conseguenza, tutti i callback di aggiornamento dello stato del delegato vengono richiamati una volta ricevute le informazioni aggiornate sullo stato.

Valori restituiti
L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

Dettaglio proprietà

- (BOOL) ignoreAppStateNotifications
readnonatomicassign

Indica se questo oggetto ascolterà le notifiche sullo stato dell'app.

Questo flag può essere specificato nell'inizializzatore. Il valore predefinito è NO.

- (GCKConnectionState) connectionState
readnonatomicassign

Lo stato attuale della connessione del gestore dei dispositivi.

- (GCKConnectionState) applicationConnectionState
readnonatomicassign

Lo stato attuale della connessione dell'applicazione del gestore dei dispositivi.

- (BOOL) isConnected
readnonatomicassign

True se il gestore del dispositivo ha stabilito una connessione al dispositivo.

Deprecated:
Usa connectionState.
- (BOOL) isConnectedToApp
readnonatomicassign

True se il gestore di dispositivi ha stabilito una connessione a un'applicazione sul dispositivo.

Deprecated:
Usa applicationConnectionState.
- (BOOL) isReconnecting
readnonatomicassign

True se il gestore dispositivi è disconnesso a causa di un evento potenzialmente temporaneo (ad esempio, l'app è in background o si è verificato un errore di rete che potrebbe essere risolto riconnettendosi).

Tieni presente che i callback di disconnessione/connessione non verranno chiamati mentre il gestore dispositivo tenta di riconnettersi dopo un evento potenzialmente temporaneo, ma le proprietà riflettono sempre lo stato attuale attuale e possono essere osservate.

- (NSTimeInterval) reconnectTimeout
readwritenonatomicassign

Se la presa si disconnette con un errore potenzialmente temporaneo, verrà effettuato un nuovo tentativo di connessione per questo tempo.

Il valore predefinito è di 15 secondi.

- (GCKDevice*) device
readnonatomicassign

Il dispositivo controllato da questo GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate
readwritenonatomicweak

Il delegato per la ricezione delle notifiche da GCKDeviceManager.

- (float) deviceVolume
readnonatomicassign

Il volume attuale del dispositivo nell'intervallo [0.0, 1.0], se noto; altrimenti 0.

- (BOOL) deviceMuted
readnonatomicassign

L'attuale stato di disattivazione del dispositivo, se noto; altrimenti NO.

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

Lo stato attuale dell'input attivo del dispositivo.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

Lo stato attuale "in standby".

- (NSString*) applicationSessionID
readnonatomiccopy

L'ID sessione dell'applicazione, se presente, per l'applicazione attualmente ricevuta, altrimenti nil.

Ogni volta che viene avviata un'applicazione di ricezione (compreso il riavvio della stessa applicazione), viene generato un nuovo ID di sessione univoco che rimane attivo finché l'applicazione di ricezione continua a essere in esecuzione.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

I metadati per l'applicazione del destinatario attualmente in esecuzione sul destinatario, se presenti. Altrimenti nil.

- (NSString*) applicationStatusText
readnonatomiccopy

Il testo di stato più recente segnalato dall'eventuale applicazione di ricezione attualmente in esecuzione, altrimenti nil.