cast. 架構。 訊息
這是 cast.framework.messages
命名空間。
類別
AudiobookChapterMediaMetadata
有聲書章節說明。
AudiobookContainerMetadata
有聲書容器說明。
AudioTrackInfo
說明音軌的音軌資訊。
休息時間
代表主要影片中的廣告插播 (例如廣告插播)。
BreakClip
代表廣告插播短片 (例如廣告插播期間廣告片段)
BreakStatus
代表廣告插播狀態。
CloudMediaStatus
僅傳送給雲端寄件者的 MediaStatus
,例如 Google 助理。
ContainerMetadata
QueueData
中使用的常見容器中繼資料。
ContentRating
內容分級 (家長分級、心智成熟度分級)。
CustomCommandRequestData
CustomCommand
要求資料。
DisplayStatusRequestData
DisplayStatusRequest
資料。
EditAudioTracksRequestData
媒體事件 EDIT_AUDIO_TRACKS 要求資料。如未提供語言,系統會啟用媒體的預設音軌。
EditTracksInfoRequestData
媒體事件 EDIT_TRACKS_INFO 要求資料。
ErrorData
代表錯誤資訊。
ExtendedMediaStatus
其他媒體狀態資訊
FetchItemsRequestData
擷取項目要求資料。
FocusStateRequestData
將焦點移至狀態變更訊息。
GenericMediaMetadata
一般媒體說明。
GetItemsInfoRequestData
取得商品資訊要求資料。
GetStatusRequestData
媒體事件 GET_STATUS 要求資料。
Image
描述接收器應用程式或媒體項目的圖片。可以是應用程式圖示、封面圖片或縮圖。
ItemsInfo
代表資料訊息,其中包含每個要求 ID 的項目資訊。
LiveSeekableRange
提供即時搜尋範圍 (以秒為單位)。
LoadByEntityRequestData
LoadByEntity
要求資料。
LoadOptions
為載入要求提供其他選項。
LoadRequestData
媒體事件 LOAD 要求資料。
MediaInformation
代表媒體資訊。
MediaMetadata
用於 MediaInformation
中的常見媒體中繼資料,或是將媒體區段描述為容器中繼資料的一部分。
MediaStatus
代表媒體工作階段的狀態。
MovieMediaMetadata
電影媒體說明。
MusicTrackMediaMetadata
音樂曲目的媒體說明。
PhotoMediaMetadata
相片媒體說明。
PrecacheRequestData
媒體事件 PRECACHE 要求資料。(載入要求的部分欄位 (例如 autoplay 和 queueData) 會遭到忽略。
PreloadRequestData
媒體事件 PRELOAD 要求資料。
QueueChange
代表佇列變更訊息,例如插入、移除和更新訊息。
QueueData
將資料排入 LOAD 要求的一部分。
QueueIds
代表包含完整佇列 ID 清單的資料訊息。
QueueInsertRequestData
媒體事件佇列 INSERT 要求資料。
QueueItem
佇列項目資訊。應用程式開發人員可能需要建立 QueueItem,使用 cast.framework.messages.InsertQueueItems 插入佇列元素。在這種情況下,他們不應提供 itemId (因為項目在佇列中插入時,會指派實際的 itemId)。這樣做可防止 ID 與從傳送者應用程式新增的項目發生衝突。
QueueLoadRequestData
媒體事件佇列 LOAD 要求資料。
QueueRemoveRequestData
媒體事件佇列 REMOVE 要求資料。
QueueReorderRequestData
媒體事件佇列 REORDER 要求資料。
QueueUpdateRequestData
媒體事件 UPDATE 佇列要求資料。
RefreshCredentialsRequestData
RefreshCredentials
要求資料。
RequestData
媒體事件要求資料。
ResumeSessionRequestData
RESUME_SESSION 要求資料
SeekableRange
提供可搜尋的範圍 (以秒為單位)。
SeekRequestData
媒體事件 SEEK 要求資料。
SessionState
狀態物件,包含所有要儲存在 StoreSession 中且要在 ResumeSession 中復原的資料狀態物件。
SetCredentialsRequestData
SetCredentials
要求資料。
SetPlaybackRateRequestData
媒體事件播放率要求資料。
StoreSessionRequestData
STORE_SESSION 要求資料
StoreSessionResponseData
STORE_SESSION 指令的回應資料。
TextTrackStyle
說明文字軌的樣式資訊。
追蹤
說明曲目中繼資料資訊。
TracksInfo
追蹤資訊。
TvShowMediaMetadata
電視劇集媒體說明。
UserActionRequestData
UserAction
要求資料。
UserActionState
代表媒體的使用者動作狀態。
VastAdsRequest
VAST 廣告請求設定。
VideoInformation
影片資訊,例如影片解析度和高動態範圍 (HDR)。
數量
代表媒體工作階段串流的音量。
VolumeRequestData
媒體事件 SET_VOLUME 要求資料。
列舉
CaptionMimeType
字串
文字軌的 MIME 類型字幕。
值 |
|
---|---|
CEA608 |
字串 CEA 608 |
TTML |
字串 TTML |
越南 |
字串 越南 |
TTML_MP4 |
字串 TTML MP4 |
指令
號碼
一系列位元遮罩值,用於設定或擷取應用程式支援的 cast.framework.messages.MediaStatus#supportedMediaCommands。
值 |
|
---|---|
暫停 |
號碼 暫停指令。 |
查看 |
號碼 搜尋指令。 |
STREAM_VOLUME |
號碼 串流磁碟區指令。 |
STREAM_MUTE |
號碼 串流磁碟區指令。 |
ALL_BASIC_MEDIA |
號碼 所有基本媒體。包含強制指令 |
QUEUE_NEXT |
號碼 將下一個指令加入佇列。 |
QUEUE_PREV |
號碼 佇列上一個指令。 |
QUEUE_SHUFFLE |
號碼 佇列重組指令。 |
QUEUE_REPEAT_ALL |
號碼 「佇列重複所有」模式。 |
QUEUE_REPEAT_ONE |
號碼 「佇列重複播放」模式。 |
QUEUE_REPEAT |
號碼 佇列重複模式。 |
SKIP_AD |
號碼 略過 AD 指令。 |
EDIT_TRACKS |
號碼 編輯追蹤指令。 |
PLAYBACK_RATE |
號碼 播放速率指令。 |
LIKE |
號碼 使用者動作,例如指令。 |
不喜歡 |
號碼 使用者動作與指令不同。 |
追蹤 |
號碼 使用者動作「追蹤」指令。 |
取消追蹤 |
號碼 使用者動作「Unfollow」指令。 |
STREAM_TRANSFER |
號碼 串流轉移指令。 |
歌詞 |
號碼 歌詞指令。 |
ContainerType
號碼
容器中繼資料類型。
值 |
|
---|---|
GENERIC_CONTAINER |
號碼 適用於大多數媒體類型的通用範本。由 cast.framework.messages.ContainerMetadata 使用。 |
AUDIOBOOK_CONTAINER |
號碼 有聲書的中繼資料。 由 cast.framework.messages.AudiobookContainerMetadata 使用。 |
- 另請參閱
- cast.framework.messages.QueueData.containerMetadata
ContentFilteringMode
字串
代表內容篩選模式。
值 |
|
---|---|
FILTER_EXPLICIT |
字串 請勿播放煽情露骨內容。 |
ErrorReason
字串
代表媒體錯誤訊息的原因。
值 |
|
---|---|
INVALID_COMMAND |
字串 在指令無效或未實作時傳回。 |
INVALID_PARAMS |
字串 當參數無效或缺少必要參數時,系統會傳回這個值。 |
INVALID_MEDIA_SESSION_ID |
字串 當媒體工作階段不存在時傳回。 |
SKIP_LIMIT_REACHED |
字串 因達到略過上限而無法略過更多項目時,系統會傳回這個值。 |
NOT_SUPPORTED |
字串 應用程式不支援要求時,系統會傳回這個值。 |
LANGUAGE_NOT_SUPPORTED |
字串 不支援要求的語言時,系統會傳回這個值。 |
END_OF_QUEUE |
字串 由於跳回第一個項目或快轉佇列中的最後一個項目之後,無法略過,就會傳回這個值。 |
DUPLICATE_REQUEST_ID |
字串 當要求 ID 不專屬時 (接收方正在處理具有相同 ID 的要求)。 |
VIDEO_DEVICE_REQUIRED |
字串 當要求無法完成,因為需要支援影片的裝置時,系統會傳回這個值。 |
PREMIUM_ACCOUNT_REQUIRED |
字串 要求成功需要付費帳戶時,系統會傳回這個值。 |
APP_ERROR |
字串 當應用程式狀態無效而無法完成要求時,系統會傳回這個結果。 |
AUTHENTICATION_EXPIRED |
字串 如果驗證已過期 (例如使用者變更密碼或權杖撤銷),導致無法執行要求,系統會傳回此錯誤。 |
CONCURRENT_STREAM_LIMIT |
字串 偵測到並行串流過多時,就會傳回這個結果。 |
PARENTAL_CONTROL_RESTRICTED |
字串 當內容因家長監護功能遭到封鎖時,系統會傳回這個值。 |
CONTENT_FILTERED |
字串 當內容因篩選條件而遭封鎖時,系統會傳回這個值。 |
NOT_AVAILABLE_IN_REGION |
字串 當內容因區域性無法使用而遭到封鎖時,系統會傳回這個值。 |
CONTENT_ALREADY_PLAYING |
字串 當要求的內容已播放時,系統會傳回這個值。 |
INVALID_REQUEST |
字串 當要求無效時傳回。 |
GENERIC_LOAD_ERROR |
字串 載入要求遇到間歇性問題時會傳回。 |
ErrorType
字串
代表媒體錯誤訊息類型。
值 |
|
---|---|
INVALID_PLAYER_STATE |
字串 當玩家狀態無效以完成要求時會傳回。 |
LOAD_FAILED |
字串 當 LOAD 要求失敗時,系統會傳回這個值。 |
LOAD_CANCELLED |
字串 第二次傳入的 LOAD 要求取消 LOAD 要求時,系統會傳回這個值。 |
INVALID_REQUEST |
字串 當要求無效時傳回。 |
錯誤 |
字串 其他任何錯誤情況的一般錯誤。 |
ExtendedPlayerState
字串
擴充玩家狀態資訊。
值 |
|
---|---|
載入中 |
字串 播放器處於載入中狀態。 |
FocusState
字串
聚焦狀態。
值 |
|
---|---|
IN_FOCUS |
字串 接收器是焦點。 |
NOT_IN_FOCUS |
字串 接收器未處於焦點,其他活動處於啟用狀態。 |
GetStatusOptions
號碼
GetStatusOptions
會決定必須在媒體狀態回應中包含 GET_STATUS
訊息的資料量。
值 |
|
---|---|
NO_METADATA |
號碼 請勿加入中繼資料旗標。 |
NO_QUEUE_ITEMS |
號碼 請勿加入佇列項目旗標。 |
HdrType
字串
代表影片高動態範圍 (HDR) 類型。
值 |
|
---|---|
標準動態範圍 |
字串 標準動態範圍。 |
高動態範圍 |
字串 高動態範圍。 |
多媒體和影片廣告 |
字串 Dolby Vision。 |
HlsSegmentFormat
字串
HTTP 即時串流音訊區段的格式。
值 |
|
---|---|
AAC |
字串 AAC 封裝音訊的基本串流。 |
AC3 |
字串 AC3 封裝音訊的基本串流。 |
MP3 |
字串 MP3 封裝音訊的基本串流。 |
疑難排解 |
字串 MPEG-2 傳輸串流。 |
TS_AAC |
字串 AAC 低複雜度封裝的 MPEG-2 傳輸串流 (AAC-LC)。 |
TS_HE_AAC |
字串 AAC 高效率的 MPEG-2 傳輸串流 (HE-AAC)。 |
E_AC3 |
字串 E-AC3 封裝音訊的基本串流。 |
FMP4 |
字串 封裝至 ISO BMFF CMAF 片段的 MP4 音訊。 |
HlsVideoSegmentFormat
字串
HTTP 即時串流影片片段的格式。
值 |
|
---|---|
MPEG2_TS |
字串 MPEG-2 傳輸串流。支援 AVC。 |
FMP4 |
字串 影片封裝在 ISO BMFF CMAF 片段的 MP4 中。支援 AVC 和 HEVC。 |
IdleReason
字串
玩家處於 IDLE 狀態的原因。
值 |
|
---|---|
CANCELLED |
字串 傳送者使用「STOP」指令要求停止播放。 |
INTERRUPTED |
字串 傳送者使用 LOAD 指令要求播放其他媒體。 |
完成 |
字串 媒體播放完畢。 |
錯誤 |
字串 媒體因錯誤而中斷,例如播放器因網路錯誤而無法下載媒體時,就有可能發生這種情況。 |
MediaCategory
字串
媒體類別。
值 |
|
---|---|
音軌 |
字串 僅播放音訊。 |
影片 |
字串 媒體為影片和音訊 (預設)。 |
圖片 |
字串 媒體是圖片。 |
MessageType
字串
代表 cast.framework.PlayerManager 攔截的媒體訊息類型。訊息類型可分為要求或外寄郵件。要求可讓應用程式修改任何資料,然後才交由 Web Receiver SDK 處理。傳出訊息可讓應用程式在訊息傳送至連線的系統和寄件者應用程式之前修改任何資料。
值 |
|
---|---|
MEDIA_STATUS |
字串 目前媒體狀態的傳出訊息。 訊息類型為:cast.framework.messages.MediaStatus。 |
CLOUD_STATUS |
字串 媒體狀態的外送訊息給雲端寄件者。 訊息類型為:cast.framework.messages.CloudMediaStatus。 |
QUEUE_CHANGE |
字串 佇列變更的外寄郵件。 訊息類型為 cast.framework.messages.QueueChange。 |
QUEUE_ITEMS |
字串 佇列項目資訊的傳出訊息。訊息類型為:cast.framework.messages.ItemsInfo。 |
QUEUE_ITEM_IDS |
字串 列出佇列 ID 清單的傳出訊息。訊息類型為 cast.framework.messages.QueueIds。 |
GET_STATUS |
字串 請求目前的媒體狀態。 訊息類型為:cast.framework.messages.GetStatusRequestData。 |
裝載 |
字串 要求載入媒體。訊息類型為 cast.framework.messages.LoadRequestData。 |
暫停 |
字串 要求暫停播放器。訊息類型為:cast.framework.messages.RequestData |
停止 |
字串 要求停止播放器。訊息類型為 cast.framework.messages.RequestData。 |
玩樂 |
字串 要求繼續播放。訊息類型為 cast.framework.messages.RequestData。 |
SKIP_AD |
字串 請求略過正在播放的廣告。 訊息類型為 cast.framework.messages.RequestData。 |
PLAY_AGAIN |
字串 要求再次播放目前的媒體。訊息類型為 cast.framework.messages.RequestData。 |
查看 |
字串 要求搜尋媒體。 訊息類型為 cast.framework.messages.SeekRequestData。 |
SET_PLAYBACK_RATE |
字串 要求變更播放速率。 訊息類型為 cast.framework.messages.SetPlaybackRateRequestData。 |
SET_VOLUME |
字串 要求變更目前的媒體音量。 訊息類型為 cast.framework.messages.VolumeRequestData。 |
EDIT_TRACKS_INFO |
字串 要求變更播放中的文字或音軌。訊息類型為:cast.framework.messages.EditTracksInfoRequestData。 |
EDIT_AUDIO_TRACKS |
字串 要求變更播放中的音軌。訊息類型為:cast.framework.messages.EditAudioTracksRequestData。 |
預先 |
字串 要求預先快取資料。訊息類型為 cast.framework.messages.PrecacheRequestData。 |
預先載入 |
字串 要求預先載入項目。訊息類型為 cast.framework.messages.PreloadRequestData。 |
QUEUE_LOAD |
字串 要求載入佇列。訊息類型為:cast.framework.messages.QueueLoadRequestData。 |
QUEUE_INSERT |
字串 要求插入佇列。訊息類型為:cast.framework.messages.QueueInsertRequestData。 |
QUEUE_UPDATE |
字串 要求更新佇列。 訊息類型為:cast.framework.messages.QueueUpdateRequestData。 |
QUEUE_REMOVE |
字串 要求從待播清單中移除。訊息類型為 cast.framework.messages.QueueRemoveRequestData。 |
QUEUE_REORDER |
字串 要求重新排序佇列。 訊息類型為:cast.framework.messages.QueueReorderRequestData。 |
QUEUE_NEXT |
字串 要求佇列中的下一個項目。接收端收到傳送者傳送的這則訊息時,該訊息會對應至 |
QUEUE_PREV |
字串 要求佇列中的前一個項目。接收端收到傳送者傳送的這則訊息時,該訊息會對應至 |
QUEUE_GET_ITEM_RANGE |
字串 要求擷取佇列中的項目。訊息類型為 cast.framework.messages.FetchItemsRequestData。 |
QUEUE_GET_ITEMS |
字串 取得項目資訊的要求。訊息類型為:cast.framework.messages.GetItemsInfoRequestData。 |
QUEUE_GET_ITEM_IDS |
字串 要求取得佇列 ID。訊息類型為 cast.framework.messages.RequestData。 |
QUEUE_SHUFFLE |
字串 要求重組佇列。訊息類型為 cast.framework.messages.RequestData。 |
SET_CREDENTIALS |
字串 設定使用者憑證。訊息類型為 cast.framework.messages.SetCredentialsRequestData。 |
LOAD_BY_ENTITY |
字串 根據實體 ID 載入媒體。訊息類型為:cast.framework.messages.LoadByEntityRequestData。 |
USER_ACTION |
字串 處理下列使用者動作。訊息類型為 cast.framework.messages.UserActionRequestData。 |
DISPLAY_STATUS |
字串 在螢幕上顯示媒體狀態。訊息類型為:cast.framework.messages.DisplayStatusRequestData。 |
FOCUS_STATE |
字串 接收端應用程式焦點狀態已變更。訊息類型為 cast.framework.messages.FocusStateRequestData。 |
CUSTOM_COMMAND |
字串 處理自訂應用程式指令。訊息類型為 cast.framework.messages.CustomCommandRequestData。 |
STORE_SESSION |
字串 儲存工作階段指令。訊息類型為 cast.framework.messages.StoreSessionRequestData。 |
RESUME_SESSION |
字串 繼續執行工作階段指令。 訊息類型為 cast.framework.messages.ResumeSessionRequestData。 |
SESSION_STATE |
字串 StoreSession 的回應類型。訊息類型為:cast.framework.messages.StoreSessionResponseData。 |
MetadataType
號碼
媒體中繼資料類型。
值 |
|
---|---|
一般 |
號碼 適用於大多數媒體類型的通用範本。由 cast.framework.messages.GenericMediaMetadata 使用。 |
電影 |
號碼 一部完整電影。 由 cast.framework.messages.MovieMediaMetadata 使用。 |
TV_SHOW |
號碼 電視影集的劇集。 由 cast.framework.messages.TvShowMediaMetadata 使用。 |
MUSIC_TRACK |
號碼 音樂曲目。 由 cast.framework.messages.MusicTrackMediaMetadata 使用。 |
相片 |
號碼 |
AUDIOBOOK_CHAPTER |
號碼 有聲書章節。 由 cast.framework.messages.AudiobookChapterMediaMetadata 使用。 |
- 另請參閱
- cast.framework.messages.MediaInformation.metadata
PlayerState
字串
代表播放器狀態。
值 |
|
---|---|
閒置 |
字串 玩家處於 IDLE 狀態。IDLE 狀態表示沒有有效的播放項目。在 Cast 應用程式啟動後,或在收到 LOAD 要求之前或播放結束後,播放器通常處於此狀態。播放器會根據 cast.framework.messages.MediaStatus 中設定的 cast.framework.messages.IdleReason 來轉換狀態。 |
播放中 |
字串 播放器處於「播放中」狀態。 |
已暫停 |
字串 玩家處於「已暫停」狀態。 |
緩衝處理中 |
字串 播放器處於「緩衝中」狀態。 |
QueueChangeType
字串
QUEUE_CHANGE
外寄郵件使用的佇列變更類型。
值 |
|
---|---|
INSERT |
字串 佇列中已插入項目。 |
移除 |
字串 佇列中有項目已移除。 |
ITEMS_CHANGE |
字串 已變更項目清單。 |
更新 |
字串 佇列正在更新,並傳送新的已排序清單。 |
NO_CHANGE |
字串 佇列沒有任何變更。當多位傳送方要求相同資料時,就會用來回應回音。 |
QueueType
字串
媒體容器/佇列的類型。
值 |
|
---|---|
專輯 |
字串 音樂專輯。 |
播放清單 |
字串 音樂播放清單,例如私人播放清單、公開播放清單或系統自動產生的播放清單 |
有聲書 |
字串 有聲書。 |
RADIO_STATION |
字串 傳統廣播電台。 |
PODCAST_SERIES |
字串 Podcast 系列節目 |
TV_SERIES |
字串 電視影集。 |
VIDEO_PLAYLIST |
字串 影片播放清單。 |
LIVE_TV |
字串 電視直播頻道。 |
電影 |
字串 電影。 |
RepeatMode
字串
播放所有項目時加入佇列的行為。
值 |
|
---|---|
REPEAT_OFF |
字串 待播清單完成時,媒體工作階段就會終止。 |
REPEAT_ALL |
字串 系統播放最後一個項目時,會無限期播放佇列中的所有項目。 |
REPEAT_SINGLE |
字串 系統會重複播放目前的項目。 |
REPEAT_ALL_AND_SHUFFLE |
字串 系統播放最後一個項目時,佇列中的所有項目將無限期播放,而最後一個項目會再次播放 (接收端會先隨機排序清單)。 |
SeekResumeState
字串
代表收到 SEEK 要求後的播放狀態。
值 |
|
---|---|
PLAYBACK_START |
字串 這會強制啟動媒體。 |
PLAYBACK_PAUSE |
字串 這會強制暫停媒體。 |
StreamingProtocolType
號碼
串流通訊協定類型。
值 |
|
---|---|
不明 |
號碼 未知的串流通訊協定類型。 |
MPEG_DASH |
號碼 MPEG-DASH (透過 HTTP 動態自動調整串流) 通訊協定類型。 |
HLS |
號碼 HLS (HTTP 即時串流) 通訊協定類型。 |
SMOOTH_STREAMING |
號碼 順暢的串流通訊協定類型。 |
StreamType
字串
代表串流類型。
值 |
|
---|---|
已緩衝 |
字串 VOD 和 DVR 內容。 |
直播 |
字串 直播線性串流內容。 |
無 |
字串 |
TextTrackEdgeType
字串
定義文字軌跡邊緣 (框線) 類型。
值 |
|
---|---|
無 |
字串 文字周圍不會顯示任何邊緣。 |
大綱 |
字串 文字周圍會顯示實心外框。 |
DROP_SHADOW |
字串 文字周圍會顯示淡出的陰影。 |
突襲 |
字串 相對於背景,文字看起來像是浮現或加大。 |
已淘汰 |
字串 文字似乎在背景執行去模糊化。 |
TextTrackFontGenericFamily
字串
如果文字軌中未定義字型,請使用一般字型系列。
值 |
|
---|---|
SANS_SERIF |
字串 使用 Sans-Serif 字型。 |
MONOSPACED_SANS_SERIF |
字串 使用等寬、Sans-Serif 字型。 |
SERIF |
字串 使用 Serif 字型。 |
MONOSPACED_SERIF |
字串 使用等寬 Serif 字型。 |
一般觀眾 |
字串 使用休閒的手寫字型。 |
深入瞭解 |
字串 使用草寫字型。 |
SMALL_CAPITALS |
字串 使用小型大寫字母。 |
TextTrackFontStyle
字串
文字軌字型樣式。
值 |
|
---|---|
NORMAL |
字串 未修改的字體。 |
粗體 |
字串 粗體樣式。 |
BOLD_ITALIC |
字串 並行的粗體和斜體樣式。 |
藍色 |
字串 斜體樣式。 |
TextTrackType
字串
文字追蹤類型 (遵循 HTML5 文字追蹤類型定義)。
值 |
|
---|---|
字幕 |
字串 針對有聲音但觀眾無法理解的對話進行轉錄或翻譯,例如觀眾無法理解媒體資源配樂的語言。 |
字幕 |
字串 對話、音效、相關音樂提示和其他相關音訊資訊的語音轉錄或翻譯,適合配樂無法使用時 (例如因為影片設為靜音或使用者聽障)。字幕會顯示在影片上。 |
說明 |
字串 媒體資源的影片元件文字說明;當視覺元件無法使用時,用途是進行音訊合成 (例如因為使用者在沒有螢幕的情況下與應用程式互動,或是使用者視障)。系統會將說明合成為獨立的音軌。 |
章節 |
字串 章節標題,用於瀏覽媒體資源。 |
中繼資料 |
字串 僅供腳本使用的曲目。 |
TextTrackWindowType
字串
文字追蹤視窗類型。
值 |
|
---|---|
無 |
字串 |
NORMAL |
字串 |
ROUNDED_CORNERS |
字串 |
TrackType
字串
媒體音軌類型。
值 |
|
---|---|
文字 |
字串 文字軌。 |
音軌 |
字串 音軌。 |
影片 |
字串 視訊軌。 |
UserAction
字串
使用者動作。
值 |
|
---|---|
LIKE |
字串 使用者表示偏好目前播放的內容。 |
不喜歡 |
字串 使用者表示不喜歡目前播放的內容。 |
追蹤 |
字串 使用者想要追蹤目前播放的內容或加上星號, |
取消追蹤 |
字串 使用者想停止追蹤目前正在播放的內容。 |
檢舉 |
字串 使用者檢舉目前正在播放內容不當的內容。 |
SKIP_AD |
字串 使用者想要略過目前正在播放的廣告。 |
歌詞 |
字串 使用者想顯示目前播放歌曲的歌詞。 |
UserActionContext
字串
UserAction
的內容資訊。
值 |
|
---|---|
UNKNOWN_CONTEXT |
字串 |
追蹤 |
字串 |
專輯 |
字串 |
藝人 |
字串 |
播放清單 |
字串 |
劇集 |
字串 |
系列 |
字串 |
電影 |
字串 |
頻道 |
字串 |
團隊 |
字串 |
播放器 |
字串 |
教練 |
字串 |
屬性
CaptionMimeType
字串
文字軌的 MIME 類型字幕。
值 |
|
---|---|
CEA608 |
字串 CEA 608 |
TTML |
字串 TTML |
越南 |
字串 越南 |
TTML_MP4 |
字串 TTML MP4 |
指令
號碼
一系列位元遮罩值,用於設定或擷取應用程式支援的 cast.framework.messages.MediaStatus#supportedMediaCommands。
值 |
|
---|---|
暫停 |
號碼 暫停指令。 |
查看 |
號碼 搜尋指令。 |
STREAM_VOLUME |
號碼 串流磁碟區指令。 |
STREAM_MUTE |
號碼 串流磁碟區指令。 |
ALL_BASIC_MEDIA |
號碼 所有基本媒體。包含強制指令 |
QUEUE_NEXT |
號碼 將下一個指令加入佇列。 |
QUEUE_PREV |
號碼 佇列上一個指令。 |
QUEUE_SHUFFLE |
號碼 佇列重組指令。 |
QUEUE_REPEAT_ALL |
號碼 「佇列重複所有」模式。 |
QUEUE_REPEAT_ONE |
號碼 「佇列重複播放」模式。 |
QUEUE_REPEAT |
號碼 佇列重複模式。 |
SKIP_AD |
號碼 略過 AD 指令。 |
EDIT_TRACKS |
號碼 編輯追蹤指令。 |
PLAYBACK_RATE |
號碼 播放速率指令。 |
LIKE |
號碼 使用者動作,例如指令。 |
不喜歡 |
號碼 使用者動作與指令不同。 |
追蹤 |
號碼 使用者動作「追蹤」指令。 |
取消追蹤 |
號碼 使用者動作「Unfollow」指令。 |
STREAM_TRANSFER |
號碼 串流轉移指令。 |
歌詞 |
號碼 歌詞指令。 |
ContainerType
號碼
容器中繼資料類型。
值 |
|
---|---|
GENERIC_CONTAINER |
號碼 適用於大多數媒體類型的通用範本。由 cast.framework.messages.ContainerMetadata 使用。 |
AUDIOBOOK_CONTAINER |
號碼 有聲書的中繼資料。 由 cast.framework.messages.AudiobookContainerMetadata 使用。 |
- 另請參閱
- cast.framework.messages.QueueData.containerMetadata
ContentFilteringMode
字串
代表內容篩選模式。
值 |
|
---|---|
FILTER_EXPLICIT |
字串 請勿播放煽情露骨內容。 |
ErrorReason
字串
代表媒體錯誤訊息的原因。
值 |
|
---|---|
INVALID_COMMAND |
字串 在指令無效或未實作時傳回。 |
INVALID_PARAMS |
字串 當參數無效或缺少必要參數時,系統會傳回這個值。 |
INVALID_MEDIA_SESSION_ID |
字串 當媒體工作階段不存在時傳回。 |
SKIP_LIMIT_REACHED |
字串 因達到略過上限而無法略過更多項目時,系統會傳回這個值。 |
NOT_SUPPORTED |
字串 應用程式不支援要求時,系統會傳回這個值。 |
LANGUAGE_NOT_SUPPORTED |
字串 不支援要求的語言時,系統會傳回這個值。 |
END_OF_QUEUE |
字串 由於跳回第一個項目或快轉佇列中的最後一個項目之後,無法略過,就會傳回這個值。 |
DUPLICATE_REQUEST_ID |
字串 當要求 ID 不專屬時 (接收方正在處理具有相同 ID 的要求)。 |
VIDEO_DEVICE_REQUIRED |
字串 當要求無法完成,因為需要支援影片的裝置時,系統會傳回這個值。 |
PREMIUM_ACCOUNT_REQUIRED |
字串 要求成功需要付費帳戶時,系統會傳回這個值。 |
APP_ERROR |
字串 當應用程式狀態無效而無法完成要求時,系統會傳回這個結果。 |
AUTHENTICATION_EXPIRED |
字串 如果驗證已過期 (例如使用者變更密碼或權杖撤銷),導致無法執行要求,系統會傳回此錯誤。 |
CONCURRENT_STREAM_LIMIT |
字串 偵測到並行串流過多時,就會傳回這個結果。 |
PARENTAL_CONTROL_RESTRICTED |
字串 當內容因家長監護功能遭到封鎖時,系統會傳回這個值。 |
CONTENT_FILTERED |
字串 當內容因篩選條件而遭封鎖時,系統會傳回這個值。 |
NOT_AVAILABLE_IN_REGION |
字串 當內容因區域性無法使用而遭到封鎖時,系統會傳回這個值。 |
CONTENT_ALREADY_PLAYING |
字串 當要求的內容已播放時,系統會傳回這個值。 |
INVALID_REQUEST |
字串 當要求無效時傳回。 |
GENERIC_LOAD_ERROR |
字串 載入要求遇到間歇性問題時會傳回。 |
ErrorType
字串
代表媒體錯誤訊息類型。
值 |
|
---|---|
INVALID_PLAYER_STATE |
字串 當玩家狀態無效以完成要求時會傳回。 |
LOAD_FAILED |
字串 當 LOAD 要求失敗時,系統會傳回這個值。 |
LOAD_CANCELLED |
字串 第二次傳入的 LOAD 要求取消 LOAD 要求時,系統會傳回這個值。 |
INVALID_REQUEST |
字串 當要求無效時傳回。 |
錯誤 |
字串 其他任何錯誤情況的一般錯誤。 |
ExtendedPlayerState
字串
擴充玩家狀態資訊。
值 |
|
---|---|
載入中 |
字串 播放器處於載入中狀態。 |
FocusState
字串
聚焦狀態。
值 |
|
---|---|
IN_FOCUS |
字串 接收器是焦點。 |
NOT_IN_FOCUS |
字串 接收器未處於焦點,其他活動處於啟用狀態。 |
GetStatusOptions
號碼
GetStatusOptions
會決定必須在媒體狀態回應中包含 GET_STATUS
訊息的資料量。
值 |
|
---|---|
NO_METADATA |
號碼 請勿加入中繼資料旗標。 |
NO_QUEUE_ITEMS |
號碼 請勿加入佇列項目旗標。 |
HdrType
字串
代表影片高動態範圍 (HDR) 類型。
值 |
|
---|---|
標準動態範圍 |
字串 標準動態範圍。 |
高動態範圍 |
字串 高動態範圍。 |
多媒體和影片廣告 |
字串 Dolby Vision。 |
HlsSegmentFormat
字串
HTTP 即時串流音訊區段的格式。
值 |
|
---|---|
AAC |
字串 AAC 封裝音訊的基本串流。 |
AC3 |
字串 AC3 封裝音訊的基本串流。 |
MP3 |
字串 MP3 封裝音訊的基本串流。 |
疑難排解 |
字串 MPEG-2 傳輸串流。 |
TS_AAC |
字串 AAC 低複雜度封裝的 MPEG-2 傳輸串流 (AAC-LC)。 |
TS_HE_AAC |
字串 AAC 高效率的 MPEG-2 傳輸串流 (HE-AAC)。 |
E_AC3 |
字串 E-AC3 封裝音訊的基本串流。 |
FMP4 |
字串 封裝至 ISO BMFF CMAF 片段的 MP4 音訊。 |
HlsVideoSegmentFormat
字串
HTTP 即時串流影片片段的格式。
值 |
|
---|---|
MPEG2_TS |
字串 MPEG-2 傳輸串流。支援 AVC。 |
FMP4 |
字串 影片封裝在 ISO BMFF CMAF 片段的 MP4 中。支援 AVC 和 HEVC。 |
IdleReason
字串
玩家處於 IDLE 狀態的原因。
值 |
|
---|---|
CANCELLED |
字串 傳送者使用「STOP」指令要求停止播放。 |
INTERRUPTED |
字串 傳送者使用 LOAD 指令要求播放其他媒體。 |
完成 |
字串 媒體播放完畢。 |
錯誤 |
字串 媒體因錯誤而中斷,例如播放器因網路錯誤而無法下載媒體時,就有可能發生這種情況。 |
MediaCategory
字串
媒體類別。
值 |
|
---|---|
音軌 |
字串 僅播放音訊。 |
影片 |
字串 媒體為影片和音訊 (預設)。 |
圖片 |
字串 媒體是圖片。 |
MessageType
字串
代表 cast.framework.PlayerManager 攔截的媒體訊息類型。訊息類型可分為要求或外寄郵件。要求可讓應用程式修改任何資料,然後才交由 Web Receiver SDK 處理。傳出訊息可讓應用程式在訊息傳送至連線的系統和寄件者應用程式之前修改任何資料。
值 |
|
---|---|
MEDIA_STATUS |
字串 目前媒體狀態的傳出訊息。 訊息類型為:cast.framework.messages.MediaStatus。 |
CLOUD_STATUS |
字串 媒體狀態的外送訊息給雲端寄件者。 訊息類型為:cast.framework.messages.CloudMediaStatus。 |
QUEUE_CHANGE |
字串 佇列變更的外寄郵件。 訊息類型為 cast.framework.messages.QueueChange。 |
QUEUE_ITEMS |
字串 佇列項目資訊的傳出訊息。訊息類型為:cast.framework.messages.ItemsInfo。 |
QUEUE_ITEM_IDS |
字串 列出佇列 ID 清單的傳出訊息。訊息類型為 cast.framework.messages.QueueIds。 |
GET_STATUS |
字串 請求目前的媒體狀態。 訊息類型為:cast.framework.messages.GetStatusRequestData。 |
裝載 |
字串 要求載入媒體。訊息類型為 cast.framework.messages.LoadRequestData。 |
暫停 |
字串 要求暫停播放器。訊息類型為:cast.framework.messages.RequestData |
停止 |
字串 要求停止播放器。訊息類型為 cast.framework.messages.RequestData。 |
玩樂 |
字串 要求繼續播放。訊息類型為 cast.framework.messages.RequestData。 |
SKIP_AD |
字串 請求略過正在播放的廣告。 訊息類型為 cast.framework.messages.RequestData。 |
PLAY_AGAIN |
字串 要求再次播放目前的媒體。訊息類型為 cast.framework.messages.RequestData。 |
查看 |
字串 要求搜尋媒體。 訊息類型為 cast.framework.messages.SeekRequestData。 |
SET_PLAYBACK_RATE |
字串 要求變更播放速率。 訊息類型為 cast.framework.messages.SetPlaybackRateRequestData。 |
SET_VOLUME |
字串 要求變更目前的媒體音量。 訊息類型為 cast.framework.messages.VolumeRequestData。 |
EDIT_TRACKS_INFO |
字串 要求變更播放中的文字或音軌。訊息類型為:cast.framework.messages.EditTracksInfoRequestData。 |
EDIT_AUDIO_TRACKS |
字串 要求變更播放中的音軌。訊息類型為:cast.framework.messages.EditAudioTracksRequestData。 |
預先 |
字串 要求預先快取資料。訊息類型為 cast.framework.messages.PrecacheRequestData。 |
預先載入 |
字串 要求預先載入項目。訊息類型為 cast.framework.messages.PreloadRequestData。 |
QUEUE_LOAD |
字串 要求載入佇列。訊息類型為:cast.framework.messages.QueueLoadRequestData。 |
QUEUE_INSERT |
字串 要求插入佇列。訊息類型為:cast.framework.messages.QueueInsertRequestData。 |
QUEUE_UPDATE |
字串 要求更新佇列。 訊息類型為:cast.framework.messages.QueueUpdateRequestData。 |
QUEUE_REMOVE |
字串 要求從待播清單中移除。訊息類型為 cast.framework.messages.QueueRemoveRequestData。 |
QUEUE_REORDER |
字串 要求重新排序佇列。 訊息類型為:cast.framework.messages.QueueReorderRequestData。 |
QUEUE_NEXT |
字串 要求佇列中的下一個項目。接收端收到傳送者傳送的這則訊息時,該訊息會對應至 |
QUEUE_PREV |
字串 要求佇列中的前一個項目。接收端收到傳送者傳送的這則訊息時,該訊息會對應至 |
QUEUE_GET_ITEM_RANGE |
字串 要求擷取佇列中的項目。訊息類型為 cast.framework.messages.FetchItemsRequestData。 |
QUEUE_GET_ITEMS |
字串 取得項目資訊的要求。訊息類型為:cast.framework.messages.GetItemsInfoRequestData。 |
QUEUE_GET_ITEM_IDS |
字串 要求取得佇列 ID。訊息類型為 cast.framework.messages.RequestData。 |
QUEUE_SHUFFLE |
字串 要求重組佇列。訊息類型為 cast.framework.messages.RequestData。 |
SET_CREDENTIALS |
字串 設定使用者憑證。訊息類型為 cast.framework.messages.SetCredentialsRequestData。 |
LOAD_BY_ENTITY |
字串 根據實體 ID 載入媒體。訊息類型為:cast.framework.messages.LoadByEntityRequestData。 |
USER_ACTION |
字串 處理下列使用者動作。訊息類型為 cast.framework.messages.UserActionRequestData。 |
DISPLAY_STATUS |
字串 在螢幕上顯示媒體狀態。訊息類型為:cast.framework.messages.DisplayStatusRequestData。 |
FOCUS_STATE |
字串 接收端應用程式焦點狀態已變更。訊息類型為 cast.framework.messages.FocusStateRequestData。 |
CUSTOM_COMMAND |
字串 處理自訂應用程式指令。訊息類型為 cast.framework.messages.CustomCommandRequestData。 |
STORE_SESSION |
字串 儲存工作階段指令。訊息類型為 cast.framework.messages.StoreSessionRequestData。 |
RESUME_SESSION |
字串 繼續執行工作階段指令。 訊息類型為 cast.framework.messages.ResumeSessionRequestData。 |
SESSION_STATE |
字串 StoreSession 的回應類型。訊息類型為:cast.framework.messages.StoreSessionResponseData。 |
MetadataType
號碼
媒體中繼資料類型。
值 |
|
---|---|
一般 |
號碼 適用於大多數媒體類型的通用範本。由 cast.framework.messages.GenericMediaMetadata 使用。 |
電影 |
號碼 一部完整電影。 由 cast.framework.messages.MovieMediaMetadata 使用。 |
TV_SHOW |
號碼 電視影集的劇集。 由 cast.framework.messages.TvShowMediaMetadata 使用。 |
MUSIC_TRACK |
號碼 音樂曲目。 由 cast.framework.messages.MusicTrackMediaMetadata 使用。 |
相片 |
號碼 |
AUDIOBOOK_CHAPTER |
號碼 有聲書章節。 由 cast.framework.messages.AudiobookChapterMediaMetadata 使用。 |
- 另請參閱
- cast.framework.messages.MediaInformation.metadata
PlayerState
字串
代表播放器狀態。
值 |
|
---|---|
閒置 |
字串 玩家處於 IDLE 狀態。IDLE 狀態表示沒有有效的播放項目。在 Cast 應用程式啟動後,或在收到 LOAD 要求之前或播放結束後,播放器通常處於此狀態。播放器會根據 cast.framework.messages.MediaStatus 中設定的 cast.framework.messages.IdleReason 來轉換狀態。 |
播放中 |
字串 播放器處於「播放中」狀態。 |
已暫停 |
字串 玩家處於「已暫停」狀態。 |
緩衝處理中 |
字串 播放器處於「緩衝中」狀態。 |
QueueChangeType
字串
QUEUE_CHANGE
外寄郵件使用的佇列變更類型。
值 |
|
---|---|
INSERT |
字串 佇列中已插入項目。 |
移除 |
字串 佇列中有項目已移除。 |
ITEMS_CHANGE |
字串 已變更項目清單。 |
更新 |
字串 佇列正在更新,並傳送新的已排序清單。 |
NO_CHANGE |
字串 佇列沒有任何變更。當多位傳送方要求相同資料時,就會用來回應回音。 |
QueueType
字串
媒體容器/佇列的類型。
值 |
|
---|---|
專輯 |
字串 音樂專輯。 |
播放清單 |
字串 音樂播放清單,例如私人播放清單、公開播放清單或系統自動產生的播放清單 |
有聲書 |
字串 有聲書。 |
RADIO_STATION |
字串 傳統廣播電台。 |
PODCAST_SERIES |
字串 Podcast 系列節目 |
TV_SERIES |
字串 電視影集。 |
VIDEO_PLAYLIST |
字串 影片播放清單。 |
LIVE_TV |
字串 電視直播頻道。 |
電影 |
字串 電影。 |
RepeatMode
字串
播放所有項目時加入佇列的行為。
值 |
|
---|---|
REPEAT_OFF |
字串 待播清單完成時,媒體工作階段就會終止。 |
REPEAT_ALL |
字串 系統播放最後一個項目時,會無限期播放佇列中的所有項目。 |
REPEAT_SINGLE |
字串 系統會重複播放目前的項目。 |
REPEAT_ALL_AND_SHUFFLE |
字串 系統播放最後一個項目時,佇列中的所有項目將無限期播放,而最後一個項目會再次播放 (接收端會先隨機排序清單)。 |
SeekResumeState
字串
代表收到 SEEK 要求後的播放狀態。
值 |
|
---|---|
PLAYBACK_START |
字串 這會強制啟動媒體。 |
PLAYBACK_PAUSE |
字串 這會強制暫停媒體。 |
StreamingProtocolType
號碼
串流通訊協定類型。
值 |
|
---|---|
不明 |
號碼 未知的串流通訊協定類型。 |
MPEG_DASH |
號碼 MPEG-DASH (透過 HTTP 動態自動調整串流) 通訊協定類型。 |
HLS |
號碼 HLS (HTTP 即時串流) 通訊協定類型。 |
SMOOTH_STREAMING |
號碼 順暢的串流通訊協定類型。 |
StreamType
字串
代表串流類型。
值 |
|
---|---|
已緩衝 |
字串 VOD 和 DVR 內容。 |
直播 |
字串 直播線性串流內容。 |
無 |
字串 |
TextTrackEdgeType
字串
定義文字軌跡邊緣 (框線) 類型。
值 |
|
---|---|
無 |
字串 文字周圍不會顯示任何邊緣。 |
大綱 |
字串 文字周圍會顯示實心外框。 |
DROP_SHADOW |
字串 文字周圍會顯示淡出的陰影。 |
突襲 |
字串 相對於背景,文字看起來像是浮現或加大。 |
已淘汰 |
字串 文字似乎在背景執行去模糊化。 |
TextTrackFontGenericFamily
字串
如果文字軌中未定義字型,請使用一般字型系列。
值 |
|
---|---|
SANS_SERIF |
字串 使用 Sans-Serif 字型。 |
MONOSPACED_SANS_SERIF |
字串 使用等寬、Sans-Serif 字型。 |
SERIF |
字串 使用 Serif 字型。 |
MONOSPACED_SERIF |
字串 使用等寬 Serif 字型。 |
一般觀眾 |
字串 使用休閒的手寫字型。 |
深入瞭解 |
字串 使用草寫字型。 |
SMALL_CAPITALS |
字串 使用小型大寫字母。 |
TextTrackFontStyle
字串
文字軌字型樣式。
值 |
|
---|---|
NORMAL |
字串 未修改的字體。 |
粗體 |
字串 粗體樣式。 |
BOLD_ITALIC |
字串 並行的粗體和斜體樣式。 |
藍色 |
字串 斜體樣式。 |
TextTrackType
字串
文字追蹤類型 (遵循 HTML5 文字追蹤類型定義)。
值 |
|
---|---|
字幕 |
字串 針對有聲音但觀眾無法理解的對話進行轉錄或翻譯,例如觀眾無法理解媒體資源配樂的語言。 |
字幕 |
字串 對話、音效、相關音樂提示和其他相關音訊資訊的語音轉錄或翻譯,適合配樂無法使用時 (例如因為影片設為靜音或使用者聽障)。字幕會顯示在影片上。 |
說明 |
字串 媒體資源的影片元件文字說明;當視覺元件無法使用時,用途是進行音訊合成 (例如因為使用者在沒有螢幕的情況下與應用程式互動,或是使用者視障)。系統會將說明合成為獨立的音軌。 |
章節 |
字串 章節標題,用於瀏覽媒體資源。 |
中繼資料 |
字串 僅供腳本使用的曲目。 |
TextTrackWindowType
字串
文字追蹤視窗類型。
值 |
|
---|---|
無 |
字串 |
NORMAL |
字串 |
ROUNDED_CORNERS |
字串 |
TrackType
字串
媒體音軌類型。
值 |
|
---|---|
文字 |
字串 文字軌。 |
音軌 |
字串 音軌。 |
影片 |
字串 視訊軌。 |
UserAction
字串
使用者動作。
值 |
|
---|---|
LIKE |
字串 使用者表示偏好目前播放的內容。 |
不喜歡 |
字串 使用者表示不喜歡目前播放的內容。 |
追蹤 |
字串 使用者想要追蹤目前播放的內容或加上星號, |
取消追蹤 |
字串 使用者想停止追蹤目前正在播放的內容。 |
檢舉 |
字串 使用者檢舉目前正在播放內容不當的內容。 |
SKIP_AD |
字串 使用者想要略過目前正在播放的廣告。 |
歌詞 |
字串 使用者想顯示目前播放歌曲的歌詞。 |
UserActionContext
字串
UserAction
的內容資訊。
值 |
|
---|---|
UNKNOWN_CONTEXT |
字串 |
追蹤 |
字串 |
專輯 |
字串 |
藝人 |
字串 |
播放清單 |
字串 |
劇集 |
字串 |
系列 |
字串 |
電影 |
字串 |
頻道 |
字串 |
團隊 |
字串 |
播放器 |
字串 |
教練 |
字串 |