从 iOS 14 开始,操作系统会强制执行新的限制和权限,这会影响到 Cast 用户体验。该变更还会影响将 Cast SDK 构建到应用中的方式。为了让应用保留最新版 iOS 的 Cast 功能,您必须进行更新来处理这些权限变更。
iOS 14
开发者应将其 iOS Cast 发送者应用更新到 Google Cast SDK v4.6.0 或更高版本。这些版本支持 iOS 14 及其要求。
从 iOS 14 开始,扫描本地网络中的设备的应用会提示用户提供一次性权限对话框,用于查找并连接到本地网络设备。Cast 平台使用本地网络发现和控制投放设备,因此如果用户拒绝授予权限,他们将无法投射。
为了改善用户体验,我们正在为使用标准设备选择器的应用对 SDK 进行一些用户体验修改。这些用户体验修改更清楚地向用户表明为什么需要本地网络访问权限,以及如何在本地网络设备访问权限被停用时启用投射。
对于使用 v4.4.8 或更低版本的 Cast SDK 构建的应用,只要这些应用是使用 Xcode 11.7 或更低版本构建的,就可以继续运行。如果您要使用 Xcode 12 或更高版本针对 iOS 14 进行构建,我们建议您更新到 Cast SDK v4.6.0 或更高版本,以确保您的 Cast 应用继续正常运行。
Cast iOS SDK v4.6.0 或更高版本可以按照 CocoaPods 设置进行下载,或者按照手动设置手动下载。此版本更改了底层发现机制,以允许使用 Xcode 12 构建的应用在网络上查找 Cast 设备。“投放”按钮现在应始终显示。如果用户点按“投放”按钮时没有可用的设备,系统会显示一个对话框,其中会说明设备不可用的可能原因,包括如何重新启用本地网络访问权限。
Cast SDK 变更
首次投放
当用户首次尝试投放时,系统会显示本地网络访问权限 (LNA) 插页式广告对话框,其中解释为什么需要本地网络访问权限,然后是 Apple 提供的 iOS 本地网络访问权限提示。以下模拟展示了该流程:
投放不可用
从 iOS 发送者 SDK 4.6.0 开始,当用户连接到 Wi-Fi 时,“投射”按钮会始终显示。当 Cast 设备不可用时,点按 Cast 按钮会打开一个对话框,为用户提供有关 Cast 不可用的可能提示,如以下模拟所示:
在 iOS 14 上更新您的应用
-
将 Cast iOS SDK 4.8.0 添加到项目中
如果使用的是 CocoaPods,请使用
pod update
将 4.8.0 SDK 添加到您的项目中。否则,请 手动拉取 SDK。
-
将
NSBonjourServices
添加到Info.plist
在
Info.plist
中指定NSBonjourServices
,以允许本地网络发现功能在 iOS 14 上成功运行。您需要将
_googlecast._tcp
和_<your-app-id>._googlecast._tcp
添加为服务,设备发现功能才能正常运行。appID 是您的接收器 ID,与
GCKDiscoveryCriteria
中定义的 ID 相同。请更新以下示例
NSBonjourServices
定义,并将“ABCD1234”替换为您的 appID。 -
将
NSLocalNetworkUsageDescription
添加到Info.plist
我们强烈建议您自定义本地网络提示中显示的消息,方法是在应用的
Info.plist
文件中为NSLocalNetworkUsageDescription
添加特定于应用的权限字符串,以便描述 Cast 发现和其他发现服务(如 DIAL)。此消息将作为模拟的一部分显示在 iOS 本地网络访问权限对话框中。
-
将应用重新发布到 Apple App Store
我们还建议您尽快使用 4.8.0 版重新发布应用。
自定义设置
投放设备发现发起流程
默认情况下,用户首次点按“投放”按钮 (GCKUICastButton
) 时将启动 Cast 设备发现。如果这是用户升级到 iOS 14 后首次尝试在本地网络上使用 Cast 应用,系统会显示新的 LNA 插页式广告,然后显示 iOS 本地网络访问权限对话框。
您可以使用一个新标志来控制设备发现操作的开始时间以及用户体验的某些元素的行为:
startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)
默认值为 true
。仅当 GCKCastOptions::disableDiscoveryAutostart
标志设置为 false
时,此标志才适用。
如果设置为 true
,当用户首次点按 GCKUICastButton
时,系统会开始投射设备发现。系统将向用户显示一条信息消息,告知用户需要获得本地网络权限的原因。收到此消息后,系统会显示 iOS 14 LNA 消息。
确认消息后,投放设备发现便会开始。
在后续应用启动中,GCKUICastButton
始终会显示。
如果设置为 false
,设备发现将根据 GCKCastOptions::disableDiscoveryAutostart
标志的值启动。
常见问题解答
如果我使用 Cast SDK v4.4.8 和 Xcode 12 重新发布 Cast 发送器应用,会发生什么情况?
除非您从 Apple 获得网络多播使用权,否则您的应用可能无法发现本地网络中的投放设备。请注意,Apple 不会仅出于支持 Cast 的目的而授予多播权限。 如果您打算使用 Xcode 12 进行构建,则应使用 Cast 4.6.0 发布应用。
如果我使用新 Cast SDK 重新发布应用,我的用户能否在 iOS 13 或更早版本上运行?
他们将继续获得与重新发布应用之前相同的用户体验。用户可见的更改仅限于运行 iOS 14 的用户。
新版 Cast SDK 发布后,我需要做些什么来更新应用?
- 更新应用的
Info.plist
,使其包含本地网络使用情况说明。 - 将
NSBonjourServices
添加到应用的Info.plist
,并提供 Cast 和应用名称的 Bonjour 服务名称。 - 升级发送者应用以使用 Cast SDK 4.6.0。
- 将您的应用重新发布到 Apple App Store。
升级到 4.6.0 后,为什么设备会停止在自定义设备选择器中显示?
如果您使用自定义设备选择器(而非标准设备选择器),就可能会出现这个已知问题。在 4.4.8 版 Cast SDK 中,设备扫描是自动进行的。从 4.6.0 版本开始,您将需要对
GCKDiscoveryManager
类明确调用 startDiscovery
方法来启动设备发现。
这是因为,在首次扫描后,本地网络访问权限 (LNA) 权限提示将会出现。这可能会导致权限对话框在您的应用中的随机位置显示。
为应用构建自定义设备选择器的开发者在 iOS 14 中首次启动设备扫描之前,应提供一次性插页式广告。
iOS 13
在 iOS 13 中,我们引入了新的权限要求,这些要求会影响使用 Google Cast SDK 的应用。
从 Google Cast SDK v4.4.3 开始,我们提供了一个无需蓝牙® 权限的其他 SDK。开发者网站和新的 google-cast-sdk-no-bluetooth
CocoaPods 中都提供了该组件。
应用细分
下面根据您当前使用的 iOS SDK 版本进行了细分:
使用 iOS 12 SDK 或更低版本构建的应用
- 建议采取的措施。在 iOS 13 上运行时,设备发现性能可能会降低,但仍会正常运行。我们强烈建议开发者升级到 Cast SDK v4.4.4(如果可用)。
- iOS 13 会提示用户向应用授予 Bluetooth® 蓝牙权限。
使用 iOS 13 SDK 构建的应用
- 建议采取行动:如果用户未授予位置信息权限,更新至 Cast SDK 4.4.4 或“投放”按钮可能不会显示。为确保在 iOS 13 上获得可靠的投放体验,必须升级到 Cast SDK 4.4.4。