GCKCastOptions 类
影响 Cast 设备发现和 Cast 会话行为的选项。
必须先设置可写属性，然后再将此对象传递给 GCKCastContext。
- 开始时间
- 3.0
继承 NSObject、<NSCopy> 和 <NSSecureCoding>。
使用指定的发现条件构造新的 GCKCastOptions 对象。
- Parameters
-
| discoveryCriteria | The discovery criteria to apply to discovered Cast devices. Only those devices that satisfy the criteria will be made available to the application. |
- 开始时间
- 4.0
| - (instancetype) initWithReceiverApplicationID: |
|
(NSString *) |
applicationID |
|
使用指定的接收器应用 ID 构造一个新的 GCKCastOptions 对象。
- Parameters
-
| applicationID | The ID of the receiver application which must be supported by discovered Cast devices, and which will be launched when starting a new Cast session. |
- Deprecated:
- 使用 initWithDiscoveryCriteria:
| - (instancetype) initWithSupportedNamespaces: |
|
(NSArray< NSString * > *) |
namespaces |
|
使用指定的命名空间列表构造新的 GCKCastOptions 对象。
- Parameters
-
| namespaces | A list of namespaces which must be supported by the currently running receiver application on each discovered Cast device. |
- Deprecated:
- 使用 initWithDiscoveryCriteria:
| - (BOOL) physicalVolumeButtonsWillControlDeviceVolume |
|
readwritenonatomicassign |
一个标记，指示发送方设备的物理音量按钮是否应控制会话的音量。
| - (BOOL) disableDiscoveryAutostart |
|
readwritenonatomicassign |
| - (BOOL) disableAnalyticsLogging |
|
readwritenonatomicassign |
该标志用于停用或启用诊断数据收集，以提高 Cast 设备发现的可靠性。
默认值为 NO（已启用）；可通过将该值设置为 YES 将其停用。
- 开始时间
- 4.0
| - (NSString*) sharedContainerIdentifier |
|
readwritenonatomiccopy |
共享容器标识符，用于由框架执行的后台 HTTP 下载。
- 开始时间
- 3.2
| - (BOOL) suspendSessionsWhenBackgrounded |
|
readwritenonatomicassign |
是否应在发送者应用进入后台时暂停会话（并在返回前台时恢复会话）。
默认情况下，此选项设置为 YES。对于能够在后台无限期保持网络连接的应用，最好将此项设为 NO。
- 开始时间
- 3.4
| - (BOOL) stopReceiverApplicationWhenEndingSession |
|
readwritenonatomicassign |
在用户通过“停止投放”按钮结束会话时，是否应终止接收端应用。
默认情况下，此选项设置为 NO。
- 开始时间
- 4.0
| - (BOOL) startDiscoveryAfterFirstTapOnCastButton |
|
readwritenonatomicassign |
指定是否仅在用户首次点按 GCKUICastButton 后启动投放设备发现。
如果设为 YES，GCKUICastButton 会一直显示，直到用户首次点按投射按钮。第一次点按时，系统会显示一个插页，说明需要获得本地网络访问权限才能投放正常运行的原因。用户关闭插页式广告后，发现广告便会开始。仅当设备连接到 Wi-Fi 网络时，“投放”按钮才会再次显示。无 Wi-Fi 网络连接时，“投射”按钮会隐藏。如果设置为 NO，则根据 disableDiscoveryAutoStart 标志启动发现。仅当 disableDiscoveryAutoStart 标记设为 NO 时，此标记仅在 iOS 14 及更高版本上生效。默认值为 YES。
- 开始时间
- 4.5.3
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2023-12-02。
[null,null,["最后更新时间 (UTC)：2023-12-02。"],[[["GCKCastOptions manages the discovery of Cast devices and Cast session behavior, with writable properties needing configuration before use."],["It offers various options, including controlling session volume with device buttons, managing discovery timing, and handling session suspension and receiver application termination."],["Developers can specify discovery criteria, receiver application ID, and supported namespaces to refine the Cast device selection process."],["GCKCastOptions also allows customization of launch options, background downloads, and the behavior of the Cast button on iOS 14 and above."],["It's worth noting that some initialization methods using receiver application ID or supported namespaces are deprecated in favor of using discovery criteria for more flexibility."]]],["The GCKCastOptions class configures Cast device discovery and session behavior. Key actions include: constructing options with discovery criteria, receiver application ID, or namespaces; setting flags to control session volume with physical buttons, manage discovery autostart, enable/disable diagnostic data collection, and suspend sessions when backgrounded. It also specifies receiver launch options, shared container identifiers, terminating the receiver app on session end, and initiating device discovery on the first Cast button tap. These writable properties must be configured prior to use.\n"]]
