Cast 架構支援 iOS 14 以上版本,同時提供靜態和動態架構。
如需所有類別和方法的說明,請參閱 Google Cast iOS API 參考資料。
Xcode 設定
iOS 14
-
將 Cast iOS SDK 4.8.1 新增至專案
如果使用 CocoaPods,請使用
pod update
將 4.8.1 SDK 新增至專案。否則,請 手動提取 SDK。
-
在
Info.plist
中新增NSBonjourServices
在
Info.plist
中指定NSBonjourServices
,即可允許在 iOS 14 上成功探索區域網路。您必須同時將
_googlecast._tcp
和_<your-app-id>._googlecast._tcp
新增為服務,裝置探索功能才能正常運作。appID 是您的接收器 ID,也就是
GCKDiscoveryCriteria
中定義的 ID。更新以下
NSBonjourServices
範例定義,並將「ABCD1234」替換成您的應用程式 ID。 -
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
您應該為專案指定 Pod 範圍,以免發生意外的破壞性變更;詳情請參閱 podfile 指南。
在這個程式碼片段中,4.8.1 版和下一個主要版本 (major.minor.patch) 的版本都允許使用:
pod 'google-cast-sdk', '~> 4.8.1'
舉例來說,「~> 1.6.7」會包含 1.6.7 以上版本的所有版本,但不包括 2.0.0 版。
手動設定
以下操作說明是如何在不使用 CocoaPods 的情況下,將 Cast iOS SDK 新增至專案:
下載內容
下載下方的適當程式庫後,請按照設定步驟將架構新增至專案中。
Cast iOS Sender SDK 4.8.1 程式庫:
設定步驟
如何安裝程式庫:
- 下載並擷取適用於專案的 SDK。
- 設定動態 GoogleCastSDK 程式庫:
-
將解壓縮後的
.xcframework
拖曳至 Xcode 專案導覽工具中的主要專案 (如果您有 Pod 專案,而不是 Pod 專案)。 勾選「視需要複製所有項目」,並新增到所有目標中。 -
在 Xcode 目標的
General
分頁下,為GoogleCast.xcframework
選取Embed and Sign
。
如果您要設定靜態程式庫,則除了前述步驟外,也請按照下列步驟操作:
- 設定最低版本為 v3.13 的 Protobuf 程式庫。
- 如果專案使用 CocoaPods:
-
開啟
Podfile
,並移除google-cast-sdk
(如有):pod 'google-cast-sdk'
-
新增
Protobuf
程式庫 (如果沒有):pod 'Protobuf', '3.13'
-
在專案的根資料夾中執行
pod install
。 - 如果專案未使用 CocoaPods:
-
移除目前的
GoogleCastSDK
版本 (如有)。 - 按照 Protobuf GitHub 存放區中的指示操作,新增 Protobuf 程式庫 3.13 以上版本。
-
在 Xcode 專案中,將標記
-ObjC -lc++
加到「Build Settings」 >「Other Linker Flags」中。 -
在解壓縮的目錄中找出「Resources」資料夾,然後將
GoogleCastCoreResources.bundle
、GoogleCastUIResources.bundle
和MaterialDialogs.bundle
拖曳到專案裡 (您先前新增的GoogleCast.xcframework
旁邊)。勾選「視需要複製所有項目」,並新增至所有目標。
Mac Catalyst 設定
如果應用程式支援 Mac Catalyst,請使用 Cast SDK 的動態程式庫。 按照手動設定程序,將架構新增至專案。接著按照 Apple 說明文件中所述,有條件地從 Mac 目標中排除 Cast SDK。靜態程式庫已針對 iOS 架構預先編譯,因此針對 Mac 目標進行建構時,會導致連結器錯誤。