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
-
- 返回
如果频道已被移除，则为 - ；如果频道未被移除，是因为给定的频道之前未附加，则为
NO。YES
| - (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 |
|
|
|
退出当前应用。
- 返回
如果消息无法发送，则为 NO。
| - (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，只要接收器应用继续运行，该 ID 就会一直有效。
接收器应用当前在接收器上运行的元数据（如果有）；否则为 nil。
| - (NSString*) applicationStatusText |
|
readnonatomiccopy |
当前正在运行的接收器应用最近报告的状态文本（如果有）；否则为 nil。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eGCKDeviceManager\u003c/code\u003e is a deprecated class previously used for controlling Cast devices and their applications.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should now utilize \u003ccode\u003eGCKSessionManager\u003c/code\u003e and \u003ccode\u003eGCKCastSession\u003c/code\u003e for Cast interactions.\u003c/p\u003e\n"],["\u003cp\u003eThe class provided methods for launching/stopping applications, managing connections, and adjusting device settings like volume.\u003c/p\u003e\n"],["\u003cp\u003eIt exposed properties reflecting device status, connection state, and application information.\u003c/p\u003e\n"],["\u003cp\u003eAlthough deprecated, understanding \u003ccode\u003eGCKDeviceManager\u003c/code\u003e can be helpful for comprehending the evolution of the Google Cast SDK.\u003c/p\u003e\n"]]],[],null,[]]
