Przygotowanie do programowania za pomocą platformy Cast Application Framework (CAF) na iOS

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

  1. 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.

  2. Dodaj: NSBonjourServices do: Info.plist

    Podaj NSBonjourServices w polu Info.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ę iNSBonjourServicesponiższy przykład zastąp „ABCD1234” z identyfikatorem aplikacji.

    <key>NSBonjourServices</key>
    <array>
      <string>_googlecast._tcp</string>
      <string>_ABCD1234._googlecast._tcp</string>
    </array>
  3. Dodaj NSLocalNetworkUsageDescription do Info.plist

    Zdecydowanie zalecamy dostosowanie komunikatu wyświetlanego w sekcji Prośba o dostęp do sieci przez dodanie ciągu uprawnień aplikacji w polu Info.plist dla NSLocalNetworkUsageDescription, np. aby opisać przesyłanie. wykrywania i innych usług, takich jak DIAL.

    <key>NSLocalNetworkUsageDescription</key>
    <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
    network.</string>

    Ten komunikat będzie widoczny w oknie Dostęp do sieci lokalnej w iOS jako widoczne na przykładzie.

    Obraz okna uprawnień dostępu do sieci lokalnej przesyłania
  4. Ponowne publikowanie aplikacji w Apple App Store

    Zalecamy też ponowne opublikowanie aplikacji przy użyciu wersji 4.8.3 jako jak najszybciej.

iOS 13

iOS 12

Upewnij się, że przełącznik Dostęp do informacji Wi-Fi w sekcji Możliwości sieci docelowej jest ustawiona na „Wł.”.

Profil obsługi administracyjnej musi też obsługiwać dostęp do Wi-Fi. Zdolnośćinformacji. Można to dodać w Portal dla programistów Apple

Konfiguracja CocoaPods

Zalecany sposób integracji Google Cast to CocoaPods. Do integracji użyj google-cast-sdk CocoaPods.

Aby rozpocząć, skorzystaj z przewodnika po rozpoczęciu.

Po skonfigurowaniu CocoaPods postępuj zgodnie z instrukcjami przewodnik dotyczący korzystania z CocoaPods aby utworzyć zasób Podfile i przygotować projekt do użycia w Google Cast SDK.

Oto przykład, jak dodać google-cast-sdk CocoaPod do: 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&#39; 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:

Statyczny Dynamiczne

Instrukcje konfiguracji

Aby zainstalować bibliotekę:

  1. Pobierz i wyodrębnij odpowiedni pakiet SDK dla swojego projektu.
  2. Skonfiguruj dynamiczną bibliotekę GoogleCastSDK:
  3. 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.
  4. W miejscu docelowym Xcode na karcie General wybierz Embed and Sign dla GoogleCast.xcframework.

Jeśli konfigurujesz bibliotekę statyczną, wykonaj dodatkowe czynności poprzednie kroki:

  1. Konfigurowanie biblioteki Protobuf z minimalną wersją wersja 3.13.
    1. Jeśli Twój projekt używa CocoaPods:
      1. Otwórz aplikację Podfile i usuń google-cast-sdk (jeśli występuje):
        pod 'google-cast-sdk'
      2. Dodaj bibliotekę Protobuf, jeśli jej nie ma:
        pod 'Protobuf', '3.13'
      3. Uruchom pod install w folderze głównym projektu.
    2. Jeśli Twój projekt nie korzysta z CocoaPods:
      1. Usuń bieżącą wersję pakietu GoogleCastSDK, jeśli jest dostępna.
      2. Dodaj bibliotekę Protobuf w wersji 3.13 lub nowszej, postępując zgodnie z instrukcjami podanymi na Protokół GitHub .
  2. W projekcie Xcode dodaj flagi -ObjC -lc++ do Ustawienia kompilacji > Inne flagi łączące.
  3. W rozpakowanym katalogu znajdź folder Resources i przeciągnij do projektu pliki GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle i MaterialDialogs.bundle, umieszczając je obok wcześniej dodanego pliku GoogleCast.xcframework. 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.