Panoramica
Un controller per i dispositivi di trasmissione.
Questa classe può inviare messaggi a, ricevere messaggi da, avviare e chiudere applicazioni in esecuzione su un dispositivo di trasmissione.
L'istanza GCKDeviceManager deve rimanere nell'ambito finché è stabilita una connessione al dispositivo di trasmissione o è in fase di creazione o eliminazione. È sicuro rilasciare l'oggetto prima che sia stata avviata una connessione con connect (GCKDeviceManager) o dopo che è stato richiamato il callback del delegato deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) o deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).
- Deprecated:
- Utilizza GCKSessionManager e GCKCastSession per interagire con i ricevitori Cast.
Eredita NSObject.
Riepilogo del metodo dell'istanza | |
| (instancetype) | - initWithDevice:clientPackageName: |
| Costruisce 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 uno spazio dei nomi specifico. 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, riavviandola facoltativamente se è già in esecuzione. Altro… | |
| (NSInteger) | - joinApplication: |
| Aggiunge un'applicazione. Altro… | |
| (NSInteger) | - joinApplication:sessionID: |
| Unisce un'applicazione a un determinato ID sessione dell'applicazione. Altro… | |
| (BOOL) | - leaveApplication |
| Esce dall'applicazione corrente. Altro… | |
| (NSInteger) | - stopApplication |
| Interrompe le applicazioni in esecuzione. Altro… | |
| (NSInteger) | - stopApplicationWithSessionID: |
| Arresta l'applicazione con l'ID sessione applicazione specificato. Altro… | |
| (NSInteger) | - setVolume: |
| Imposta il volume di sistema. Altro… | |
| (NSInteger) | - setMuted: |
| Attiva o disattiva la disattivazione dell'audio. Altro… | |
| (NSInteger) | - requestDeviceStatus |
| Richiede lo stato attuale del dispositivo. Altro… | |
Riepilogo della 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 |
| Stato attuale della connessione dell'applicazione del gestore dei dispositivi. Altro… | |
| BOOL | isConnected |
| True se il gestore dispositivi ha stabilito una connessione al dispositivo. Altro… | |
| BOOL | isConnectedToApp |
| Vero se il gestore dispositivi ha stabilito una connessione a un'applicazione sul dispositivo. Altro… | |
| BOOL | isReconnecting |
| True se Device Manager è 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 |
| Il tentativo di riconnessione verrà effettuato per questo periodo di tempo nel caso in cui il socket si disconnetta con un errore potenzialmente temporaneo. 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 |
Lo stato di disattivazione audio corrente del dispositivo, se noto; altrimenti NO. Altro… | |
| GCKActiveInputStatus | activeInputStatus |
| Lo stato attuale di "input attivo" del dispositivo. Altro… | |
| GCKStandbyStatus | standbyStatus |
| Lo stato attuale di "standby" del dispositivo. Altro… | |
| NSString * | applicationSessionID |
L'ID sessione dell'applicazione per l'applicazione ricevitore attualmente connessa, se presente; in caso contrario, nil. Altro… | |
| GCKApplicationMetadata * | applicationMetadata |
I metadati dell'applicazione ricevitore attualmente in esecuzione sul ricevitore, se presenti; in caso contrario, nil. Altro… | |
| NSString * | applicationStatusText |
Il testo di stato segnalato più di recente dall'applicazione ricevitore attualmente in esecuzione, se presente; in caso contrario, nil. Altro… | |
Dettagli metodo
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| clientPackageName: | (NSString *) | clientPackageName | |
Costruisce un nuovo GCKDeviceManager con il dispositivo specificato.
L'oggetto ascolterà le notifiche sullo stato dell'app e si disconnetterà automaticamente dal dispositivo quando l'app passa in background e tenterà 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 controllare il dispositivo specificato.
Se ignoreAppStateNotifications è NO, l'oggetto ascolterà le modifiche allo stato dell'app e si disconnetterà automaticamente dal dispositivo quando l'app passa in background e tenterà di riconnettersi al dispositivo quando l'app torna in primo piano.
Se ignoreAppStateNotifications è YES, l'oggetto non ascolterà queste notifiche e sarà 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.
Si tratta di una disconnessione esplicita.
Uno dei metodi di disconnessione deve essere chiamato a un certo punto dopo la chiamata di connect e prima che questo oggetto venga rilasciato dal 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 questo oggetto venga rilasciato dal proprietario.
- Parameters
-
leaveApplication YESif this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection;NOif 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 uno spazio dei nomi specifico.
- Parameters
-
channel The channel.
- Resi
YESse il canale è stato aggiunto,NOse non è stato aggiunto perché era già presente un canale collegato per quello spazio dei nomi.
| - (BOOL) removeChannel: | (GCKCastChannel *) | channel |
Rimuove un canale aggiunto in precedenza.
- Parameters
-
channel The channel.
- Resi
YESse il canale è stato rimosso,NOse non è stato rimosso perché il canale indicato non era stato collegato in precedenza.
| - (NSInteger) launchApplication: | (NSString *) | applicationID |
Avvia un'applicazione.
- Parameters
-
applicationID The application ID.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (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.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) launchApplication: | (NSString *) | applicationID | |
| relaunchIfRunning: | (BOOL) | relaunchIfRunning | |
Avvia un'applicazione, riavviandola facoltativamente se è già in esecuzione.
- Deprecated:
- Utilizza invece launchApplication:withLaunchOptions:.
- Parameters
-
applicationID The application ID. relaunchIfRunning If YES, relaunches the application if it is already running instead of joining the running application.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) joinApplication: | (NSString *__nullable) | applicationID |
Aggiunge un'applicazione.
- Parameters
-
applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) joinApplication: | (NSString *) | applicationID | |
| sessionID: | (NSString *) | sessionID | |
Unisce un'applicazione a un determinato ID sessione dell'applicazione.
La richiesta non andrà a buon fine se l'ID sessione specificato non è più attivo sul destinatario.
- Parameters
-
applicationID The application ID. sessionID The application session ID.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (BOOL) leaveApplication |
Esce dall'applicazione corrente.
- Resi
NOse il messaggio non è stato inviato.
| - (NSInteger) stopApplication |
Interrompe le applicazioni in esecuzione.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) stopApplicationWithSessionID: | (NSString *__nullable) | sessionID |
Arresta l'applicazione con l'ID sessione applicazione specificato.
La richiesta non andrà a buon fine se l'ID sessione specificato non è più attivo sul destinatario.
- Parameters
-
sessionID The application session ID, which may not be nil.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) setVolume: | (float) | volume |
Imposta il volume di sistema.
- Parameters
-
volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) setMuted: | (BOOL) | muted |
Attiva o disattiva la disattivazione dell'audio.
- Parameters
-
muted Whether audio should be muted or unmuted.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
| - (NSInteger) requestDeviceStatus |
Richiede lo stato attuale del dispositivo.
Di conseguenza, verranno richiamati tutti i callback di aggiornamento dello stato del delegato una volta ricevute le informazioni sullo stato aggiornate.
- Resi
- L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
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 |
Stato attuale della connessione dell'applicazione del gestore dei dispositivi.
|
readnonatomicassign |
True se il gestore dispositivi ha stabilito una connessione al dispositivo.
- Deprecated:
- Utilizza connectionState.
|
readnonatomicassign |
Vero se il gestore dispositivi ha stabilito una connessione a un'applicazione sul dispositivo.
- Deprecated:
- Utilizza applicationConnectionState.
|
readnonatomicassign |
True se Device Manager è 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 Device Manager tenta di riconnettersi dopo un evento potenzialmente temporaneo, ma le proprietà rifletteranno sempre lo stato attuale effettivo e possono essere osservate.
|
readwritenonatomicassign |
Il tentativo di riconnessione verrà effettuato per questo periodo di tempo nel caso in cui il socket si disconnetta con un errore potenzialmente temporaneo.
Il timeout 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 |
Lo stato di disattivazione audio corrente del dispositivo, se noto; altrimenti NO.
|
readnonatomicassign |
Lo stato attuale di "input attivo" del dispositivo.
|
readnonatomicassign |
Lo stato attuale di "standby" del dispositivo.
|
readnonatomiccopy |
L'ID sessione dell'applicazione per l'applicazione ricevitore attualmente connessa, se presente; in caso contrario, nil.
Viene generato un nuovo ID sessione univoco ogni volta che viene avviata un'applicazione ricevitore (incluso il riavvio della stessa applicazione) e rimane attivo finché l'applicazione ricevitore continua a essere eseguita.
|
readnonatomiccopy |
I metadati dell'applicazione ricevitore attualmente in esecuzione sul ricevitore, se presenti; in caso contrario, nil.
|
readnonatomiccopy |
Il testo di stato segnalato più di recente dall'applicazione ricevitore attualmente in esecuzione, se presente; in caso contrario, nil.