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... | |
GCKDevice * | device |
Il dispositivo controllato da questo GCKDeviceManager. Altro... | |
id< GCKDeviceManagerDelegate > | delegate |
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... | |
GCKApplicationMetadata * | applicationMetadata |
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
-
device The device to control. clientPackageName The 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
-
device The device to control. clientPackageName The client package name. ignoreAppStateNotifications Whether 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
-
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 |
Aggiunge un canale che può inviare e ricevere messaggi per questo dispositivo in un determinato spazio dei nomi.
- Parameters
-
channel The 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
-
channel The 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
-
applicationID The 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
-
applicationID The application ID. launchOptions The 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
-
applicationID The application ID. relaunchIfRunning If 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
-
applicationID The 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
-
applicationID The application ID. sessionID The 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
-
sessionID The 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
-
volume The 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
-
muted Whether 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à
|
readnonatomicassign |
Indica se questo oggetto ascolterà le notifiche sullo stato dell'app.
Questo flag può essere specificato nell'inizializzatore. Il valore predefinito è NO
.
|
readnonatomicassign |
Lo stato attuale della connessione del gestore dei dispositivi.
|
readnonatomicassign |
Lo stato attuale della connessione dell'applicazione del gestore dei dispositivi.
|
readnonatomicassign |
True se il gestore del dispositivo ha stabilito una connessione al dispositivo.
|
readnonatomicassign |
True se il gestore di dispositivi ha stabilito una connessione a un'applicazione sul dispositivo.
|
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.
|
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.
|
readnonatomicassign |
Il dispositivo controllato da questo GCKDeviceManager.
|
readwritenonatomicweak |
Il delegato per la ricezione delle notifiche da GCKDeviceManager.
|
readnonatomicassign |
Il volume attuale del dispositivo nell'intervallo [0.0, 1.0], se noto; altrimenti 0.
|
readnonatomicassign |
L'attuale stato di disattivazione del dispositivo, se noto; altrimenti NO
.
|
readnonatomicassign |
Lo stato attuale dell'input attivo del dispositivo.
|
readnonatomicassign |
Lo stato attuale "in standby".
|
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.
|
readnonatomiccopy |
I metadati per l'applicazione del destinatario attualmente in esecuzione sul destinatario, se presenti. Altrimenti nil
.
|
readnonatomiccopy |
Il testo di stato più recente segnalato dall'eventuale applicazione di ricezione attualmente in esecuzione, altrimenti nil
.