GCKCastSession 类
继承 GCKSession。
- (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
sessionID: |
|
(NSString *__nullable) |
sessionID |
castOptions: |
|
(GCKCastOptions *) |
castOptions |
|
|
| |
指定的初始化程序。
使用给定的 Cast 选项构造新的 Cast 会话。
- Parameters
-
device | The receiver device. |
sessionID | The session ID, if resuming; otherwise nil . |
castOptions | The Cast options. |
向会话注册频道。
如果会话已连接,且接收方应用支持该频道的命名空间,则该通道将自动连接。如果会话未连接,则渠道将保持断开连接状态,直到会话开始。
- Parameters
-
channel | The channel to register. |
- 返回
- 如果渠道注册成功,则为
YES
;否则为 NO
。
从会话中移除以前注册的频道。
- Parameters
-
channel | The channel to unregister. |
- 返回
- 如果频道取消注册成功,则为
YES
;否则为 NO
。
在多可用区组中设置单个设备的音量。
这是一项异步操作。
- Parameters
-
volume | The new volume, in the range [0.0, 1.0]. |
device | The multizone device. |
- 返回
- 一个用于跟踪请求的 GCKRequest 对象。
在多可用区组中设置个别设备的静音状态。
这是一项异步操作。
- Parameters
-
muted | The new muted state. |
device | The multizone device. |
- 返回
- 一个用于跟踪请求的 GCKRequest 对象。
- (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
traits: |
|
(GCKSessionTraits *) |
traits |
sessionID: |
|
(NSString *__nullable) |
sessionID |
|
|
| |
为指定设备初始化新的会话对象。
- Parameters
-
device | The device. |
traits | The session traits. |
sessionID | The session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session. |
设置设备的音量。
这是一项异步操作。默认实现是一个空操作,该操作会使请求失败并显示 GCKErrorCodeUnsupportedFeature 错误。
- Parameters
-
- 返回
- 一个用于跟踪请求的 GCKRequest 对象。
- 开始时间
- 3.4;在之前的框架版本中,此方法返回
void
。
设置设备的静音状态。
这是一项异步操作。默认实现是一个空操作,该操作会使请求失败并显示 GCKErrorCodeUnsupportedFeature 错误。
- Parameters
-
- 返回
- 一个用于跟踪请求的 GCKRequest 对象。
- 开始时间
- 3.4;在之前的框架版本中,此方法返回
void
。
- (void) endAndStopCasting: |
|
(BOOL) |
stopCasting |
|
结束会话。
这是一项异步操作。必须被子类替换。
- Parameters
-
stopCasting | Whether to stop casting content to the receiver. |
由“GCKSession(Protected)”类别提供。
- (void) notifyDidStartWithSessionID: |
|
(NSString *) |
sessionID |
|
- (void) notifyDidFailToStartWithError: |
|
(NSError *) |
error |
|
- (void) notifyDidEndWithError: |
|
(NSError *__nullable) |
error |
|
由子类调用,以通知框架会话已结束。
- Parameters
-
error | The error that caused the session to end, if any. Should be nil if the session was ended intentionally. |
由“GCKSession(Protected)”类别提供。
- (void) notifyDidReceiveDeviceVolume: |
|
(float) |
volume |
muted: |
|
(BOOL) |
muted |
|
|
| |
由子类调用,以通知框架已从设备收到更新后的设备音量和静音状态。
- Parameters
-
volume | The device's current volume. Must be in the range [0, 1.0]; |
muted | The device's current mute state. |
由“GCKSession(Protected)”类别提供。
- (void) notifyDidReceiveDeviceStatus: |
|
(NSString *__nullable) |
statusText |
|
当前在接收端设备上运行的接收端应用的元数据(如果有);否则为 nil
。
|
readnonatomicstronginherited |
|
readnonatomiccopyinherited |
|
readnonatomicassigninherited |
|
readnonatomicassigninherited |
- (NSString*) deviceStatusText |
|
readnonatomiccopyinherited |
|
readnonatomiccopyinherited |
- (float) currentDeviceVolume |
|
readnonatomicassigninherited |
- (BOOL) currentDeviceMuted |
|
readnonatomicassigninherited |
|
readnonatomicstronginherited |
|
readnonatomicstronginherited |
当前媒体元数据(如果有)。
如果会话不支持媒体命名空间或接收器上当前未加载任何媒体,则值为 nil
。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2023-12-02。
[null,null,["最后更新时间 (UTC):2023-12-02。"],[[["The `GCKCastSession` class manages interactions between your application and a Cast receiver device, including channels, device status, and volume control."],["`GCKSessionManager` automatically handles session lifecycle, so avoid directly using methods like `start` or `endAndStopCasting` in your application."],["Subclasses of `GCKCastSession` should override lifecycle methods (`start`, `endAndStopCasting`, `suspendWithReason`, `resume`) and use notification methods to inform the framework of session state changes."],["`GCKSession` provides protected methods and properties for subclass use to manage session state, device status, and media control, ensuring proper communication with the framework."]]],[]]