Platforma Cast obsługuje iOS 14 i nowsze wersje. statyczne i dynamiczne struktury.
Zobacz materiały referencyjne na temat interfejsu Google Cast iOS API dla opisy wszystkich klas i metod.
Konfiguracja Xcode
iOS 14
-
Dodawanie do projektu pakietu SDK Cast na iOS 4.8.3
Jeśli korzystasz z CocoaPods, dodaj pakiet SDK 4.8.3 do projektu za pomocą
pod update
.W przeciwnym razie ręcznie pobrać pakiet SDK.
-
Dodaj:
NSBonjourServices
do:Info.plist
Podaj
NSBonjourServices
w poluInfo.plist
na pozwala na skuteczne wykrywanie sieci lokalnej na urządzeniach z iOS 14.Musisz dodać zarówno
_googlecast._tcp
, jak i_<your-app-id>._googlecast._tcp
jako usługi dla urządzenia ich prawidłowe działanie.Identyfikator appID to Twój odbiorca ID, czyli ten sam identyfikator zdefiniowany w
GCKDiscoveryCriteria
Zaktualizuj definicję i
NSBonjourServices
poniższy przykład zastąp „ABCD1234” z identyfikatorem aplikacji. -
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.3 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
W projekcie musisz określić zakres dla podów, aby zapobiec nieoczekiwanym zmiany powodujące niezgodność opisane w podfile.
W tym fragmencie kodu w wersji 4.8.3 oraz w kolejnych wersja główna (major.minor.patch) jest dozwolona:
pod 'google-cast-sdk', '~> 4.8.3'
Na przykład „~>”. 1.6.7' będzie obejmować wszystkie wersje od 1.6.7 aż do, ale nie w tym wersję 2.0.0.
Konfiguracja ręczna
Wykonaj te instrukcje, aby dodać do projektu pakiet SDK Cast na iOS bez korzystania z CocoaPods:
Pobrane
Po pobraniu odpowiedniej biblioteki postępuj zgodnie z kroków konfiguracji, aby dodać platformę do platformy w projektach AI.
Biblioteki pakietu SDK Cast SDK 4.8.3 do przesyłania na iOS:
Instrukcje konfiguracji
Aby zainstalować bibliotekę:
- Pobierz i wyodrębnij odpowiedni pakiet SDK dla swojego projektu.
- Skonfiguruj dynamiczną bibliotekę GoogleCastSDK:
-
Przeciągnij rozpakowany plik
.xcframework
do głównego projektu Nawigator projektów Xcode (nie do projektu podów, jeśli taki masz). Zaznacz opcję „W razie potrzeby skopiuj wszystkie elementy” i dodaj ją do wszystkich elementów docelowych. -
W miejscu docelowym Xcode na karcie
General
wybierzEmbed and Sign
dlaGoogleCast.xcframework
.
Jeśli konfigurujesz bibliotekę statyczną, oprócz poprzednie kroki:
- Konfigurowanie biblioteki Protobuf z minimalną wersją wersja 3.13.
- Jeśli Twój projekt używa CocoaPods:
-
Otwórz aplikację
Podfile
i usuńgoogle-cast-sdk
(jeśli występuje):pod 'google-cast-sdk'
-
Dodaj bibliotekę
Protobuf
, jeśli jej nie ma:pod 'Protobuf', '3.13'
-
Uruchom
pod install
w folderze głównym projektu. - Jeśli Twój projekt nie korzysta z CocoaPods:
-
Usuń bieżącą wersję pakietu
GoogleCastSDK
, jeśli jest dostępna. - Dodaj bibliotekę Protobuf w wersji 3.13 lub nowszej, postępując zgodnie z instrukcjami podanymi na Protokół GitHub .
-
W projekcie Xcode dodaj flagi
-ObjC -lc++
do Ustawienia kompilacji > Inne flagi łączące. -
W rozpakowanym katalogu znajdź folder Resources
przeciągnij:
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
iMaterialDialogs.bundle
obok projektuGoogleCast.xcframework
dodane wcześniej. Zaznacz „W razie potrzeby skopiuj wszystkie elementy” i dodaj do wszystkich celów.
Konfiguracja Mac Catalyst
W przypadku aplikacji obsługujących Mac Catalyst użyj biblioteki dynamicznej z pakietu Cast SDK. Wykonaj ręczną konfigurację, aby dodać parametr platformy w projekcie. Następnie warunkowo wyklucz pakiet SDK Cast na Macu zgodnie z opisem w Dokumentacja Apple Biblioteki statyczne są wstępnie skompilowane pod kątem architektury iOS, co powoduje podczas kompilacji na komputerze Mac.