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."]]],[]]