GCKCastSession 類別
繼承 GCKSession。
| - (instancetype) initWithDevice: |
|
(GCKDevice *) |
device |
| sessionID: |
|
(nullable NSString *) |
sessionID |
| sessionOptions: |
|
(nullable GCKSessionOptions *) |
sessionOptions |
| castOptions: |
|
(GCKCastOptions *) |
castOptions |
|
|
| |
使用指定的投放選項建構新的投放工作階段。
- Parameters
-
| device | The receiver device. |
| sessionID | The session ID, if resuming; otherwise nil. |
| sessionOptions | The session options, if any; otherwise nil. |
| castOptions | The Cast options. |
- 開始時間
- 4.0
以工作階段註冊頻道。
如果工作階段已連線，且接收器應用程式支援頻道的命名空間，則系統會自動連結管道。如果工作階段未連線，頻道會處於中斷連線狀態，直到工作階段開始為止。
- Parameters
-
| channel | The channel to register. |
- 傳回
YES 如果頻道註冊成功，則設為 NO。
從工作階段中移除之前註冊的頻道。
- Parameters
-
| channel | The channel to unregister. |
- 傳回
YES如果頻道已成功取消註冊，則NO否則。
在多可用區群組中設定個別裝置的音量。
這是非同步作業。
- Parameters
-
| volume | The new volume, in the range [0.0, 1.0]. |
| device | The multizone device. |
- 傳回
- 用於追蹤要求的 GCKRequest 物件。
在多區域群組中設定個別裝置的靜音狀態。
這是非同步作業。
- Parameters
-
| muted | The new muted state. |
| device | The multizone device. |
- 傳回
- 用於追蹤要求的 GCKRequest 物件。
| - (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 |
|
| - (GCKActiveInputStatus) activeInputStatus |
|
readnonatomicassign |
| - (GCKStandbyStatus) standbyStatus |
|
readnonatomicassign |
目前在接收端裝置上執行的接收器應用程式中繼資料 (如果有的話)；否則為 nil。
|
|
readnonatomicstronginherited |
|
|
readnonatomiccopyinherited |
| - (GCKSessionOptions*) sessionOptions |
|
readnonatomicstronginherited |
| - (GCKConnectionState) connectionState |
|
readnonatomicassigninherited |
|
|
readnonatomicassigninherited |
| - (NSString*) deviceStatusText |
|
readnonatomiccopyinherited |
|
|
readnonatomiccopyinherited |
| - (float) currentDeviceVolume |
|
readnonatomicassigninherited |
| - (BOOL) currentDeviceMuted |
|
readnonatomicassigninherited |
|
|
readnonatomicstronginherited |
|
|
readnonatomicstronginherited |
目前的媒體中繼資料 (如果有的話)。
如果工作階段不支援媒體命名空間，或是目前接收器上未載入任何媒體，則為 nil。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2023-12-02 (世界標準時間)。
[null,null,["上次更新時間：2023-12-02 (世界標準時間)。"],[[["`GCKCastSession` manages a Cast session and its lifecycle, including channels, device status, and volume control, but applications should avoid directly managing the session's start and end."],["`GCKCastSession` provides properties for accessing session status, device information (like volume and mute state), and media control via `remoteMediaClient`."],["`GCKSession` is an abstract base class for Cast sessions, requiring subclasses to implement session start/end logic and provides properties for session status, device details, and media information."],["Subclasses of `GCKSession` use protected methods to notify the framework about session lifecycle events like start, end, errors, and device status changes."]]],[]]
