Cast 框架支持 iOS 14 及更高版本,两者均提供 静态和动态框架。
如需了解更多详情,请参阅 Google Cast iOS API 参考 所有类和方法的说明。
Xcode 设置
iOS 14
-
将 Cast iOS SDK 4.8.3 添加到您的项目
如果使用的是 CocoaPods,请使用
pod update
将 4.8.3 SDK 添加到您的项目中。否则 手动提取 SDK。
-
将
NSBonjourServices
添加到Info.plist
在
Info.plist
中指定NSBonjourServices
,以允许在 iOS 14 上成功进行本地网络发现。您需要同时添加
_googlecast._tcp
和 “_<your-app-id>._googlecast._tcp
”作为设备的服务 才能正常工作appID 是您的接收器 ID,也就是您在
GCKDiscoveryCriteria
。更新以下示例
NSBonjourServices
定义并 替换“ABCD1234”与应用 ID 相关联。 -
将
NSLocalNetworkUsageDescription
添加到您的Info.plist
我们强烈建议您自定义 通过在应用的
Info.plist
文件NSLocalNetworkUsageDescription
(例如用于描述 Cast) 发现和其他发现服务,如 DIAL。此消息将在 iOS“本地网络访问权限”对话框中显示为 示例。
-
将应用重新发布到 Apple App Store
我们建议您也使用 4.8.3 重新发布您的应用, 问题。
iOS 13
iOS 12
确保 Capabilities(功能)中的 Access Wi-Fi Information(访问 Wi-Fi 信息)开关 部分设为“启用”
此外,您的配置文件需要支持访问 Wi-Fi 信息功能。可将其添加至 Apple Developer Portal。
CocoaPods 设置
集成 Google Cast 的推荐方法是使用
CocoaPods。对于集成,请使用
google-cast-sdk
CocoaPods。
要开始使用,请按照 入门指南。
CocoaPods 设置完成后,请按照
CocoaPods 使用指南
创建Podfile
并将项目与 Google Cast 搭配使用
SDK。
以下示例展示了如何将 google-cast-sdk
CocoaPod 添加到
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.3 及 允许主要版本 (major.minor.patch):
pod 'google-cast-sdk', '~> 4.8.3'
例如,“>= 1.6.7”将涵盖 1.6.7 及更高版本(但不包括 2.0.0 版本)。
手动设置
以下说明介绍了如何将 Cast iOS SDK 添加到您的项目 不使用 CocoaPods:
下载内容
下载以下相应库后,请按照 设置步骤,以便将框架添加到您的 项目。
Cast iOS Sender SDK 4.8.3 库:
设置步骤
如需安装该库,请执行以下操作:
- 下载并解压缩适用于您的项目的 SDK。
- 设置动态 GoogleCastSDK 库:
-
将解压缩的
.xcframework
拖动到 Xcode 项目导航器(如果有 Pod 项目,请勿进入)。 选中“复制所有项目(如果需要)”,然后添加到所有目标。 -
在 Xcode 目标中的
General
标签页下,为GoogleCast.xcframework
选择Embed and Sign
。
如果您要设置 static 库,除了 之前的步骤:
- 使用最低版本设置 Protobuf 库 v3.13。
- 如果您的项目使用 CocoaPods:
-
打开
Podfile
并移除google-cast-sdk
(如果存在):pod 'google-cast-sdk'
-
添加
Protobuf
库(如果不存在):pod 'Protobuf', '3.13'
-
在项目的根文件夹中运行
pod install
。 - 如果您的项目不使用 CocoaPods:
-
移除
GoogleCastSDK
的当前版本(如果存在)。 - 按照 Protobuf GitHub 代码库中的说明添加 Protobuf 库 v3.13 或更高版本。
-
在您的 Xcode 项目中,将标志
-ObjC -lc++
添加到 构建设置 >其他链接器标记。 -
在解压缩的目录中找到 Resources 文件夹,然后
拖动“
GoogleCastCoreResources.bundle
”,GoogleCastUIResources.bundle
和MaterialDialogs.bundle
进入您项目中的GoogleCast.xcframework
。选中“复制所有项目(如需要)”,然后添加至所有项目 目标。
Mac Catalyst 设置
对于支持 Mac Catalyst 的应用,请使用 Cast SDK 的动态库。 按照手动设置流程将框架添加到您的项目。然后,有条件地从 Mac 中排除 Cast SDK 如 Apple 文档。 静态库针对 iOS 架构进行了预编译,这会导致出现链接器 错误。