Khung Cast hỗ trợ iOS 14 trở lên, có cả khung tĩnh và động.
Hãy xem Tài liệu tham khảo API Google Cast dành cho iOS để biết nội dung mô tả về tất cả các lớp và phương thức.
Thiết lập Xcode
iOS 14
-
Thêm Cast iOS SDK 4.8.1 vào dự án của bạ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, hãy lấy SDK theo cách thủ công.
-
Thêm
NSBonjourServices
vàoInfo.plist
của bạnChỉ định
NSBonjourServices
trongInfo.plist
để cho phép khám phá mạng cục bộ thành cô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 được xác định trong
GCKDiscoveryCriteria
.Hãy cập nhật định nghĩa
NSBonjourServices
của ví dụ sau và thay thế "ABCD1234" bằng appID. -
Add
NSLocalNetworkUsageDescription
to yourInfo.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 theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
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 12
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 một phạm vi cho các nhóm để ngăn chặn những thay đổi gây lỗi ngoài dự kiến như được nêu chi tiết trong hướng dẫn về Podfile.
Trong đoạn mã này, phiên bản 4.8.1 và các phiên bản lên đến phiên bản chính tiếp theo (major.minor.patch) được cho phép:
pod 'google-cast-sdk', '~> 4.8.1'
Ví dụ: "~> 1.6.7" sẽ bao gồm mọi 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
Các hướng dẫn sau là để thêm Cast iOS SDK vào dự án của bạn mà không cần sử dụng CocoaPods:
Nội dung tải xuống
Sau khi tải thư viện thích hợp bên dưới 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 Cast iOS Sender SDK 4.8.1:
Các bước thiết lập
Cách cài đặt thư viện:
- Tải xuống và giải nén SDK phù hợp cho dự án của bạn.
- Thiết lập thư viện GoogleCastSDK động:
-
Kéo
.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 vào dự án Nhóm nếu bạn 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ả mục tiêu. -
Trong mục tiêu Xcode của bạn, trong thẻ
General
, hãy chọnEmbed and Sign
choGoogleCast.xcframework
.
Nếu bạn đang thiết lập thư viện tĩnh, ngoài các bước trước đó, hãy làm theo các bước sau:
- Thiết lập thư viện Protobuf với phiên bản tối thiểu là v3.13.
- Nếu dự án của bạn sử dụng CocoaPods:
-
Mở
Podfile
và xoágoogle-cast-sdk
(nếu có):pod 'google-cast-sdk'
-
Thêm thư viện
Protobuf
nếu chưa có:pod 'Protobuf', '3.13'
-
Chạy
pod install
trong thư mục gốc của dự án. - Nếu dự án của bạn không sử dụng CocoaPods:
-
Xoá phiên bản hiện tại của
GoogleCastSDK
(nếu có). - 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ữ GitHub về Protobuf.
-
Trong dự án Xcode của bạn, hãy thêm cờ
-ObjC -lc++
vào Cài đặt bản dựng > Cờ trình liên kết khác. -
Tìm thư mục Resource (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 bên cạnhGoogleCast.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ả mục tiêu.
Thiết lập Mac Catalyst
Đối với các ứ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 Cast khỏi mục tiêu 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.