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 和/或其關聯企業的註冊商標。
上次更新時間:2023-12-02 (世界標準時間)。
[null,null,["上次更新時間:2023-12-02 (世界標準時間)。"],[[["`GCKSession` is an abstract base class representing a session with a receiver device, requiring subclasses to implement `start` and `endWithAction` methods."],["Subclasses must also call specific notifier methods to indicate changes in the session state and can implement methods for device volume, mute state, and remote media client if supported by the device."],["Sessions are created and managed by `GCKSessionManager`, which utilizes `GCKDeviceProvider` for device discovery and delegates session requests to the `GCKSession` object."],["Key properties of `GCKSession` include the associated device, session ID, connection state, device status, and optional remote media client for controlling media playback."],["Subclasses like `GCKCastSession` inherit from `GCKSession` and provide concrete implementations for specific Cast sessions."]]],[]]