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 16 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 ý: Các phiên bản mới của Cast iOS SDK XCFramework hiện đã ra mắt, 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, tích cực 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".

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

   Nếu bạn đang sử dụng Trình quản lý gói Swift, hãy cập nhật gói google-cast-ios-sdk lên phiên bản 4.8.6.

   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ị. Theo mặc định, tính năng quét tự động đã bị vô hiệu hoá kể từ bản phát hành v4.5.0 của Cast SDK.
2. Thêm NSBonjourServices vào Info.plist

   Chỉ định NSBonjourServices trong Info.plist để cho phép chế độ tìm mạng cục bộ hoạt động thành công.

   Bạn 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 vào 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 bằng phiên bản 4.8.6 càng sớm càng tốt.

Thiết lập Trình quản lý gói Swift

Cách tích hợp Google Cast được đề xuất là sử dụng Trình quản lý gói Swift (SPM). Gói Cast iOS SDK có trong kho lưu trữ google-cast-ios-sdk trên GitHub.

Cách thêm Cast iOS SDK vào dự án trong Xcode:

1. Trong Xcode, hãy chọn File (Tệp) > Add Packages... (Thêm gói).
2. Nhập URL của kho lưu trữ: https://github.com/googlecast/google-cast-ios-sdk.
3. Chọn quy tắc quản lý phiên bản. Ví dụ: chọn Lên đến phiên bản chính tiếp theo với phiên bản tối thiểu là 4.8.6 để nhận các bản cập nhật tương thích mà không có thay đổi đột ngột không mong muốn.
4. Nhấp vào Thêm gói.
5. Chọn sản phẩm GoogleCastDynamic hoặc GoogleCastStatic rồi thêm vào mục tiêu ứng dụng.

Cảnh báo: Chỉ thêm một trong các sản phẩm GoogleCastDynamic hoặc GoogleCastStatic vào mục tiêu của bạn. Đừng thêm cả hai biến thể của SDK vào cùng một ứng dụng.

Chọn một biến thể khung

Gói Cast iOS SDK cung cấp 2 sản phẩm:

• GoogleCastDynamic: Khung linh động. Thư viện này bao gồm tất cả các tài nguyên cần thiết của thành phần giao diện người dùng Cast và không yêu cầu bất kỳ cờ trình liên kết bổ sung nào. Ứng dụng hỗ trợ Mac Catalyst phải sử dụng khung động. Để biết thêm thông tin, hãy xem bài viết Thiết lập Mac Catalyst.
• GoogleCastStatic: Khung tĩnh. Bạn cần thực hiện các bước thiết lập bổ sung như mô tả trong phần Thiết lập khung tĩnh.

Thiết lập khung tĩnh

Khung tĩnh không thể chứa các gói tài nguyên. Do đó, Swift Package Manager không thể tự động gói các tài nguyên cần thiết cho các thành phần Giao diện người dùng truyền (chẳng hạn như hình ảnh giao diện người dùng, bảng phân cảnh và tệp bản địa hoá) với sản phẩm GoogleCastStatic. Nếu bạn thêm GoogleCastStatic vào mục tiêu, hãy hoàn tất các bước sau:

1. 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).
2. Nếu ứng dụng của bạn sử dụng các thành phần giao diện người dùng Cast, hãy thêm các gói tài sản vào dự án theo cách thủ công:
   1. Tải thư viện tĩnh xuống từ Tệp tải xuống. Đảm bảo rằng phiên bản của thư viện tĩnh khớp với phiên bản của gói mà bạn đã thêm.
   2. Tìm thư mục Resources trong thư mục đã giải nén rồi kéo tất cả các tệp .bundle vào dự án Xcode của bạ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ả các mục tiêu.

Lưu ý: Khi bạn cập nhật gói google-cast-ios-sdk lên phiên bản mới, hãy thay thế các gói tài sản trong dự án của bạn bằng các gói trong thư viện tĩnh của cùng phiên bản.

Thiết lập CocoaPods

Cảnh báo: Chúng tôi sẽ ngừng hỗ trợ CocoaPods. Phiên bản 4.8.6 là bản cập nhật mới nhất được xuất bản trên CocoaPods. Các bản cập nhật tiếp theo sẽ có trong Trình quản lý gói Swift và vẫn có thể tải xuống trực tiếp.

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 Trình quản lý gói Swift:

Điểm chính: Kể từ phiên bản 4.8.4, nếu bạn đang dùng một thư viện khác phụ thuộc vào Protobuf (chẳng hạn như Firebase), thì việc dùng thư viện tĩnh sẽ làm tăng kích thước ứng dụng cuối cùng.

Bạn nên sử dụng thư viện tĩnh để tránh các vấn đề có thể xảy ra về khả năng tương thích phiên bản với Protobuf. Tuy nhiên, 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.

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

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 chưa giải nén vào dự án chính trong trình điều hướng dự án Xcode. 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 động, hãy làm theo các bước sau ngoài các bước trước:

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.

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. 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).
2. Tìm thư mục Tài nguyên trong thư mục đã giải nén và kéo tất cả các tệp .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" rồi 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.