Thiết lập để phát triển bằng khung ứng dụng truyền (CAF) dành cho iOS

Khung Cast hỗ trợ iOS 14 trở lên, có trong cả khung tĩnh và khung động.

Hãy xem Tài liệu tham khảo API Google Cast cho iOS để biết nội dung mô tả về tất cả các lớp và phương thức.

Thiết lập Xcode

iOS 14

  1. Thêm SDK Truyền iOS 4.8.1 vào dự án

    Nếu sử dụng CocoaPods, hãy sử dụng pod update để thêm SDK 4.8.1 vào dự án của bạn.

    Nếu không, hãy lấy SDK theo cách thủ công.

  2. Thêm NSBonjourServices vào Info.plist của bạn

    Hãy chỉ định NSBonjourServices trong Info.plist để cho phép khám phá mạng cục bộ thành công trên iOS 14.

    Bạn sẽ cần thêm cả _googlecast._tcp_<your-app-id>._googlecast._tcp làm dịch vụ để tính năng khám phá thiết bị hoạt động đúng cách.

    appID là receiverID của bạn, cũng là ID được xác định trong GCKDiscoveryCriteria.

    Cập nhật định nghĩa NSBonjourServices mẫu sau và thay thế "ABCD1234" bằng appID của bạn.

    <key>NSBonjourServices</key>
    <array>
      <string>_googlecast._tcp</string>
      <string>_ABCD1234._googlecast._tcp</string>
    </array>
  3. Add NSLocalNetworkUsageDescription to your Info.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 the NSLocalNetworkUsageDescription such as to describe Cast discovery and other discovery services, like DIAL.

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

    This message will appear as part of the iOS Local Network Access dialog as shown in the mock.

    Cast Local Network Access permissions dialog image
  4. 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

Đối với dự án, bạn nên chỉ định một phạm vi cho các nhóm để ngăn chặn các thay đổi có thể gây lỗi không mong muốn như được nêu chi tiết trong hướng dẫn về tệp pod.

Trong đoạn mã này, bạn có thể sử dụng phiên bản 4.8.1 và các phiên bản lên đến phiên bản lớn tiếp theo (major.minor.patch):

pod 'google-cast-sdk', '~> 4.8.1'

Ví dụ: "~> 1.6.7" sẽ bao gồm mọi phiên bản từ 1.6.7 trở lên nhưng không bao gồm phiên bản 2.0.0.

Thiết lập thủ công

Hướng dẫn sau đây là để thêm SDK Truyền dành cho iOS vào dự án mà không sử dụng CocoaPods:

Nội dung tải xuống

Sau khi tải thư viện thích hợp bên dưới xuống, hãy làm theo các bước thiết lập để thêm khung vào dự án của bạn.

Thư viện Cast iOS Sender SDK 4.8.1:

Tĩnh Linh động

Các bước thiết lập

Cách cài đặt thư viện:

  1. Tải xuống và trích xuất SDK phù hợp cho dự án của bạn.
  2. Thiết lập thư viện GoogleCastSDK động:
  3. Kéo .xcframework đã giải nén vào dự án chính của bạn trong trình điều hướng dự án Xcode (không phải vào dự án Nhóm nếu bạn có dự án). Chọn "Sao chép tất cả các mục nếu cần" và thêm vào tất cả mục tiêu.
  4. Trong mục tiêu Xcode của bạn, bên dưới thẻ General, hãy chọn Embed and Sign cho GoogleCast.xcframework.

Nếu bạn đang thiết lập thư viện tĩnh, hãy làm theo các bước sau cùng với các bước trước đó:

  1. Thiết lập thư viện Protobuf với phiên bản tối thiểu là v3.13.
    1. Nếu dự án của bạn sử dụng CocoaPods:
      1. Mở Podfile và xoá google-cast-sdk (nếu có):
        pod 'google-cast-sdk'
      2. Thêm thư viện Protobuf nếu chưa có:
        pod 'Protobuf', '3.13'
      3. Chạy pod install trong thư mục gốc của dự án.
    2. Nếu dự án của bạn không sử dụng CocoaPods:
      1. Xoá phiên bản hiện tại của GoogleCastSDK (nếu có).
      2. Thêm thư viện Protobuf v3.13 trở lên, làm theo hướng dẫn trên kho lưu trữ GitHub Protobuf.
  2. Trong dự án Xcode của bạn, hãy thêm các cờ -ObjC -lc++ vào phần Cài đặt bản dựng > Cờ trình liên kết khác.
  3. Tìm thư mục Tài nguyên trong thư mục đã giải nén rồi kéo GoogleCastCoreResources.bundle, GoogleCastUIResources.bundleMaterialDialogs.bundle vào dự án của bạn bên cạnh GoogleCast.xcframework mà bạn đã thêm trước đó. Hãy chọn "Sao chép tất cả các mục nếu cần" và thêm vào tất cả mục tiêu.

Thiết lập Catalyst cho máy Mac

Đối với các ứng dụng hỗ trợ Mac Catalyst, hãy dùng thư viện động của Cast SDK. Làm theo quy trình thiết lập thủ công để thêm khung vào dự án của bạn. Sau đó, loại trừ SDK Truyền khỏi mục tiêu của máy Mac theo cách có điều kiện như đã đề cập trong tài liệu của Apple. Thư viện tĩnh được biên dịch trước cho cấu trúc iOS, gây ra lỗi trình liên kết khi tạo dựa trên mục tiêu Mac.