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.

Thiết lập Xcode

iOS 14

1. Thêm Cast iOS SDK 4.8.3 vào dự án

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

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

2. Thêm NSBonjourServices vào Info.plist

   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. Thêm NSLocalNetworkUsageDescription vào Info.plist

   Bạn nên tuỳ chỉnh thông báo hiển thị trong thẻ Địa phương Lời nhắc về mạng bằng cách thêm một chuỗi quyền dành riêng cho ứng dụng vào Tệp Info.plist cho phần NSLocalNetworkUsageDescription, chẳng hạn như để mô tả tính năng Truyền khám phá và các dịch vụ khám phá khác, như DIAL.

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

   Thông báo này sẽ xuất hiện trong hộp thoại Quyền truy cập mạng cục bộ trên iOS dưới dạng hiển thị trong mô phỏng.

   
4. Phát hành lại ứng dụng lên App Store của Apple

   Bạn cũng nên phát hành lại ứng dụng bằng phiên bản 4.8.3 dưới dạng sớm nhất có thể.

iOS 13

iOS 12

Đảm bảo nút bật/tắt Truy cập thông tin Wi-Fi trong phần Chức năng của mục tiêu được đặt thành "Bật".

Ngoài ra, hồ sơ cấp phép của bạn sẽ cần hỗ trợ Truy cập Wi-Fi Thông tin. Bạn có thể thêm thông tin này vào Cổng thông tin dành cho nhà phát triển của Apple.

Thiết lập CocoaPods

Bạn nên dùng Google Cast để tích hợp CocoaPods Để tích hợp, hãy sử dụng google-cast-sdk CocoaPods.

Để bắt đầu, hãy làm theo hướng dẫn bắt đầu sử dụng.

Sau khi thiết lập CocoaPods, hãy làm theo hướng dẫn sử dụng CocoaPods để tạo Podfile và dự án của bạn sẵn sàng để sử dụng với Google Cast SDK.

Sau đây là ví dụ về cách thêm google-cast-sdk CocoaPod vào 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.3 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.3'

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 Cast iOS vào dự án của bạn mà không cần sử dụng CocoaPods:

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.3:

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 phiên bản 3.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 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.