Das Cast-Framework unterstützt iOS 14 und höher und ist sowohl in statischen als auch als dynamischen Frameworks verfügbar.
Beschreibungen aller Klassen und Methoden finden Sie in der Google Cast iOS API-Referenz.
Xcode-Einrichtung
iOS 14
-
Fügen Sie Ihrem Projekt das Cast iOS SDK 4.8.1 hinzu.
Wenn Sie CocoaPods verwenden, fügen Sie Ihrem Projekt das SDK 4.8.1 mit
pod update
hinzu.Alternativ können Sie das SDK manuell abrufen.
-
NSBonjourServices
zuInfo.plist
hinzufügenGib
NSBonjourServices
in deinemInfo.plist
an, damit die lokale Netzwerkerkennung unter iOS 14 erfolgreich ist.Du musst sowohl
_googlecast._tcp
als auch_<your-app-id>._googlecast._tcp
als Dienste hinzufügen, damit die Geräteerkennung ordnungsgemäß funktioniert.Die appID ist deine ReceiverID. Das ist dieselbe ID, die in
GCKDiscoveryCriteria
definiert ist.Aktualisieren Sie die folgende
NSBonjourServices
-Beispieldefinition und ersetzen Sie „ABCD1234“ durch Ihre Anwendungs-ID. -
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
Für Ihr Projekt sollten Sie einen Bereich für Ihre Pods angeben, um unerwartete Änderungen zu verhindern, wie in der Anleitung zu Pods beschrieben.
In diesem Snippet sind Version 4.8.1 und die Versionen bis zur nächsten Hauptversion (major.minor.patch) zulässig:
pod 'google-cast-sdk', '~> 4.8.1'
Beispielsweise würde „~> 1.6.7“ alle Versionen von 1.6.7 bis, jedoch nicht einschließlich, Version 2.0.0, umfassen.
Manuelle Einrichtung
So fügen Sie Ihrem Projekt das Cast iOS SDK hinzu, ohne CocoaPods zu verwenden:
Downloads
Nachdem Sie die entsprechende Bibliothek unten heruntergeladen haben, führen Sie die Einrichtungsschritte aus, um Ihrem Projekt das Framework hinzuzufügen.
Cast-Bibliotheken für iOS Sender SDK 4.8.1:
Einrichtungsschritte
So installieren Sie die Bibliothek:
- Laden Sie das für Ihr Projekt geeignete SDK herunter und extrahieren Sie es.
- Richten Sie die dynamische GoogleCastSDK-Bibliothek ein:
-
Ziehen Sie das entpackte
.xcframework
in Ihr Hauptprojekt in der Xcode-Projektnavigation (nicht in das Pod-Projekt, falls vorhanden). Aktivieren Sie die Option „Bei Bedarf alle Elemente kopieren“ und fügen Sie sie allen Zielen hinzu. -
Wählen Sie in Ihrem Xcode-Ziel auf dem Tab
General
die OptionEmbed and Sign
fürGoogleCast.xcframework
aus.
Wenn Sie die static-Bibliothek einrichten, müssen Sie zusätzlich zu den vorherigen Schritten die folgenden Schritte ausführen:
- Richten Sie die Protobuf-Bibliothek mit der Mindestversion 3.13 ein.
- Wenn in Ihrem Projekt CocoaPods verwendet werden:
-
Öffne
Podfile
und entferne dasgoogle-cast-sdk
, sofern vorhanden:pod 'google-cast-sdk'
-
Fügen Sie die
Protobuf
-Bibliothek hinzu, falls nicht vorhanden:pod 'Protobuf', '3.13'
-
Führen Sie
pod install
im Stammverzeichnis Ihres Projekts aus. - Wenn in Ihrem Projekt CocoaPods nicht verwendet werden:
-
Entfernen Sie die aktuelle Version von
GoogleCastSDK
, sofern vorhanden. - Fügen Sie die Protobuf-Bibliothek Version 3.13 oder höher hinzu. Folgen Sie dazu der Anleitung im Protobuf-GitHub-Repository.
-
Fügen Sie in Ihrem Xcode-Projekt unter Build-Einstellungen > Andere Verknüpfungs-Flags die Flags
-ObjC -lc++
hinzu. -
Suchen Sie im entpackten Verzeichnis den Ordner „Resources“ und ziehen Sie
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
undMaterialDialogs.bundle
in Ihr Projekt neben dem zuvor hinzugefügtenGoogleCast.xcframework
. Klicken Sie das Kästchen „Copy all items if needed“ (Alle Elemente bei Bedarf kopieren) an und fügen Sie sie allen Zielen hinzu.
Mac Catalyst-Einrichtung
Verwende für Apps, die Mac Catalyst unterstützen, die dynamische Bibliothek des Cast SDK. Folgen Sie der manuellen Einrichtung, um Ihrem Projekt das Framework hinzuzufügen. Schließen Sie dann das Cast SDK bedingt aus dem Mac-Ziel aus, wie in der Apple-Dokumentation beschrieben. Statische Bibliotheken werden für die iOS-Architektur vorkompiliert, was beim Erstellen für das Mac-Ziel zu einem Verknüpfungsfehler führt.