Autorisations et visibilité sur iOS

Les applications qui recherchent des appareils sur le réseau local invitent désormais les utilisateurs à accepter une boîte de dialogue d'autorisation ponctuelle pour rechercher des appareils sur le réseau local et s'y connecter. La plate-forme Cast utilise le réseau local pour détecter et contrôler les appareils Cast. Par conséquent, si l'utilisateur refuse l'autorisation, il ne pourra pas caster.

Pour améliorer l'expérience utilisateur, nous apportons quelques modifications à l'UX du SDK pour les applications qui utilisent le sélecteur d'appareil standard. Ces modifications de l'expérience utilisateur permettent aux utilisateurs de mieux comprendre pourquoi les autorisations d'accès au réseau local sont nécessaires, et comment activer la diffusion si l'accès aux appareils du réseau local a été désactivé.

Le SDK Cast pour iOS v4.6.0 ou version ultérieure peut être ajouté avec Swift Package Manager en suivant la configuration de Swift Package Manager ou téléchargé manuellement en suivant la configuration manuelle. Cette version inclut des modifications du mécanisme de découverte sous-jacent pour permettre aux applications créées avec Xcode 12 de trouver des appareils Cast sur le réseau. L'icône Cast devrait maintenant toujours s'afficher. Si aucun appareil n'est disponible lorsque l'utilisateur appuie sur l'icône Cast, une boîte de dialogue s'affiche pour expliquer pourquoi les appareils ne sont pas disponibles, et indique comment réactiver l'autorisation d'accès au réseau local.

Modifications apportées au SDK Cast

Première diffusion

La première fois qu'un utilisateur tente de caster, une boîte de dialogue interstitielle d'accès au réseau local s'affiche pour expliquer pourquoi l'accès au réseau local est nécessaire, suivie de l'invite d'autorisation d'accès au réseau local iOS fournie par Apple. Les maquettes ci-dessous illustrent le flux :

Flux d'autorisations d'accès au réseau local

Cast indisponible

À partir de la version 4.6.0 du SDK de l'expéditeur iOS, l'icône Cast s'affiche toujours lorsque l'utilisateur est connecté au Wi-Fi. Lorsque les appareils Cast ne sont pas disponibles, appuyer sur l'icône Cast affiche une boîte de dialogue qui indique à l'utilisateur les raisons possibles pour lesquelles Cast n'est pas disponible, comme illustré dans les maquettes ci-dessous :

Flux avec Cast non disponible

Mettre à jour votre application

  1. Ajouter le SDK Cast pour iOS 4.8.6 à votre projet

    Si vous utilisez Swift Package Manager, mettez à jour le package google-cast-ios-sdk vers la version 4.8.6.

    Sinon, récupérez le SDK manuellement.

  2. Ajouter NSBonjourServices à votre Info.plist

    Spécifiez NSBonjourServices dans votre Info.plist pour permettre à la découverte du réseau local de réussir.

    Vous devez ajouter _googlecast._tcp et _<your-app-id>._googlecast._tcp en tant que services pour que la détection des appareils fonctionne correctement.

    L'appID est votre receiverID, qui est le même ID que celui défini dans votre GCKDiscoveryCriteria.

    Mettez à jour l'exemple de définition NSBonjourServices suivant et remplacez "ABCD1234" par votre ID d'application.

    <key>NSBonjourServices</key>
    <array>
      <string>_googlecast._tcp</string>
      <string>_ABCD1234._googlecast._tcp</string>
    </array>
  3. Ajoutez NSLocalNetworkUsageDescription à votre Info.plist

    Nous vous recommandons vivement de personnaliser le message affiché dans l'invite du réseau local en ajoutant une chaîne d'autorisation spécifique à l'application dans le fichier Info.plist de votre application pour NSLocalNetworkUsageDescription, par exemple pour décrire la découverte Cast et d'autres services de découverte, comme DIAL.

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

    Ce message s'affichera dans la boîte de dialogue d'accès au réseau local iOS, comme illustré dans la maquette.

    Image de la boîte de dialogue des autorisations d'accès au réseau local pour Cast
  4. Publier à nouveau votre application sur l'App Store d'Apple

    Nous vous recommandons également de publier à nouveau votre application en utilisant la version 4.8.6 dès que possible.

Personnalisations

Lancement de la détection des appareils Cast

Par défaut, la découverte d'appareils Cast est lancée la première fois que l'utilisateur appuie sur le bouton Cast (GCKUICastButton). S'il s'agit de la première fois que l'utilisateur tente d'utiliser l'application Cast sur le réseau local, le nouvel interstitiel d'accès au réseau local s'affiche, suivi de la boîte de dialogue d'autorisation d'accès au réseau local iOS.

Un nouveau flag est disponible pour vous permettre de contrôler le moment où la découverte d'appareils démarre et le comportement de certains éléments de l'expérience utilisateur :

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

La valeur par défaut est true. Cette option ne s'applique que lorsque l'option GCKCastOptions::disableDiscoveryAutostart est définie sur false.

Si la valeur est définie sur true, la découverte des appareils Cast démarre lorsque l'utilisateur appuie sur GCKUICastButton pour la première fois. Un message d'information s'affiche pour expliquer à l'utilisateur pourquoi l'autorisation d'accès au réseau local est nécessaire. Le message LNA pour iOS s'affichera ensuite. La détection des appareils Cast commence une fois le message accepté.

Lors des lancements ultérieurs de l'application, GCKUICastButton s'affiche toujours.

Si la valeur est définie sur false, la découverte d'appareils démarre en fonction de la valeur de l'option GCKCastOptions::disableDiscoveryAutostart.

Questions fréquentes

Que se passe-t-il si je republie mon application émettrice Cast avec le SDK Cast v4.4.8 et Xcode 12 ?

Il est possible que votre application ne puisse pas détecter les appareils Cast sur le réseau local, sauf si vous avez obtenu un droit de multidiffusion réseau auprès d'Apple. Notez qu'Apple n'accordera pas de droits de multidiffusion uniquement pour la compatibilité avec Cast. Si vous prévoyez de compiler avec Xcode 12, vous devez publier votre application avec Cast 4.6.0.

Que dois-je faire pour mettre à jour mon application une fois que la nouvelle version du SDK Cast sera disponible ?

  • Mettez à jour le fichier Info.plist de votre application pour inclure une description de l'utilisation du réseau local.
  • Ajoutez NSBonjourServices au fichier Info.plist de votre application, puis indiquez les noms de service Bonjour pour Cast et l'ID de votre application.
  • Mettez à niveau votre application émettrice pour utiliser le SDK Cast 4.6.0.
  • Republiez votre application sur l'App Store d'Apple.

Pourquoi les appareils ont-ils cessé de s'afficher dans mon sélecteur d'appareils personnalisé après la mise à niveau vers la version 4.6.0 ?

Il s'agit d'un problème connu qui peut se produire si vous utilisez un sélecteur d'appareil personnalisé au lieu du sélecteur d'appareil standard. Dans la version 4.4.8 du SDK Cast et les versions antérieures, l'analyse des appareils était automatique. À partir de la version 4.6.0, vous devrez appeler explicitement la méthode startDiscovery sur la classe GCKDiscoveryManager pour lancer la découverte d'appareils.

En effet, l'invite d'autorisation d'accès au réseau local (LNA) s'affiche après la première analyse de l'application. Cela pourrait entraîner l'affichage de boîtes de dialogue d'autorisation à des endroits aléatoires de votre application.

Les développeurs qui créent un sélecteur d'appareils personnalisé pour leur application devront fournir un interstitiel unique avant de lancer la recherche d'appareils pour la première fois.