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 16 trở lên và có cả khung tĩnh lẫn 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.

Lưu ý: Các phiên bản mới của Cast iOS SDK XCFrameworks hiện đã ra mắt, hỗ trợ 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, linh hoạt nhất" sẽ khiến các ứng dụng sử dụng SDK iOS của Cast 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".

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

   Nếu bạn 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 sẽ cần gọi rõ ràng phương thức startDiscovery trên lớp GCKDiscoveryManager để bắt đầu khám phá thiết bị. Tính năng quét tự động bị tắt theo mặc định kể từ bản phát hành v4.5.0 của SDK Truyền.
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.

   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à cùng một 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

   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 trong tệp Info.plist của ứng dụng cho NSLocalNetworkUsageDescription, chẳng hạn như để mô tả tính năng khám phá Truyền 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 vào mạng cục bộ trên iOS như 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

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

Cách thêm SDK Truyền cho iOS vào dự án của bạ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 tạo phiên bản. Ví dụ: chọn Up to Next Major Version (Lê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 có thể gây lỗi ngoài dự kiế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 sản phẩ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 SDK Truyền cho iOS cung cấp hai sản phẩm:

• GoogleCastDynamic: Khung linh động. Thư viện này bao gồm tất cả tài nguyên thành phần mà các thành phần giao diện người dùng của Cast yêu cầu và không yêu cầu thêm cờ trình liên kết 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 phần Thiết lập Mac Catalyst.
• GoogleCastStatic: Khung tĩnh. Bạn cần thực hiện thêm các bước thiết lập được 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ể bao gồm các gói tài nguyên. Do đó, Trình quản lý gói Swift 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 của Cast (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 (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 của Cast, hãy thêm các gói thành phần vào dự án theo cách thủ công:
   1. Tải thư viện tĩnh xuống từ phần 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ả tệp .bundle vào dự án Xcode. Đánh dấu vào ô "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.

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 thành phần trong dự án bằng các gói từ 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 gần đây nhất được phát hành cho CocoaPods. Các bản cập nhật tiếp theo sẽ được cung cấp thông qua Trình quản lý gói Swift và sẽ tiếp tục được cung cấp qua tệp tải xuống trực tiếp.

Thiết lập thủ công

Sau đây là hướng dẫn thêm SDK Truyền cho iOS vào dự án của bạn mà không cần sử dụng Trình quản lý gói Swift:

Điểm mấu chốt: Kể từ phiên bản 4.8.4, nếu bạn đang sử dụng một thư viện khác phụ thuộc vào Protobuf (chẳng hạn như Firebase), thì việc sử 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 đề tiềm ẩn về khả năng tương thích phiên bản với Protobuf. Tuy nhiên, nếu sự khác biệt về kích thước là vấn đề đáng lo ngại trong trường hợp của bạn, 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 vào dự án của bạn.

Thư viện SDK người gửi Cast cho iOS phiên bản 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 xuống và giải nén 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. Đánh dấu vào "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.
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, làm theo hướng dẫn trong kho lưu trữ Protobuf trên 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 (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 Resources (Tài nguyên) trong thư mục đã giải nén và kéo tất cả tệp .bundle vào dự án của bạn, bên cạnh tệp GoogleCast.xcframework mà bạn đã thêm trước đó. Đánh dấu vào "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 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 vào dự án của bạn. Sau đó, loại trừ có điều kiện SDK Truyền khỏi mục tiêu Mac như được đề 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 cho mục tiêu Mac.