Le framework Cast est compatible avec iOS 13 et les versions ultérieures, et est disponible dans des frameworks statiques et dynamiques.
Consultez la documentation de référence de l'API Google Cast pour iOS pour obtenir la description de toutes les classes et méthodes.
Configuration de Xcode
iOS 14
-
Ajouter le SDK Cast iOS 4.8.0 à votre projet
Si vous utilisez CocoaPods, utilisez
pod update
pour ajouter le SDK 4.8.0 à votre projet.Sinon, importez le SDK manuellement.
-
Ajouter
NSBonjourServices
à votreInfo.plist
Spécifiez
NSBonjourServices
dans votreInfo.plist
pour permettre la découverte du réseau local sur iOS 14.Vous devez ajouter
_googlecast._tcp
et_<your-app-id>._googlecast._tcp
comme services pour que la détection d'appareils fonctionne correctement.L'appID est votre ID de récepteur, qui est le même que celui défini dans votre
GCKDiscoveryCriteria
.Mettez à jour l'exemple de définition de
NSBonjourServices
suivant et remplacez "ABCD1234" par votre ID d'application. -
Add
NSLocalNetworkUsageDescription
to yourInfo.plist
We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's
Info.plist
file for theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
Re-release your app to the Apple App Store
We recommend you also re-release your app using 4.8.0 as soon as possible.
iOS 13
iOS 12
Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".
Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.
CocoaPods setup
The recommended way of integrating Google Cast is using CocoaPods. CocoaPods is supported for both the Universal Framework and XCFramework.
For a Universal Framework integration, use the
google-cast-sdk
and
google-cast-sdk-no-bluetooth
CocoaPods.
For an XCFramework integration, use the google-cast-sdk-xcframework
and
google-cast-sdk-no-bluetooth-xcframework
CocoaPods.
To get started, follow the getting started guide.
Once CocoaPods is set up, follow the
using CocoaPods guide
to get your Podfile
created and your project ready to use with the Google Cast
SDK.
Here's an example of how to add the google-cast-sdk
CocoaPod to your
Podfile
:
use_frameworks!
platform :ios, '13.0'
def target_pods
pod 'google-cast-sdk'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
Voici un exemple d'ajout du CocoaPod google-cast-sdk-no-bluetooth
à votre Podfile
:
use_frameworks!
platform :ios, '13.0'
def target_pods
pod 'google-cast-sdk-no-bluetooth'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
Pour votre projet, vous devez spécifier une plage pour vos pods afin d'éviter les modifications destructives inattendues, comme indiqué dans le guide des fichiers de pods.
Dans cet extrait de code, la version 4.8.0 et les versions antérieures à la version majeure suivante (major.minor.patch) sont autorisées:
pod 'google-cast-sdk', '~> 4.8.0'
Par exemple, "~> 1.6.7" inclut toutes les versions à partir de la version 1.6.7, jusqu'à la version 2.0.0 (non comprise).
Configuration manuelle
Les instructions suivantes permettent d'ajouter le SDK iOS Cast à votre projet sans utiliser CocoaPods:
Téléchargements
Après avoir téléchargé la bibliothèque appropriée ci-dessous, suivez la procédure de configuration pour ajouter le framework à votre projet. Les exigences de configuration sont les mêmes pour XCFrameworks que pour l'ancien Universal Frameworks.
Cadre universel
Bibliothèques Cast du SDK Sender iOS 4.8.0:
Statique avec Bluetooth Statique sans Bluetooth
Dynamique avec Bluetooth Dynamique sans Bluetooth
XCFramework
Le SDK iOS Cast est compatible avec XCFrameworks, ce qui permet le développement sur les ordinateurs Mac équipés de la puce Apple, ainsi que le débogage à l'aide du simulateur iOS.
Bibliothèques Cast XCFramework 4.8.0 du SDK Sender iOS Cast:
XCFramework statique avec Bluetooth XCFramework statique sans Bluetooth
XCFramework dynamique avec Bluetooth XCFramework dynamique sans Bluetooth
Procédure de configuration
Pour installer l'une des bibliothèques statiques:
- Téléchargez et décompressez le SDK statique approprié pour votre projet.
- Configurez la bibliothèque Protobuf avec la version minimale v3.13.
- Si votre projet utilise CocoaPods:
-
Ouvrez votre fichier
Podfile
et supprimez l'élémentgoogle-cast-sdk
, le cas échéant :pod 'google-cast-sdk'
-
Ajoutez la bibliothèque
Protobuf
si elle n'est pas présente :pod 'Protobuf', '3.13'
-
Exécutez
pod install
dans le dossier racine de votre projet. - Si votre projet n'utilise pas CocoaPods:
-
Supprimez la version actuelle de
GoogleCastSDK
, le cas échéant. - Ajoutez la bibliothèque Protobuf v3.13 ou ultérieure en suivant les instructions décrites dans le dépôt GitHub Protobuf.
-
Faites glisser le fichier
.framework
ou.xcframework
décompressé dans votre projet principal dans le navigateur de projet Xcode (et non dans le projet de pods, le cas échéant). Cochez l'option "Copy all items if needed" (Copier tous les éléments si nécessaire), puis ajoutez-la à toutes les cibles. -
Dans votre projet Xcode, ajoutez les indicateurs
-ObjC -lc++
à Build Settings > Other Linker Flags (Paramètres de compilation > Autres indicateurs Linker). -
Effectuez un clic droit sur
GoogleCast.framework
ouGoogleCast.xcframework
dans votre projet, puis sélectionnez "Show In Finder" (Afficher dans le Finder). -
Faites glisser
GoogleCastCoreResources.bundle
etGoogleCastUIResources.bundle
dans votre projet à côté de l'élémentGoogleCast.framework
ouGoogleCast.xcframework
que vous avez ajouté précédemment, cochez l'option "Copy all items if needed" (Copier tous les éléments si nécessaire), puis ajoutez-les à toutes les cibles.
Pour installer l'une des bibliothèques dynamiques, procédez comme suit:
- Téléchargez et décompressez le SDK dynamique approprié pour votre projet.
- Configurez la bibliothèque GoogleCastSDK dynamique:
- Si votre projet utilise CocoaPods:
-
Ouvrez votre fichier
Podfile
et supprimez :pod 'google-cast-sdk'
-
Exécutez
pod install
dans le dossier racine de votre projet. - Si votre projet n'utilise pas CocoaPods, supprimez la bibliothèque Google Cast actuelle.
-
Faites glisser le fichier
.framework
ou.xcframework
décompressé dans votre projet principal dans le navigateur de projet Xcode (et non dans le projet de pods, le cas échéant). Cochez l'option "Copy all items if needed" (Copier tous les éléments si nécessaire), puis ajoutez-la à toutes les cibles. -
Dans l'onglet
General
de votre cible Xcode, sélectionnezEmbed and Sign
pourGoogleCast.framework
ouGoogleCast.xcframework
.
Configuration de Mac Catalyst
Pour les applications compatibles avec Mac Catalyst, utilisez la bibliothèque dynamique du SDK Cast. Suivez le processus de configuration manuelle pour ajouter le framework à votre projet. Ensuite, excluez de manière conditionnelle le SDK Cast de la cible Mac, comme indiqué dans la documentation Apple. Les bibliothèques statiques sont précompilées pour l'architecture iOS, ce qui provoque une erreur de l'éditeur de liens lors de la compilation sur la cible Mac.
Publier votre application sur l'App Store
Avant de publier votre application sur l'App Store, vous devez exécuter le script shell strip_unused_archs.sh
pour supprimer les architectures inutilisées de l'app bundle. Ce script se trouve dans le SDK Cast pour iOS.