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 之後的某一天，必然需要 1.
| - (void) disconnectWithLeave: |
|
(BOOL) |
leaveApplication |
|
中斷與裝置的連線。
在呼叫 connect 之後的某一天，必然需要 1.
- 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；如果指定的頻道先前未附加，因此不會遭到移除。
| - (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。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2022-12-05 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
