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 :

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 :

Mettre à jour votre application
-
Ajouter le SDK Cast pour iOS 4.8.6 à votre projet
Si vous utilisez Swift Package Manager, mettez à jour le package
google-cast-ios-sdkvers la version 4.8.6.Sinon, récupérez le SDK manuellement.
-
Ajouter
NSBonjourServicesà votreInfo.plistSpécifiez
NSBonjourServicesdans votreInfo.plistpour permettre à la découverte du réseau local de réussir.Vous devez ajouter
_googlecast._tcpet_<your-app-id>._googlecast._tcpen 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
NSBonjourServicessuivant et remplacez "ABCD1234" par votre ID d'application. -
Ajoutez
NSLocalNetworkUsageDescriptionà votreInfo.plistNous 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.plistde votre application pourNSLocalNetworkUsageDescription, par exemple pour décrire la découverte Cast et d'autres services de découverte, comme DIAL.Ce message s'affichera dans la boîte de dialogue d'accès au réseau local iOS, comme illustré dans la maquette.
-
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.plistde votre application pour inclure une description de l'utilisation du réseau local. - Ajoutez
NSBonjourServicesau fichierInfo.plistde 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.