Das Cast-Framework unterstützt iOS 14 und höher und ist in statischen und dynamischen Frameworks enthalten.
Beschreibungen aller Klassen und Methoden finden Sie in der Referenz zur Google Cast iOS API.
Xcode-Einrichtung
iOS 14
-
Cast iOS SDK 4.8.1 zu Ihrem Projekt hinzufügen
Wenn du CocoaPods verwendest, verwende
pod update
, um deinem Projekt das 4.8.1 SDK hinzuzufügen.Alternativ können Sie das SDK manuell abrufen.
-
NSBonjourServices
zu deinemInfo.plist
hinzufügenGeben Sie
NSBonjourServices
in IhrerInfo.plist
an, damit die Erkennung des lokalen Netzwerks unter iOS 14 erfolgen kann.Sie müssen sowohl
_googlecast._tcp
als auch_<your-app-id>._googlecast._tcp
als Dienste hinzufügen, damit die Geräteerkennung ordnungsgemäß funktioniert.Die appID ist Ihre ReceiverID, also dieselbe ID, die in
GCKDiscoveryCriteria
definiert ist.Aktualisieren Sie die folgende
NSBonjourServices
-Beispieldefinition und ersetzen Sie „ABCD1234“ durch Ihre appID. -
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
In Ihrem Projekt sollten Sie einen Bereich für die Pods angeben, um unerwartete abwärtskompatible Änderungen zu vermeiden, wie im Podfile-Leitfaden beschrieben.
In diesem Snippet sind Version 4.8.1 und die Versionen bis zur nächsthöheren Hauptversion (major.minor.patch) zulässig:
pod 'google-cast-sdk', '~> 4.8.1'
Zum Beispiel enthält '~> 1.6.7' alle Versionen von 1.6.7 bis, aber nicht einschließlich, Version 2.0.0.
Manuelle Einrichtung
So fügen Sie Ihrem Projekt das Cast iOS SDK hinzu, ohne CocoaPods zu verwenden:
Downloads
Nachdem Sie unten die entsprechende Bibliothek heruntergeladen haben, führen Sie die Einrichtungsschritte aus, um das Framework Ihrem Projekt hinzuzufügen.
Cast-Bibliotheken des Sender SDK 4.8.1 für iOS:
Einrichtungsschritte
So installieren Sie die Bibliothek:
- Laden Sie das entsprechende SDK für Ihr Projekt herunter und extrahieren Sie es.
- Richte die dynamische GoogleCastSDK-Bibliothek ein:
-
Ziehen Sie das entpackte
.xcframework
im Xcode-Projektnavigator in Ihr Hauptprojekt (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, führen Sie zusätzlich zu den vorherigen Schritten folgende Schritte aus:
- Richten Sie die Protobuf-Bibliothek mit der Mindestversion v3.13 ein.
- Wenn in Ihrem Projekt CocoaPods verwendet werden:
-
Öffnen Sie
Podfile
und entfernen Siegoogle-cast-sdk
, falls 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 keine CocoaPods verwendet werden:
-
Entfernen Sie die aktuelle Version von
GoogleCastSDK
, falls vorhanden. - Fügen Sie die Protobuf-Bibliothek ab Version 3.13 hinzu. Folgen Sie dazu der Anleitung im GitHub-Repository für Protobuf.
-
Fügen Sie in Ihrem Xcode-Projekt die Flags
-ObjC -lc++
unter Build Settings > Other Linker Flags (Build-Einstellungen > Andere Verknüpfungs-Flags) 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
. Aktivieren Sie „Bei Bedarf alle Elemente kopieren“ und fügen Sie sie allen Zielen hinzu.
Einrichtung von Mac Catalyst
Verwende für Apps, die Mac Catalyst unterstützen, die dynamische Bibliothek des Cast SDK. Folgen Sie dem manuellen Einrichtungsprozess, um das Framework Ihrem Projekt 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. Dadurch wird beim Erstellen für das Mac-Ziel ein Verknüpfungsfehler ausgelöst.