GCKCastOptions 类

GCKCastOptions 类参考

概览

影响 Cast 设备发现和 Cast 会话行为的选项。

必须先设置可写属性,然后再将此对象传递给 GCKCastContext

开始时间
3.0

继承 NSObject、<NSCopy> 和 <NSSecureCoding>。

实例方法摘要

(instancetype) - initWithDiscoveryCriteria:
 使用指定的发现条件构造新的 GCKCastOptions 对象。更多...
 
(instancetype) - initWithReceiverApplicationID:
 使用指定的接收器应用 ID 构造一个新的 GCKCastOptions 对象。更多...
 
(instancetype) - initWithSupportedNamespaces:
 使用指定的命名空间列表构造新的 GCKCastOptions 对象。更多...
 

属性摘要

BOOL physicalVolumeButtonsWillControlDeviceVolume
 一个标记,指示发送方设备的物理音量按钮是否应控制会话的音量。更多...
 
BOOL disableDiscoveryAutostart
 一个标志,用于指明在上下文初始化时是否应自动启动 Cast 设备发现。更多...
 
BOOL disableAnalyticsLogging
 该标志用于停用或启用诊断数据收集,以提高 Cast 设备发现的可靠性。更多...
 
GCKLaunchOptionslaunchOptions
 接收器启动 Cast 会话时使用的启动选项。更多...
 
NSString * sharedContainerIdentifier
 共享容器标识符,用于由框架执行的后台 HTTP 下载。更多...
 
BOOL suspendSessionsWhenBackgrounded
 是否应在发送者应用进入后台时暂停会话(并在返回前台时恢复会话)。更多...
 
BOOL stopReceiverApplicationWhenEndingSession
 在用户通过“停止投放”按钮结束会话时,是否应终止接收端应用。更多...
 
BOOL startDiscoveryAfterFirstTapOnCastButton
 指定是否仅在用户首次点按 GCKUICastButton 后启动投放设备发现。更多...
 

方法详细信息

- (instancetype) initWithDiscoveryCriteria: (GCKDiscoveryCriteria *)  discoveryCriteria

使用指定的发现条件构造新的 GCKCastOptions 对象。

Parameters
discoveryCriteriaThe 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
applicationIDThe 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
namespacesA 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

一个标志,用于指明在上下文初始化时是否应自动启动 Cast 设备发现。

如果设置为 NO,则可以使用 startDiscovery (GCKDiscoveryManager)stopDiscovery (GCKDiscoveryManager) 方法按需启动和停止发现。默认情况下,此选项设置为 NO

开始时间
3.4
- (BOOL) disableAnalyticsLogging
readwritenonatomicassign

该标志用于停用或启用诊断数据收集,以提高 Cast 设备发现的可靠性。

默认值为 NO(已启用);可通过将该值设置为 YES 将其停用。

开始时间
4.0
- (GCKLaunchOptions*) launchOptions
readwritenonatomiccopy

接收器启动 Cast 会话时使用的启动选项。

- (NSString*) sharedContainerIdentifier
readwritenonatomiccopy

共享容器标识符,用于由框架执行的后台 HTTP 下载。

开始时间
3.2
- (BOOL) suspendSessionsWhenBackgrounded
readwritenonatomicassign

是否应在发送者应用进入后台时暂停会话(并在返回前台时恢复会话)。

默认情况下,此选项设置为 YES。对于能够在后台无限期保持网络连接的应用,最好将此项设为 NO

开始时间
3.4
- (BOOL) stopReceiverApplicationWhenEndingSession
readwritenonatomicassign

在用户通过“停止投放”按钮结束会话时,是否应终止接收端应用。

默认情况下,此选项设置为 NO

开始时间
4.0
- (BOOL) startDiscoveryAfterFirstTapOnCastButton
readwritenonatomicassign

指定是否仅在用户首次点按 GCKUICastButton 后启动投放设备发现。

如果设为 YESGCKUICastButton 会一直显示,直到用户首次点按投射按钮。第一次点按时,系统会显示一个插页,说明需要获得本地网络访问权限才能投放正常运行的原因。用户关闭插页式广告后,发现广告便会开始。仅当设备连接到 Wi-Fi 网络时,“投放”按钮才会再次显示。无 Wi-Fi 网络连接时,“投射”按钮会隐藏。如果设置为 NO,则根据 disableDiscoveryAutoStart 标志启动发现。仅当 disableDiscoveryAutoStart 标记设为 NO 时,此标记仅在 iOS 14 及更高版本上生效。默认值为 YES

开始时间
4.5.3