GCKDeviceManager 类
此类继承 NSObject。
| - (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
| clientPackageName: |
|
(NSString *) |
clientPackageName |
|
|
| |
使用给定设备构造新的 GCKDeviceManager。
此对象将监听应用状态通知，并且在应用进入后台时自动断开与设备的连接，并在应用返回前台时尝试重新连接设备。
- Parameters
-
| device | The device to control. |
| clientPackageName | The client package name. |
| - (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
| clientPackageName: |
|
(NSString *) |
clientPackageName |
| ignoreAppStateNotifications: |
|
(BOOL) |
ignoreAppStateNotifications |
|
|
| |
指定的初始化程序。
构造用于控制给定设备的新 GCKDeviceManager。
如果 ignoreAppStateNotifications 为 NO，该对象将监听应用状态的变化，并在应用进入后台时自动断开与设备的连接，并在应用返回前台时尝试重新连接设备。
如果 ignoreAppStateNotifications 为 YES，则对象不会监听这些通知，并且由应用负责管理连接生命周期。请注意，后台 iOS 应用通常无法无限期地运行，而且其活动网络连接最终将由操作系统关闭。
- Parameters
-
| device | The device to control. |
| clientPackageName | The client package name. |
| ignoreAppStateNotifications | Whether this object will ignore app state notifications. |
断开与设备的连接。
这是明显的中断。
必须在调用 connect 之后以及其所有者释放此对象之前的某个时间点调用某个断开连接方法。
| - (void) disconnectWithLeave: |
|
(BOOL) |
leaveApplication |
|
断开与设备的连接。
必须在调用 connect 之后以及其所有者释放此对象之前的某个时间点调用某个断开连接方法。
- Parameters
-
| leaveApplication | YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection. |
添加一个渠道，以便在特定命名空间中发送和接收此设备的消息。
- Parameters
-
- 返回
- 如果频道已添加，则设为
YES；如果频道未添加此频道，则添加 NO 表示此命名空间。
移除之前添加的频道。
- Parameters
-
- 返回
如果频道已移除，则为 YES；如果频道未曾被移除，则为 NO。
| - (NSInteger) launchApplication: |
|
(NSString *) |
applicationID |
|
使用给定的启动选项启动应用。
- Parameters
-
| applicationID | The application ID. |
| launchOptions | The launch options for this request. If nil, defaults will be used. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (NSInteger) launchApplication: |
|
(NSString *) |
applicationID |
| relaunchIfRunning: |
|
(BOOL) |
relaunchIfRunning |
|
|
| |
| - (NSInteger) joinApplication: |
|
(NSString *__nullable) |
applicationID |
|
加入应用。
- Parameters
-
| applicationID | The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (NSInteger) joinApplication: |
|
(NSString *) |
applicationID |
| sessionID: |
|
(NSString *) |
sessionID |
|
|
| |
联接具有特定应用会话 ID 的应用。
如果接收设备上的指定会话 ID 不再活动，则请求将失败。
- Parameters
-
| applicationID | The application ID. |
| sessionID | The application session ID. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (BOOL) leaveApplication |
|
|
|
| - (NSInteger) stopApplication |
|
|
|
| - (NSInteger) stopApplicationWithSessionID: |
|
(NSString *__nullable) |
sessionID |
|
停止具有指定应用会话 ID 的应用。
如果接收设备上的指定会话 ID 不再活动，则请求将失败。
- Parameters
-
| sessionID | The application session ID, which may not be nil. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (NSInteger) setVolume: |
|
(float) |
volume |
|
设置系统音量。
- Parameters
-
| volume | The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (NSInteger) setMuted: |
|
(BOOL) |
muted |
|
开启或关闭静音功能。
- Parameters
-
| muted | Whether audio should be muted or unmuted. |
- 返回
- 请求 ID，如果请求无法发送，则为 kGCKInvalidRequestID。
| - (NSInteger) requestDeviceStatus |
|
|
|
| - (BOOL) ignoreAppStateNotifications |
|
readnonatomicassign |
此对象是否会监听应用状态通知。
可以在初始化程序中指定此标记。默认值为 NO。
| - (BOOL) isConnectedToApp |
|
readnonatomicassign |
如果设备管理器由于暂时性事件（例如，应用在后台运行或存在可能通过重新连接解决的网络错误）而断开连接，则为 true。
请注意，当设备管理器尝试在发生可能暂时发生的事件后重新连接时，系统不会调用断开连接/连接回调，但这些属性将始终反映实际的当前状态，并且可以被观察到。
| - (NSTimeInterval) reconnectTimeout |
|
readwritenonatomicassign |
如果套接字连接由于暂时性错误而断开连接，系统会尝试重新连接此时长。
默认超时时间为 15 秒。
设备的当前音量（如果已知，范围为 [0.0, 1.0]）；否则为 0。
| - (NSString*) applicationSessionID |
|
readnonatomiccopy |
当前连接的接收器应用的应用会话 ID（如有）；否则为 nil。
每当接收器应用（包括同一应用重新启动）时，系统都会生成一个唯一的唯一会话 ID，只要接收器应用继续运行，它就会一直有效。
当前在接收器上运行的接收器应用的元数据（如果有）；否则为 nil。
| - (NSString*) applicationStatusText |
|
readnonatomiccopy |
当前正在运行的接收器应用最近报告的状态文本（如果有）；否则为 nil。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2022-12-05。
[null,null,["最后更新时间 (UTC)：2022-12-05。"],[[["`GCKDeviceManager` is a deprecated class previously used for controlling Cast devices and their applications."],["Developers should now utilize `GCKSessionManager` and `GCKCastSession` for Cast interactions."],["The class provided methods for launching/stopping applications, managing connections, and adjusting device settings like volume."],["It exposed properties reflecting device status, connection state, and application information."],["Although deprecated, understanding `GCKDeviceManager` can be helpful for comprehending the evolution of the Google Cast SDK."]]],[]]
