Le framework Cast est compatible avec iOS 14 et versions ultérieures, et est disponible les frameworks statiques et dynamiques.
Consultez la documentation de référence de l'API Google Cast pour iOS pour des descriptions de toutes les classes et méthodes.
Configuration de Xcode
iOS 14
-
Ajouter le SDK Cast pour iOS 4.8.1 à votre projet
Si vous utilisez CocoaPods, utilisez
pod update
pour ajouter le SDK 4.8.1 à votre projet.Sinon, extraire manuellement le SDK.
-
Ajouter
NSBonjourServices
à votreInfo.plist
Indiquez
NSBonjourServices
dans votreInfo.plist
pour permettre la réussite de la détection de réseaux locaux sur iOS 14.Vous devez ajouter
_googlecast._tcp
et_<your-app-id>._googlecast._tcp
en tant que services pour l'appareil la découverte pour fonctionner correctement.La valeur "appID" correspond à votre "receiveID" (ID du récepteur), qui est le même que celui défini dans votre
GCKDiscoveryCriteria
Mettez à jour l'exemple de définition
NSBonjourServices
suivant et remplacez "ABCD1234" par l'ID de votre 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.1 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. For integration, use the
google-cast-sdk
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, '14.0'
def target_pods
pod 'google-cast-sdk'
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 modifications destructives comme détaillé dans guide Podfile.
Dans cet extrait, la version 4.8.1 et les versions suivantes version majeure (major.minor.patch) sont autorisées:
pod 'google-cast-sdk', '~> 4.8.1'
Par exemple, '~> 1.6.7' inclut toutes les versions à partir de la version 1.6.7, mais pas y compris la version 2.0.0.
Configuration manuelle
Les instructions suivantes concernent l'ajout du SDK Cast pour iOS à votre projet sans utiliser CocoaPods:
Téléchargements
Après avoir téléchargé la bibliothèque appropriée ci-dessous, suivez les procédure de configuration pour ajouter le framework à votre projet.
Bibliothèques du SDK Cast pour iOS Sender 4.8.1:
Procédure de configuration
Pour installer la bibliothèque:
- Téléchargez et extrayez le SDK approprié pour votre projet.
- Configurez la bibliothèque dynamique du SDK GoogleCast:
-
Faites glisser le fichier
.xcframework
décompressé vers votre projet principal dans le Navigateur de projets Xcode (et non dans le projet "Pods" si vous en avez un) Cochez la case "Copier tous les éléments si nécessaire", puis ajoutez à toutes les cibles. -
Dans votre cible Xcode, sous l'onglet
General
, sélectionnezEmbed and Sign
pourGoogleCast.xcframework
.
Si vous configurez la bibliothèque statique, suivez les étapes ci-dessous en plus de les étapes précédentes:
- Configurer la bibliothèque Protobuf avec la version minimale version 3.13.
- Si votre projet utilise CocoaPods:
-
Ouvrez votre
Podfile
et supprimez legoogle-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 version 3.13 ou ultérieure, en suivant les instructions Protobuf GitHub repo.
-
Dans votre projet Xcode, ajoutez les options
-ObjC -lc++
pour Build Settings > Autres indicateurs Linker : -
Localisez le dossier "Resources" dans le répertoire décompressé, puis
faire glisser
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
etMaterialDialogs.bundle
dans votre projet à côté duGoogleCast.xcframework
que vous ajouté précédemment. Cochez la case "Copier tous les éléments si nécessaire", puis ajoutez à tous les éléments. cibles.
Configuration de Catalyst sur Mac
Pour les applications compatibles avec Mac Catalyst, utilisez la bibliothèque dynamique du SDK Cast. Suivez la procédure de configuration manuelle pour ajouter le à votre projet. Exclure ensuite de manière conditionnelle le SDK Cast de Mac comme indiqué dans les Documentation Apple Les bibliothèques statiques sont précompilées pour l'architecture iOS, ce qui génère lors de la compilation sur la cible Mac.