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 新增到專案:
下載內容
下載下方的適當程式庫後,請按照設定步驟將架構新增至專案。
投放 iOS Sender SDK 4.8.1 程式庫:
設定步驟
安裝程式庫的步驟如下:
- 下載並擷取專案適用的 SDK。
- 設定動態 GoogleCastSDK 程式庫:
-
將解壓縮後的
.xcframework
拖曳至 Xcode 專案導覽器中的主要專案 (如有,則拖曳至 Pod 專案)。勾選「視需要複製所有項目」,然後新增至所有目標。 -
在 Xcode 目標的
General
標籤下方,選取Embed and Sign
做為GoogleCast.xcframework
。
如要設定靜態程式庫,除了上述步驟之外,請一併按照下列步驟操作:
- 使用最低版本為 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 目標建構時會導致連結器錯誤。