GCKSession 類別
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
繼承 NSObject。
由 GCKCastSession 繼承。
| - (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
| traits: |
|
(nullable GCKSessionTraits *) |
traits |
| sessionID: |
|
(nullable NSString *) |
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. |
| - (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
| traits: |
|
(nullable GCKSessionTraits *) |
traits |
| sessionID: |
|
(nullable NSString *) |
sessionID |
| sessionOptions: |
|
(nullable GCKSessionOptions *) |
sessionOptions |
|
|
| |
初始化指定裝置的新工作階段物件。
- 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. |
| sessionOptions | The session options, if any; otherwise nil. |
- 開始時間
- 4.0
設定裝置音量。
這是非同步作業。預設實作為免人工管理，會導致要求失敗，並顯示 GCKErrorCodeUnsupportedFeature 錯誤。
- Parameters
-
- 傳回
- 用於追蹤要求的 GCKRequest 物件。
- 開始時間
- 3.4；在先前的架構版本中，這個方法傳回了
void。
設定裝置的靜音狀態。
這是非同步作業。預設實作為免人工管理，會導致要求失敗，並顯示 GCKErrorCodeUnsupportedFeature 錯誤。
- Parameters
-
- 傳回
- 用於追蹤要求的 GCKRequest 物件。
- 開始時間
- 3.4；在先前的架構版本中，這個方法傳回了
void。
結束包含指定動作的工作階段。
這是非同步作業。必須由子類別覆寫。
- Parameters
-
| action | The action to take when ending the session; see GCKSessionEndAction for more details. |
由「GCKSession(Protected)」類別提供。
| - (void) notifyDidStartWithSessionID: |
|
(NSString *) |
sessionID |
|
| - (void) notifyDidFailToStartWithError: |
|
(GCKError *) |
error |
|
| - (void) notifyDidEndWithError: |
|
(nullable NSError *) |
error |
| willTryToResume: |
|
(BOOL) |
willTryToResume |
|
|
| |
子類別會呼叫以通知架構，說明工作階段已結束。
- Parameters
-
| error | The error that caused the session to end, if any. Should be nil if the session was ended intentionally. |
| willTryToResume | Whether the session will try to resume itself automatically. |
由「GCKSession(Protected)」類別提供。
| - (void) notifyDidReceiveDeviceVolume: |
|
(float) |
volume |
| muted: |
|
(BOOL) |
muted |
|
|
| |
子類別會呼叫此 API，通知架構已收到裝置傳來的更新音量和靜音狀態。
- 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: |
|
(nullable NSString *) |
statusText |
|
| - (GCKSessionOptions*) sessionOptions |
|
readnonatomicstrong |
| - (GCKConnectionState) connectionState |
|
readnonatomicassign |
| - (NSString*) deviceStatusText |
|
readnonatomiccopy |
| - (float) currentDeviceVolume |
|
readnonatomicassign |
| - (BOOL) currentDeviceMuted |
|
readnonatomicassign |
目前的媒體中繼資料 (如果有的話)。
如果工作階段不支援媒體命名空間，或是目前接收器上未載入任何媒體，則為 nil。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-25 (世界標準時間)。"],[],["The GCKSession class represents a session with a receiver device, requiring subclasses to implement `start` and `endWithAction:` methods. Subclasses must also use methods like `notifyDidStartWithSessionID:` to communicate state changes. Optional methods like `setDeviceVolume:`, `setDeviceMuted:`, and `remoteMediaClient` are available for supported devices. Sessions are managed by `GCKSessionManager`, which uses `GCKDeviceProvider` to create them and delegates requests to `GCKSession`. Key properties include `device`, `sessionID`, and connection state, with methods to initialize, set device volume/mute state, start/end a session, and notify the framework of session status changes.\n"]]
