此页面由 Cloud Translation API 翻译。

iOS 权限和发现

从 iOS 14 开始，操作系统将强制执行影响投屏用户体验的新限制和权限。它还会影响您在应用中构建 Cast SDK 的方式。为了让应用在最新版本的 iOS 中保持 Cast 功能，您必须进行更新以处理这些权限变更。

iOS 14

开发者应将其 iOS Cast 发送方应用更新为 Google Cast SDK v4.6.0 或更高版本。这些版本支持 iOS 14 及其要求。

从 iOS 14 开始，扫描本地网络中设备的应用程序现在会通过一次性权限对话框提示用户查找和连接本地网络设备。Cast 平台使用本地网络来发现和控制 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 按钮时没有可用的设备，系统会显示一个对话框，其中提供有关设备可能无法使用的原因的指导，包括有关如何重新启用本地网络访问权限的信息。

Cast SDK 变更

首次投屏

用户首次尝试投屏时，系统会显示一个本地网络访问 (LNA) 插页式对话框，说明为何需要本地网络访问权限，然后显示 Apple 提供的 iOS 本地网络访问权限提示。以下模拟展示了该流程：

本地网络访问权限授予流程

Cast 不可用

从 iOS 发送方 SDK 4.6.0 开始，当用户连接到 Wi-Fi 时，系统始终会显示 Cast 按钮。当 Cast 设备不可用时，点按“投屏”按钮会显示一个对话框，其中会提示用户 Cast 不可用的可能原因，如下面的模拟界面所示：

使用 Cast 的 Flow 不可用

在 iOS 14 上更新应用

将 Cast iOS SDK 4.8.3 添加到您的项目
如果使用 CocoaPods，请使用 pod update 将 4.8.3 版 SDK 添加到您的项目中。

否则，请手动拉取 SDK。

注意：如果您在应用中构建了自定义设备选择器，则需要显式调用 GCKDiscoveryManager 类中的 startDiscovery 方法来启动设备发现。从 Cast SDK 的 v4.5.0 版本开始，默认情况下，系统会停用自动扫描功能。
将 NSBonjourServices 添加到 Info.plist
在 Info.plist 中指定 NSBonjourServices，以允许在 iOS 14 上成功进行本地网络发现。

您需要同时添加 _googlecast._tcp 和 _<your-app-id>._googlecast._tcp 作为服务，设备发现功能才能正常运行。

appID 是您的 receiverID，与 GCKDiscoveryCriteria 中定义的 ID 相同。

更新以下示例 NSBonjourServices 定义，并将“ABCD1234”替换为您的 appID。
```
<key>NSBonjourServices</key>
<array>
  <string>_googlecast._tcp</string>
  <string>_ABCD1234._googlecast._tcp</string>
</array>
```
将 NSLocalNetworkUsageDescription 添加到您的 Info.plist
我们强烈建议您通过在应用的 Info.plist 文件中为 NSLocalNetworkUsageDescription 添加应用专用的权限字符串来自定义本地网络提示中显示的消息，例如描述 Cast 发现和其他发现服务（如 DIAL）。
```
<key>NSLocalNetworkUsageDescription</key>
<string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
network.</string>
```
此消息将显示在 iOS 本地网络访问权限对话框中，如模拟所示。
重新向 Apple App Store 发布应用
我们建议您尽快使用 4.8.3 重新发布应用。

自定义

启动 Cast 设备发现

默认情况下，当用户首次点按“投放”按钮 (GCKUICastButton) 时，系统会启动 Cast 设备发现。如果用户在升级到 iOS 14 后首次尝试在本地网络上使用 Cast 应用，系统会显示新的 LNA 插页式广告，然后显示 iOS 本地网络访问权限对话框。

现在提供了一个新标志，可让您控制设备发现何时开始以及用户体验中某些元素的行为：

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

默认值为 true。此标志仅在标志 GCKCastOptions::disableDiscoveryAutostart 设置为 false 时适用。

如果设置为 true，当用户首次点按 GCKUICastButton 时，系统会开始发现 Cast 设备。系统会向用户显示一条信息性消息，告知他们为何需要本地网络权限。在该消息之后，系统会显示 iOS 14 LNA 消息。确认消息后，系统会开始发现投放设备。

在后续的应用启动中，GCKUICastButton 始终显示。

如果设置为 false，设备发现将根据标志 GCKCastOptions::disableDiscoveryAutostart 的值开始。

常见问题解答

如果我使用 Cast SDK v4.4.8 和 Xcode 12 重新发布 Cast 发送端应用，会发生什么情况？

除非您已从 Apple 获得网络多播授权，否则您的应用可能无法发现本地网络上的 Cast 设备。请注意，Apple 不会仅出于支持 Cast 的目的而授予多播授权。 如果您计划使用 Xcode 12 进行构建，则应使用 Cast 4.6.0 发布应用。

如果我使用新的 Cast SDK 重新发布应用，那么使用 iOS 13 或更低版本的用户会有什么体验？

他们将继续获得与重新发布应用之前相同的用户体验。面向用户的变更仅限于运行 iOS 14 的用户。

新版 Cast SDK 发布后，我需要做些什么来更新应用？

更新应用的 Info.plist，以包含本地网络使用情况说明。
将 NSBonjourServices 添加到应用的 Info.plist 中，并提供 Cast 和应用 ID 的 Bonjour 服务名称。
将发送端应用升级为使用 Cast SDK 4.6.0。
将应用重新发布到 Apple 应用商店。

升级到 4.6.0 后，为什么设备不再显示在我的自定义设备选择器中？

这是一个已知问题，如果您使用的是自定义设备选择器而不是标准设备选择器，则可能会出现此问题。在 Cast SDK 的 4.4.8 版及更低版本中，设备扫描是自动进行的。从版本 4.6.0 开始，您需要明确调用 GCKDiscoveryManager 类中的 startDiscovery 方法来启动设备发现。

此项变更的原因是，本地网络访问 (LNA) 权限提示会在应用首次扫描后显示。这可能会导致权限对话框随机出现在应用中的各个位置。

如果开发者为其应用构建自定义设备选择器，则需要在 iOS 14 中首次启动设备扫描之前提供一次性插页式广告。

iOS 13

在 iOS 13 中，引入了新的权限要求，这会影响使用 Google Cast SDK 的应用。

从 Google Cast SDK v4.4.3 开始，我们提供了一个不需要 Bluetooth® 权限的额外 SDK。您可以在开发者网站和新的 google-cast-sdk-no-bluetooth Cocoapods 上找到此功能。

应用细分

下面是根据您目前使用的 iOS SDK 版本提供的细分信息：

使用 iOS 12 SDK 或更低版本构建的应用

建议采取行动。在 iOS 13 上运行时，设备发现性能可能会下降，但仍可正常运行。我们强烈建议开发者在 Cast SDK v4.4.4 可用时升级到该版本。
iOS 13 会提示用户向应用授予蓝牙® 权限。

使用 iOS 13 SDK 构建的应用

请采取行动：更新到 Cast SDK 4.4.4，否则如果用户未授予位置信息权限，则可能不会显示投屏按钮。必须升级到 Cast SDK 4.4.4，才能确保在 iOS 13 上获得可靠的投屏体验。

隐私权

集成 Cast