Autorizzazioni e rilevamento su iOS

Le applicazioni che cercano dispositivi sulla rete locale ora mostreranno agli utenti una finestra di dialogo di autorizzazione una tantum per trovare e connettersi ai dispositivi della rete locale. La piattaforma Cast utilizza la rete locale per rilevare e controllare i dispositivi Cast, quindi se l'utente nega l'autorizzazione, non potrà trasmettere.

Per migliorare l'esperienza utente, stiamo apportando alcune modifiche all'esperienza utente dell'SDK per le app che utilizzano il selettore di dispositivi standard. Queste modifiche all'esperienza utente rendono più evidente agli utenti il motivo per cui sono necessarie le autorizzazioni di accesso alla rete locale, nonché come attivare la trasmissione se l'accesso ai dispositivi di rete locale è stato disattivato.

L'SDK Cast per iOS 4.6.0 o versioni successive può essere aggiunto con Swift Package Manager seguendo la configurazione di Swift Package Manager o scaricato manualmente seguendo la configurazione manuale. Questa release include modifiche al meccanismo di rilevamento sottostante per consentire alle app create con Xcode 12 di trovare i dispositivi Cast sulla rete. Il pulsante Trasmetti ora dovrebbe essere sempre visualizzato. Se non sono disponibili dispositivi quando l'utente tocca il pulsante Trasmetti, viene visualizzata una finestra di dialogo che fornisce indicazioni sul motivo per cui i dispositivi potrebbero non essere disponibili, incluse informazioni su come riattivare l'autorizzazione di accesso alla rete locale.

Modifiche all'SDK Cast

Trasmissione per la prima volta

La prima volta che un utente tenta di trasmettere, viene visualizzata una finestra di dialogo interstiziale di accesso alla rete locale (LNA) che spiega perché è necessario l'accesso alla rete locale, seguita dalla richiesta di autorizzazioni di accesso alla rete locale di iOS fornita da Apple. I mock-up riportati di seguito illustrano il flusso:

Cast non disponibile

A partire dall'SDK mittente per iOS 4.6.0, il pulsante Trasmetti viene sempre visualizzato quando l'utente è connesso al Wi-Fi. Quando i dispositivi di trasmissione non sono disponibili, se tocchi il pulsante Trasmetti, viene visualizzata una finestra di dialogo che fornisce all'utente suggerimenti sui possibili motivi per cui la trasmissione non è disponibile, come mostrato nei mock-up di seguito:

Aggiornamento dell'app

1. Aggiungi l'SDK Cast per iOS 4.8.6 al tuo progetto

   Se utilizzi Swift Package Manager, aggiorna il pacchetto google-cast-ios-sdk alla versione 4.8.6.

   In caso contrario, inserisci l'SDK manualmente.

2. Aggiungi NSBonjourServices al tuo Info.plist

   Specifica NSBonjourServices nel tuo Info.plist per consentire il rilevamento della rete locale.

   Per il corretto funzionamento del rilevamento dei dispositivi, devi aggiungere sia _googlecast._tcp sia _<your-app-id>._googlecast._tcp come servizi.

   L'appID è il tuo receiverID, ovvero lo stesso ID definito nel tuo GCKDiscoveryCriteria.

   Aggiorna la seguente definizione di NSBonjourServices e sostituisci "ABCD1234" con il tuo appID.

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. Aggiungi NSLocalNetworkUsageDescription al tuo Info.plist

   Ti consigliamo vivamente di personalizzare il messaggio mostrato nel prompt della rete locale aggiungendo una stringa di autorizzazione specifica dell'app nel file Info.plist dell'app per NSLocalNetworkUsageDescription, ad esempio per descrivere l'individuazione di Cast e altri servizi di individuazione, come DIAL.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   Questo messaggio verrà visualizzato nella finestra di dialogo di accesso alla rete locale di iOS come mostrato nel mock-up.

   
4. Ripubblicare l'app sull'Apple App Store

   Ti consigliamo inoltre di ripubblicare la tua app utilizzando la versione 4.8.6 il prima possibile.

Personalizzazioni

Avvio del rilevamento del dispositivo di trasmissione

Per impostazione predefinita, la scoperta dei dispositivi di trasmissione viene avviata la prima volta che l'utente tocca il pulsante Trasmetti (GCKUICastButton). Se è la prima volta che l'utente tenta di utilizzare l'app Google Home sulla rete locale, viene visualizzato il nuovo interstitial LNA, seguito dalla finestra di dialogo delle autorizzazioni di accesso alla rete locale iOS.

È disponibile un nuovo flag che ti consente di controllare quando inizia la rilevazione dei dispositivi e il comportamento di determinati elementi dell'esperienza utente:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

Il valore predefinito è true. Questo flag è applicabile solo quando il flag GCKCastOptions::disableDiscoveryAutostart è impostato su false.

Se impostata su true, la ricerca dei dispositivi di trasmissione inizia quando un utente tocca GCKUICastButton per la prima volta. All'utente verrà mostrato un messaggio informativo che spiega perché è necessaria l'autorizzazione per la rete locale. Dopo questo messaggio, verrà visualizzato il messaggio LNA per iOS. La ricerca dei dispositivi di trasmissione inizia dopo la conferma del messaggio.

Nei lanci successivi dell'app, viene sempre visualizzato GCKUICastButton.

Se impostato su false, la ricerca dei dispositivi inizierà in base al valore del flag GCKCastOptions::disableDiscoveryAutostart.

Domande frequenti