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 và có trong cả hai khung tĩnh và động.

Xem Tài liệu tham khảo API Google Cast dành cho iOS để phần mô tả về tất cả các lớp và phương thức.

Lưu ý: Các phiên bản mới của Cast iOS SDK XCFrameworks hiện đã có sẵn, hỗ trợ phát triển trên máy tính Apple Silicon.

Thiết lập Xcode

Cảnh báo: Đặt cờ Apple Clang - Code Generation Optimization Level thành -Ofast cho 'Tối ưu hoá nhanh, mạnh mẽ nhất' sẽ khiến cho các ứng dụng sử dụng Truyền SDK iOS gặp sự cố do không tương thích với các tính năng tối ưu hoá. SDK hỗ trợ giá trị mặc định -Os cho "Nhanh nhất, nhỏ nhất".

iOS 14

Cảnh báo của iOS 14: Các thay đổi đối với iOS 14 quyền truy cập mạng cục bộ đã ảnh hưởng đến SDK Google Cast dành cho iOS trong một nhiều cách. Vui lòng xem Các thay đổi đối với iOS 14 để biết ứng dụng của bạn bị ảnh hưởng như thế nào.

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, lấy SDK theo cách thủ công.

   Lưu ý: Nếu đã tạo bộ chọn thiết bị tuỳ chỉnh trong ứng dụng của mình, thì bạn sẽ cần để gọi phương thức startDiscovery rõ ràng trên GCKDiscoveryManager để bắt đầu khám phá thiết bị. Tính năng quét tự động đã bị tắt mặc định kể từ bản phát hành SDK Truyền 4.5.0.
2. Thêm NSBonjourServices vào Info.plist của bạn

   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 cần thêm cả _googlecast._tcp và _<your-app-id>._googlecast._tcp làm dịch vụ cho thiết bị khám phá để hoạt động chính xác.

   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 trong ví dụ sau đây 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.

   
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 13 Warning: Apple permissions changes to iOS 13 and Xcode 11 have impacted the Google Cast iOS SDK in a number of ways. Please see the iOS 13 Changes document to see how your app will be impacted.

iOS 12

iOS 12 Warning: If developing using Xcode 10, the "Access WiFi Information" capability is required in order to discover and connect to Cast devices.

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 phạm vi cho các nhóm để ngăn chặn các nhóm quảng cáo không mong muốn những thay đổi có thể gây lỗi như được nêu chi tiết trong hướng dẫn về tệp podfile.

Trong đoạn mã này, phiên bản 4.8.1 và các phiên bản tiếp theo phiên bản lớn (major.minor.patch) được cho phép:

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

Ví dụ: '~> 1.6.7' sẽ bao gồm tất cả các phiên bản từ 1.6.7 trở lên, nhưng không bao gồm 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 của bạn nếu không sử dụng CocoaPods:

Lưu ý quan trọng: Bắt đầu từ phiên bản 4.3.1, CocoaPods sử dụng thư viện tĩnh để tránh các cảnh báo biểu tượng trùng lặp do sự cố phần phụ thuộc thư viện Protobuf dùng chung khi sử dụng Firebase và SDK Cast khi kết hợp cùng nhau. Mặc dù thay đổi này sẽ làm tăng kích thước tải xuống, nhưng ứng dụng cuối cùng sẽ không tăng lên.

Nếu bạn lo ngại về sự chênh lệch kích thước đối với trường hợp của mình, hãy tải xuống động để có kích thước tương tự như các phiên bản trước 4.3.1 của CocoaPods thư viện của bạn.

Tải xuống

Sau khi tải thư viện thích hợp xuống dưới đây, hãy làm theo các bước thiết lập để thêm khung vào dự á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 tệp .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 trong 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 bằng phiên bản tối thiểu phiên bản 3.13.
1. Nếu dự án của bạn sử dụng CocoaPods:
1. Mở Podfile của bạn 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, bằng cách làm theo các hướng dẫn trên Protobuf GitHub kho lưu trữ.
2. Trong dự án Xcode của bạn, hãy thêm các cờ -ObjC -lc++ vào Cài đặt bản dựng > Các cờ khác của trình liên kết.
3. Tìm thư mục Resource (Tài nguyên) trong thư mục đã giải nén và kéo GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle và MaterialDialogs.bundle vào dự án của bạn bên cạnh GoogleCast.xcframework bạn đã thêm trước đó. Chọn "Sao chép tất cả các mục nếu cần" rồi 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 vào dự án của mình. Sau đó, loại trừ SDK truyền khỏi máy Mac theo đ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 kiến trúc iOS, điều này khiến trình liên kết khi tạo dựa trên mục tiêu Mac.