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

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

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

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

Thiết lập Xcode

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

iOS 14

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

1. Thêm Cast iOS SDK 4.8.3 vào dự án của bạn

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

   Nếu không, hãy kéo SDK theo cách thủ công.

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

   Chỉ định NSBonjourServices trong Info.plist để cho phép chế độ tìm mạng cục bộ hoạt động trên iOS 14.

   Bạn sẽ cần thêm cả _googlecast._tcp và _<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, đây là mã nhận dạng giống với mã nhận dạng được xác định trong GCKDiscoveryCriteria.

   Cập nhật định nghĩa NSBonjourServices trong ví dụ 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. Thêm NSLocalNetworkUsageDescription vào Info.plist của bạn

   Bạn nên tuỳ chỉnh thông báo xuất hiện trong lời nhắc Mạng cục bộ 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 của ứng dụng cho NSLocalNetworkUsageDescription, chẳng hạn như để mô tả tính năng phát hiện Cast và các dịch vụ phát hiện khác, chẳng hạn 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ộ của iOS như minh hoạ trong bản mô phỏng.

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

   Bạn cũng nên phát hành lại ứng dụng của mình bằng phiên bản 4.8.3 càng sớm càng tốt.

iOS 13

Cảnh báo về iOS 13: Những thay đổi về quyền của Apple đối với iOS 13 và Xcode 11 đã ảnh hưởng đến SDK Google Cast cho iOS theo nhiều cách. Vui lòng xem tài liệu Các thay đổi trên iOS 13 để biết mức độ ảnh hưởng của các thay đổi này đến ứng dụng của bạn.

iOS 12

Cảnh báo về iOS 12: Nếu phát triển bằng Xcode 10, bạn cần có khả năng "Truy cập thông tin Wi-Fi" để khám phá và kết nối với các thiết bị truyền.

Đảm bảo rằng công tắc 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ơ cung cấp của bạn cần hỗ trợ tính năng Truy cập thông tin Wi-Fi. Bạn có thể thêm thông tin này trong Apple Developer Portal (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 tích hợp Google Cast bằng CocoaPods. Để tích hợp, hãy sử dụng CocoaPods google-cast-sdk.

Để 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à chuẩn bị dự án để sử dụng với Google Cast SDK.

Sau đây là ví dụ về cách thêm CocoaPod google-cast-sdk 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 của mình, bạn nên chỉ định một dải cho các pod để ngăn những thay đổi đột ngột ngoài dự kiến như được trình bày chi tiết trong hướng dẫn về podfile.

Trong đoạn mã này, phiên bản 4.8.3 và các phiên bản cho đến phiên bản chính tiếp theo (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 phiên bản 2.0.0.

Thiết lập thủ công

Sau đây là hướng dẫn cách thêm Cast iOS SDK vào dự án mà không dùng CocoaPods:

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

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

Tải xuống

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

Thư viện Cast iOS Sender SDK 4.8.3:

Tĩnh Động

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

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

1. Tải 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 trong trình điều hướng dự án Xcode (không kéo vào dự án Pods nếu bạn 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ả các mục tiêu.
4. Trong mục tiêu Xcode, trong 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 ngoà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 phiên bản 3.13 trở lên, theo hướng dẫn trên kho lưu trữ Protobuf GitHub.
2. Trong dự án Xcode, hãy thêm cờ -ObjC -lc++ vào Build Settings (Chế độ cài đặt bản dựng) > Other Linker Flags (Cờ trình liên kết khác).
3. Tìm thư mục Resources (Tài nguyên) trong thư mục đã giải nén rồi kéo GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle và MaterialDialogs.bundle vào dự án của bạn bên cạnh GoogleCast.xcframework mà bạn đã thêm trước đó. Chọn "Sao chép tất cả các mục nếu cần" và thêm vào tất cả các mục tiêu.

Thiết lập Mac Catalyst

Đối với những ứng dụng hỗ trợ Mac Catalyst, hãy sử 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 này vào dự án của bạn. Sau đó, loại trừ có điều kiện SDK Cast khỏi đích đến Mac như đề cập trong tài liệu của Apple. Các 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 xây dựng dựa trên mục tiêu Mac.