cast. 架構。 訊息
這是 cast.framework.messages
命名空間。
類別
音訊簿章節中繼資料
有聲書章節說明。
音訊容器中繼資料
有聲書容器說明。
休息時間
代表主要影片包含的廣告時段 (例如廣告插播)。
碎拍
代表廣告插播片段 (例如廣告插播時間點的廣告片段)
破壞狀態
代表休息時間的狀態。
CloudMediaStatus
只有傳送給雲端寄件者的 MediaStatus
,例如 Google 助理。
ContainerMetadata
做為 QueueData
的一部分的常見容器中繼資料。
內容分級
內容分級 (家長分級、心智成熟度分級)。
CustomCommandRequestData
CustomCommand
要求資料。
顯示狀態要求資料
DisplayStatusRequest
資料。
編輯音訊音軌要求資料
媒體事件:EDIT_AUDIO_TRACKS 要求資料。如未提供語言,系統將啟用媒體的預設音軌。
編輯音軌資訊
媒體事件:EDIT_TRACKS_INFO 要求資料。
錯誤資料
代表錯誤資訊。
ExtendedMediaStatus
擴充媒體狀態資訊
擷取項目資料
擷取項目要求資料。
FocusStateRequestData
將焦點移至變更狀態訊息。
一般媒體中繼資料
一般媒體說明。
GetItemsInfoRequestData 資料
取得項目資訊要求資料。
GetStatusRequestData
媒體事件 GET_STATUS 要求資料。
圖像
描述接收器應用程式或媒體項目的圖片。這可以是應用程式圖示、封面圖片或縮圖。
項目資訊
代表含有每個要求 ID 項目資訊的資料訊息。
LiveSeekableRange
提供即時可搜尋的範圍,並包含開始和結束時間 (以秒為單位)。
LoadByEntityRequestData
LoadByEntity
要求資料。
LoadOptions
提供載入要求的其他選項。
載入要求資料
媒體事件 LOAD 要求資料。
媒體資訊
代表媒體資訊。
媒體中繼資料
做為 MediaInformation
的一部分的常見媒體中繼資料,或用來將媒體區段當做容器中繼資料的一部分。
媒體狀態
表示媒體工作階段的狀態。
電影媒體中繼資料
電影媒體說明。
MusicTrackMediaMetadata
音樂媒體媒體說明。
PhotoMediaMetadata
相片媒體說明。
預覽快取資料
媒體事件 PRECACHE 要求資料。 (系統會忽略載入要求的部分欄位,例如自動播放和佇列資料)。
預覽要求資料
媒體事件 PRELOAD 請求資料。
佇列變更
代表佇列變更訊息,例如插入、移除和更新。
QueueData
在 LOAD 要求中將佇列資料排入佇列。
佇列 ID
代表包含訊息佇列完整訊息的資料訊息。
QueueInsertRequestData
媒體事件佇列 INSERT 要求資料。
佇列項目
佇列項目資訊。應用程式開發人員可能需要建立 QueueItem 才能使用 Cast.framework.messages.InsertQueueItems 插入佇列元素。在此情況下,他們不應提供 itemId (因為項目在佇列中插入時,將會指派實際的 itemId)。這可防止 ID 衝突。
QueueLoadRequestData
媒體事件佇列 LOAD 要求資料。
QueueRemoveRequestData
媒體事件佇列 REMOVE 要求資料。
QueueReorderRequestData
媒體事件佇列 REORDER 要求資料。
QueueUpdateRequestData
媒體事件 UPDATE 佇列要求資料。
RefreshCredentialsRequestData
RefreshCredentials
要求資料。
要求資料
媒體事件請求資料。
繼續工作階段要求資料
RESUME_SESSION 要求資料
SeekableRange
提供搜尋範圍 (以秒為單位)。
SeekRequestData
媒體事件 SEEK 要求資料。
工作階段狀態
包含要儲存在 StoreSession 及要在 ResumeSession 中復原的所有資料的狀態物件。
設定憑證要求資料
SetCredentials
要求資料。
設定播放速率要求資料
媒體事件播放速率要求資料。
商店工作階段資料
STORE_SESSION 要求資料
儲存工作階段回應資料
STORE_SESSION 指令的回應資料。
文字音軌樣式
說明文字軌的樣式資訊。
追蹤
說明曲目中繼資料資訊。
Tracks 資訊
追蹤資訊。
電視表演媒體中繼資料
電視劇集媒體說明。
使用者動作要求資料
UserAction
要求資料。
UserActionState
代表媒體的使用者動作狀態。
VastAdsRequest
VAST 廣告請求設定。
影片資訊
影片資訊,例如影片解析度和高動態範圍 (HDR)。
音量
代表媒體工作階段串流的音量。
磁碟區要求資料
媒體事件 SET_VOLUME 要求資料。
列舉
說明文字 MIME 類型
string
說明文字音軌 MIME 類型。
值 |
|
---|---|
CEA608 |
string CEA 608 |
TTML |
string TTML |
影片觀看率 |
string 影片觀看率 |
TTML_MP4 |
string TTML MP4 |
指令
數字
用於設定或擷取 cast.framework.messages.MediaStatus#supportedMediaCommands 應用程式所支援的媒體指令的位元遮罩值清單。
值 |
|
---|---|
暫停 |
數字 暫停指令。 |
查看 |
數字 搜尋指令。 |
STREAM_VOLUME |
數字 串流磁碟區指令。 |
STREAM_MUTE |
數字 串流磁碟區指令。 |
所有_BASIC_MEDIA |
數字 所有基本媒體。包含必要的指令 |
待播清單 |
數字 佇列的下一個指令。 |
QUEUE_PREV |
數字 佇列前一項指令。 |
QUEUE_SHUFFLE |
數字 佇列重組指令。 |
QUEUE_REPEAT_ALL |
數字 將 YouTube 佇列重複播放。 |
QUEUE_REPEAT_ONE |
數字 將「重複播放」模式排入佇列。 |
QUEUE_REPEAT |
數字 佇列重複模式。 |
略過 |
數字 略過 AD 指令。 |
編輯 |
數字 編輯音軌指令。 |
PLAYBACK_RATE |
數字 播放速率指令。 |
LIKE |
數字 使用者動作喜歡按鈕。 |
不喜歡 |
數字 使用者操作不喜歡指令。 |
追蹤 |
數字 使用者動作 遵循指令。 |
取消追蹤 |
數字 使用者動作「取消追蹤」指令。 |
STREAM_TRANSFER |
數字 串流傳輸指令。 |
歌詞 |
數字 歌詞指令。 |
容器類型
數字
容器中繼資料的類型。
值 |
|
---|---|
GENERIC_CONTAINER |
數字 適合大多數媒體類型的通用範本。由 cast.framework.messages.ContainerMetadata 使用。 |
AUDIOBOOK_CONTAINER |
數字 有聲書的中繼資料。 由 cast.framework.messages.AudiobookContainerMetadata 使用。 |
- 另請參閱
- cast.framework.messages.QueueData.containerMetadata
內容篩選模式
string
代表內容篩選模式。
值 |
|
---|---|
FILTER_EXPLICIT |
string 請勿播放煽情露骨內容。 |
錯誤原因
string
代表媒體錯誤訊息原因。
值 |
|
---|---|
INVALID_COMMAND |
string 當指令無效或未執行時傳回。 |
INVALID_PARAMS 無效 |
string 當參數無效或缺少必要參數時,系統會傳回此值。 |
INVALID_MEDIA_SESSION_ID |
string 媒體工作階段不存在時傳回。 |
SKIP_LIMIT_REACHED (已略過) |
string 因已達略過上限而無法略過更多項目時,系統會傳回這個值。 |
不支援 |
string 當應用程式不支援此要求時傳回。 |
不支援語言 |
string 不支援您要求的語言時傳回。 |
END_OF_QUEUE |
string 因無法返回第一個項目,或超過佇列中的最後一個項目而無法略過。 |
DUPLICATE_REQUEST_ID |
string 要求 ID 重複時傳回 (接收端正在處理同一個 ID 的要求)。 |
VIDEO_DEVICE_REQUIRED |
string 由於需要有影片的裝置,所以無法完成要求時傳回。 |
PREMIUM_ACCOUNT_REQUIRED |
string 當要求成功傳送付費帳戶時,會傳回此值。 |
應用程式錯誤 |
string 當應用程式狀態無效時,會傳回此值。 |
AUTHENTICATION_EXPIRED |
string 當驗證因過期 (例如使用者變更密碼或撤銷憑證) 而失效時,系統會傳回這個代碼。 |
CONCURRENT_STREAM_LIMIT |
string 偵測到太多並行串流時傳回。 |
PARENTAL_CONTROL_RESTRICTED |
string 因受家長監護功能保護而封鎖內容時傳回的內容。 |
CONTENT_FILTERED |
string 因篩選器因內容遭到封鎖而傳回 。 |
NOT_AVAILABLE_IN_REGION |
string 因地區無法使用而遭封鎖的內容傳回。 |
CONTENT_ALREADY_PLAYING |
string 要求的內容已在播放時傳回。 |
INVALID_REQUEST |
string 當要求無效時傳回。 |
GENERIC_LOAD_ERROR |
string 載入要求發生間歇性問題時傳回。 |
ErrorType
string
代表媒體錯誤訊息類型。
值 |
|
---|---|
INVALID_player_STATE |
string 因播放器狀態無效而無法執行要求時傳回 。 |
LOAD_FAILED |
string LOAD 要求失敗時傳回。 |
LOAD_CANCELLED |
string 當第二次傳入的 LOAD 要求取消 LOAD 要求時,會傳回此值。 |
INVALID_REQUEST |
string 當要求無效時傳回。 |
錯誤 |
string 一般錯誤,適用於任何其他錯誤案例。 |
ExtendedPlayerState
string
擴充玩家狀態資訊。
值 |
|
---|---|
載入中 |
string 玩家處於「載入中」狀態。 |
焦點狀態
string
聚焦狀態:
值 |
|
---|---|
INFF |
string 接收器正在對焦。 |
NOT_IN_FOCUS |
string 接收器未對焦,其他活動已啟用。 |
GetStatusOptions
數字
GetStatusOptions
會決定必須在 GET_STATUS
訊息的媒體狀態回應中加入的資料量。
值 |
|
---|---|
沒有相關資料 |
數字 請勿加入中繼資料標記。 |
NO_QUEUE_ITEMS 個 |
數字 請勿加入佇列項目旗標。 |
HdrType
string
代表影片高動態範圍 (HDR) 類型。
值 |
|
---|---|
SDR |
string 標準動態範圍。 |
高動態範圍 |
string 高動態範圍。 |
DV |
string Dolby Vision。 |
HlsSegmentFormat
string
HLS 音訊片段的格式。
值 |
|
---|---|
進階音訊編碼 |
string AAC 打包的音訊基本串流。 |
應用程式廣告活動 3 |
string AC3 音訊音訊基本串流。 |
MP3 |
string MP3 音訊音訊基本串流。 |
疑難排解 |
string MPEG-2 傳輸串流。 |
區域服務合約 |
string AAC 低複雜度包含 MPEG-2 傳輸串流 (AAC-LC)。 |
TS_HE_AAC |
string AAC 高效封包 MPEG-2 傳輸串流 (HE-AAC)。 |
E_AC3 |
string E-AC3 音訊音訊基本串流。 |
FMP4 |
string 採用 ISO BMFF CMAF 片段 MP4 格式的音訊。 |
HlsVideoSegmentFormat
string
HLS 影片片段的格式。
值 |
|
---|---|
MPEG2_TS |
string MPEG-2 傳輸串流。支援 AVC。 |
FMP4 |
string 影片採用 ISO BMFF CMAF 片段 MP4。支援 AVC 和 HEVC。 |
放置原因
string
玩家處於閒置狀態的原因。
值 |
|
---|---|
CANCELLED |
string 寄件者使用 STOP 指令要求停止播放。 |
INTERRUPTED |
string 一位寄件者使用 LOAD 指令要求播放不同媒體。 |
完成 |
string 媒體播放完成。 |
錯誤 |
string 媒體因錯誤而中斷,例如,如果播放器因網路錯誤而無法下載媒體,就可能發生這種狀況。 |
媒體類別
string
媒體類別。
值 |
|
---|---|
音軌 |
string 媒體只能播放音訊。 |
影片 |
string 媒體為影片和音訊 (預設)。 |
圖片 |
string 媒體就是圖片。 |
MessageType
string
代表媒體訊息類型。
值 |
|
---|---|
媒體狀態 |
string 目前的媒體狀態的外寄郵件。 訊息類型為 cast.framework.messages.MediaStatus。 |
CLOUD_STATUS |
string 將媒體狀態的外寄郵件傳送至雲端寄件者。 訊息類型為 cast.framework.messages.CloudMediaStatus。 |
QUEUE_CHANGE |
string 佇列變更的外寄郵件。訊息類型為 cast.framework.messages.QueueChange。 |
QUEUE_ITEMS 個 |
string 佇列項目資訊的外寄郵件。訊息類型為 cast.framework.messages.ItemsInfo。 |
QUEUE_ITEM_IDS |
string 佇列 ID 清單的外寄郵件。訊息類型為 cast.framework.messages.QueueIds。 |
GET_STATUS |
string 要求取得目前的媒體狀態。 訊息類型為 cast.framework.messages.GetStatusRequestData。 |
裝載 |
string 要求載入媒體。 訊息類型為 cast.framework.messages.LoadRequestData。 |
暫停 |
string 要求暫停播放器。 訊息類型為 cast.framework.messages.RequestData |
停止 |
string 要求停止播放播放器。 訊息類型為 cast.framework.messages.RequestData。 |
播放 |
string 繼續播放。 訊息類型為 cast.framework.messages.RequestData。 |
略過 |
string 要求略過播放廣告。訊息類型為 cast.framework.messages.RequestData。 |
PLAY_AGAIN |
string 要求播放目前媒體。 訊息類型為 cast.framework.messages.RequestData。 |
查看 |
string 要求搜尋媒體。 訊息類型為 cast.framework.messages.SeekRequestData。 |
SET_PLAYBACK_RATE |
string 要求變更播放速率。 訊息類型為 cast.framework.messages.SetplayRateRequestData。 |
預設值 |
string 要求變更目前的媒體音量。 訊息類型為 cast.framework.messages.VolumeRequestData。 |
EDIT_TRACKS_INFO |
string 要求變更播放文字或音軌。 訊息類型為 cast.framework.messages.EditTracksInfoRequestData。 |
EDIT_AUDIO_TRACKS |
string 要求變更播放音軌。 訊息類型為 cast.framework.messages.EditAudioTracksRequestData。 |
預測 |
string 要求預先快取資料。訊息類型為 cast.framework.messages.PrecacheRequestData。 |
預載 |
string 要求預先載入項目。訊息類型為 cast.framework.messages.PreloadRequestData。 |
QUEUE_LOAD |
string 要求載入佇列。訊息類型為 cast.framework.messages.QueueLoadRequestData。 |
QUEUE_INSERT |
string 要求插入佇列。訊息類型為 cast.framework.messages.QueueInsertRequestData。 |
QUEUE_UPDATE |
string 要求更新佇列。 訊息類型為 cast.framework.messages.QueueUpdateRequestData。 |
QUEUE_REMOVE |
string 要求從佇列中移除。 訊息類型為 cast.framework.messages.QueueRemoveRequestData。 |
QUEUE_REORDER |
string 要求重新排序佇列。訊息類型為 cast.framework.messages.QueueReorderRequestData。 |
待播清單 |
string 要求佇列中的下一個項目。當接收器從傳送端收到這則訊息時,訊息會對應至具有 |
QUEUE_PREV |
string 要求佇列中的上一個項目。當接收器從傳送端收到這則訊息時,訊息會對應至具有 |
QUEUE_GET_ITEM_RANGE |
string 要求擷取佇列中的項目。訊息類型為 cast.framework.messages.FetchItemsRequestData。 |
QUEUE_GET_ITEMS |
string 要求取得項目資訊。訊息類型為:cast.framework.messages.GetItemsInfoRequestData。 |
QUEUE_GET_ITEM_IDS |
string 要求取得佇列 ID。訊息類型為 cast.framework.messages.RequestData。 |
QUEUE_SHUFFLE |
string 要求隨機播放佇列。訊息類型為 cast.framework.messages.RequestData。 |
SET_CREDENTIALS |
string 設定使用者憑證。訊息類型為 cast.framework.messages.SetCredentialsRequestData。 |
LOAD_BY_ENTITY |
string 依實體 ID 載入媒體。訊息類型為 cast.framework.messages.LoadByEntityRequestData。 |
使用者動作 |
string 按照下列方式處理使用者動作: 訊息類型為 cast.framework.messages.UserActionRequestData。 |
DISPLAY_STATUS |
string 在螢幕上顯示媒體狀態。 訊息類型為 cast.framework.messages.DisplayStatusRequestData。 |
FOCUS_STATE |
string 接收端應用程式焦點狀態已變更。訊息類型為 cast.framework.messages.FocusStateRequestData。 |
CUSTOM_COMMAND |
string 處理自訂應用程式指令。 訊息類型為 cast.framework.messages.CustomCommandRequestData。 |
STORE_SESSION |
string 儲存工作階段指令。訊息類型為 cast.framework.messages.StoreSessionRequestData。 |
RESUME_SESSION 賽程 |
string 繼續工作階段指令。訊息類型為 cast.framework.messages.ContinueSessionRequestData。 |
SESSION_STATE |
string StoreSession 的回應類型。訊息類型為 cast.framework.messages.StoreSessionResponseData。 |
中繼資料類型
數字
媒體中繼資料的類型,
值 |
|
---|---|
一般 |
數字 適合大多數媒體類型的通用範本。由 cast.framework.messages.GenericMediaMetadata 使用。 |
電影 |
數字 完整電影。 由 cast.framework.messages.MovieMediaMetadata 使用。 |
電視節目 |
數字 電視影集的劇集。 由 cast.framework.messages.TvShowMediaMetadata 使用。 |
音樂曲目 |
數字 音樂曲目。 由 cast.framework.messages.MusicTrackMediaMetadata 使用。 |
相片 |
數字 |
音訊轉錄 |
數字 章節。 由 cast.framework.messages.AudiobookChapterMediaMetadata 使用。 |
- 另請參閱
- cast.framework.messages.MediaInformation.metadata
玩家狀態
string
代表玩家狀態。
值 |
|
---|---|
閒置 |
string 玩家處於閒置狀態。閒置狀態表示沒有有效的播放作業。一般來說,玩家會在收到 LOAD 要求之前或播放完成後,才啟動 Cast 應用程式。播放器根據 cast.framework.messages.MediaStatus 中設定的 cast.framework.messages.IdleReason,轉換為這個狀態。 |
播放中 |
string 玩家處於 PLAYING 狀態。 |
已暫停 |
string 玩家處於「已暫停」狀態。 |
緩衝處理中 |
string 玩家處於「BUFFERING」狀態。 |
佇列變更類型
string
QUEUE_CHANGE
則外寄郵件使用的佇列變更類型。
值 |
|
---|---|
插入 |
string 佇列已插入項目。 |
移除 |
string 佇列已移除項目。 |
ITEMS_CHANGE |
string 已變更項目清單。 |
更新 |
string 佇列已進行更新並傳送新的已排序清單。 |
沒有變化 |
string 佇列沒有變更。當多個傳送者要求取得相同的資料時,這會用來回應。 |
佇列類型
string
媒體容器/佇列的類型。
值 |
|
---|---|
專輯 |
string 音樂專輯。 |
播放清單 |
string 音樂播放清單,例如私人播放清單、公開播放清單或自動產生的播放清單。 |
手冊 |
string 有聲書。 |
RADIO_STATION |
string 傳統廣播電台。 |
PODCAST_SERIES |
string Podcast 系列節目。 |
TV_SERIES |
string 電視影集。 |
VIDEO_PLAYLIST |
string 影片播放清單。 |
LIVE_TV |
string 直播電視頻道。 |
電影 |
string 電影。 |
重複模式
string
佇列中所有項目都播放完畢時的行為。
值 |
|
---|---|
REPEAT_OFF (關閉) |
string 佇列結束時,媒體工作階段就會終止。 |
重複 |
string 佇列中的所有項目都將無限期播放,當最後一個項目播放完畢時,就會再次播放第一個項目。 |
重複 |
string 系統會重複播放目前的項目。 |
REPEAT_ALL_AND_SHUFFLE |
string 佇列中的所有項目都會無限期地播放,當最後一個項目播放完畢時,就會再次播放第一個項目 (清單會由接收器先隨機播放)。 |
SeekContinueState
string
代表 SEEK 要求之後的播放狀態。
值 |
|
---|---|
PLAYBACK_START |
string 這會強制啟動媒體。 |
PLAYBACK_PAUSE |
string 這會強制暫停媒體。 |
串流通訊協定類型
數字
串流通訊協定類型。
值 |
|
---|---|
不明 |
數字 不明的串流通訊協定類型。 |
MPEG_DASH |
數字 MPEG-DASH (透過 HTTP 的動態自動調整串流) 通訊協定類型。 |
HTTP 即時串流 |
數字 HLS (HTTP 即時串流) 通訊協定類型。 |
SMOOTH_STREAMING |
數字 流暢串流通訊協定類型。 |
串流類型
string
代表串流類型。
值 |
|
---|---|
已購買 |
string VOD 和 DVR 內容。 |
直播 |
string 直播線性串流內容。 |
無 |
string |
文字軌邊緣類型
string
定義文字軌邊緣 (邊框) 類型。
值 |
|
---|---|
無 |
string 文字周圍不會顯示任何邊緣。 |
輪廓線 |
string 文字周圍會顯示實線外框。 |
DROP_SHADOW |
string 文字周圍會淡出陰影。 |
已提高 |
string 文字會與背景相強調或凸起。 |
已淘汰 |
string 應用程式在背景上呈現了去模糊化的文字。 |
TextTrack 字型一般家庭
string
在文字軌中未定義字型時使用的通用字型系列。
值 |
|
---|---|
SANS_SERIF (沙烏地裡亞爾) |
string 使用 Sans-Se 字型。 |
MONOSPACED_SANS_SERIF |
string 使用單行空格格式。 |
SERIF (塞爾維亞) |
string 使用 Serif 字型。 |
MONOSPACED_SERIF |
string 使用單行線性字型。 |
基本 |
string 使用手作風格的字型。 |
含量 |
string 使用草寫字型。 |
SCAPALL_CAPITALS |
string 使用小型大寫字母。 |
文字音軌字型樣式
string
文字軌字型樣式。
值 |
|
---|---|
一般 |
string 未修改的字體。 |
頻道 |
string 粗體樣式。 |
BOLD_YES |
string 同時套用粗體與斜體樣式。 |
兒童 |
string 斜體樣式。 |
文字音軌類型
string
文字音軌類型 (依循 HTML5 文字音軌類型定義)。
值 |
|
---|---|
字幕 |
string 對話的語音轉錄或翻譯內容,適合觀眾使用,但無法讓觀眾瞭解到的內容,例如,因為觀眾不瞭解媒體資源的配樂語言。 |
說明文字 |
string 對話的語音轉錄、翻譯、相關音樂提示和其他相關音訊資訊,適用於靜音音效 (例如靜音或使用者聽障)。字幕會顯示在影片上。 |
說明 |
string 媒體資源影片元件的文字說明,在視覺元件無法使用時進行音訊合成 (例如,因為使用者與螢幕沒有互動,或使用者因視覺上的功能受損)。說明會合成為獨立的音軌。 |
章節 |
string 章節標題,用來瀏覽媒體資源。 |
中繼資料 |
string 可透過指令碼使用的曲目。 |
文字視窗視窗類型
string
文字軌視窗類型。
值 |
|
---|---|
無 |
string |
一般 |
string |
ROUNDED_CORNERS |
string |
追蹤類型
string
媒體曲目類型。
值 |
|
---|---|
文字 |
string 文字軌。 |
音軌 |
string 音軌。 |
影片 |
string 視訊軌。 |
使用者操作
string
使用者動作。
值 |
|
---|---|
LIKE |
string 使用者表示自己對目前播放的內容表示喜歡。 |
不喜歡 |
string 使用者表示對目前播放的內容表示不喜歡。 |
追蹤 |
string 使用者想要追蹤目前播放的內容,或為內容加上星號。 |
取消追蹤 |
string 使用者想要停止追蹤目前正在播放的內容。 |
檢舉 |
string 使用者檢舉目前播放不當內容的內容。 |
略過 |
string 使用者想要略過目前播放的廣告。 |
歌詞 |
string 使用者想要顯示目前播放歌詞的歌詞。 |
使用者動作內容
string
UserAction
的情境資訊。
值 |
|
---|---|
UNKNOWN_CONTEXT |
string |
追蹤 |
string |
專輯 |
string |
藝人 |
string |
播放清單 |
string |
劇集 |
string |
系列 |
string |
電影 |
string |
頻道 |
string |
小組 |
string |
播放器 |
string |
教練 |
string |
屬性
說明文字 MIME 類型
string
說明文字音軌 MIME 類型。
值 |
|
---|---|
CEA608 |
string CEA 608 |
TTML |
string TTML |
影片觀看率 |
string 影片觀看率 |
TTML_MP4 |
string TTML MP4 |
指令
數字
用於設定或擷取 cast.framework.messages.MediaStatus#supportedMediaCommands 應用程式所支援的媒體指令的位元遮罩值清單。
值 |
|
---|---|
暫停 |
數字 暫停指令。 |
查看 |
數字 搜尋指令。 |
STREAM_VOLUME |
數字 串流磁碟區指令。 |
STREAM_MUTE |
數字 串流磁碟區指令。 |
所有_BASIC_MEDIA |
數字 所有基本媒體。包含必要的指令 |
待播清單 |
數字 佇列的下一個指令。 |
QUEUE_PREV |
數字 佇列前一項指令。 |
QUEUE_SHUFFLE |
數字 佇列重組指令。 |
QUEUE_REPEAT_ALL |
數字 將 YouTube 佇列重複播放。 |
QUEUE_REPEAT_ONE |
數字 將「重複播放」模式排入佇列。 |
QUEUE_REPEAT |
數字 佇列重複模式。 |
略過 |
數字 略過 AD 指令。 |
編輯 |
數字 編輯音軌指令。 |
PLAYBACK_RATE |
數字 播放速率指令。 |
LIKE |
數字 使用者動作喜歡按鈕。 |
不喜歡 |
數字 使用者操作不喜歡指令。 |
追蹤 |
數字 使用者動作 遵循指令。 |
取消追蹤 |
數字 使用者動作「取消追蹤」指令。 |
STREAM_TRANSFER |
數字 串流傳輸指令。 |
歌詞 |
數字 歌詞指令。 |
容器類型
數字
容器中繼資料的類型。
值 |
|
---|---|
GENERIC_CONTAINER |
數字 適合大多數媒體類型的通用範本。由 cast.framework.messages.ContainerMetadata 使用。 |
AUDIOBOOK_CONTAINER |
數字 有聲書的中繼資料。 由 cast.framework.messages.AudiobookContainerMetadata 使用。 |
- 另請參閱
- cast.framework.messages.QueueData.containerMetadata
內容篩選模式
string
代表內容篩選模式。
值 |
|
---|---|
FILTER_EXPLICIT |
string 請勿播放煽情露骨內容。 |
錯誤原因
string
代表媒體錯誤訊息原因。
值 |
|
---|---|
INVALID_COMMAND |
string 當指令無效或未執行時傳回。 |
INVALID_PARAMS 無效 |
string 當參數無效或缺少必要參數時,系統會傳回此值。 |
INVALID_MEDIA_SESSION_ID |
string 媒體工作階段不存在時傳回。 |
SKIP_LIMIT_REACHED (已略過) |
string 因已達略過上限而無法略過更多項目時,系統會傳回這個值。 |
不支援 |
string 當應用程式不支援此要求時傳回。 |
不支援語言 |
string 不支援您要求的語言時傳回。 |
END_OF_QUEUE |
string 因無法返回第一個項目,或超過佇列中的最後一個項目而無法略過。 |
DUPLICATE_REQUEST_ID |
string 要求 ID 重複時傳回 (接收端正在處理同一個 ID 的要求)。 |
VIDEO_DEVICE_REQUIRED |
string 由於需要有影片的裝置,所以無法完成要求時傳回。 |
PREMIUM_ACCOUNT_REQUIRED |
string 當要求成功傳送付費帳戶時,會傳回此值。 |
應用程式錯誤 |
string 當應用程式狀態無效時,會傳回此值。 |
AUTHENTICATION_EXPIRED |
string 當驗證因過期 (例如使用者變更密碼或撤銷憑證) 而失效時,系統會傳回這個代碼。 |
CONCURRENT_STREAM_LIMIT |
string 偵測到太多並行串流時傳回。 |
PARENTAL_CONTROL_RESTRICTED |
string 因受家長監護功能保護而封鎖內容時傳回的內容。 |
CONTENT_FILTERED |
string 因篩選器因內容遭到封鎖而傳回 。 |
NOT_AVAILABLE_IN_REGION |
string 因地區無法使用而遭封鎖的內容傳回。 |
CONTENT_ALREADY_PLAYING |
string 要求的內容已在播放時傳回。 |
INVALID_REQUEST |
string 當要求無效時傳回。 |
GENERIC_LOAD_ERROR |
string 載入要求發生間歇性問題時傳回。 |
ErrorType
string
代表媒體錯誤訊息類型。
值 |
|
---|---|
INVALID_player_STATE |
string 因播放器狀態無效而無法執行要求時傳回 。 |
LOAD_FAILED |
string LOAD 要求失敗時傳回。 |
LOAD_CANCELLED |
string 當第二次傳入的 LOAD 要求取消 LOAD 要求時,會傳回此值。 |
INVALID_REQUEST |
string 當要求無效時傳回。 |
錯誤 |
string 一般錯誤,適用於任何其他錯誤案例。 |
ExtendedPlayerState
string
擴充玩家狀態資訊。
值 |
|
---|---|
載入中 |
string 玩家處於「載入中」狀態。 |
焦點狀態
string
聚焦狀態:
值 |
|
---|---|
INFF |
string 接收器正在對焦。 |
NOT_IN_FOCUS |
string 接收器未對焦,其他活動已啟用。 |
GetStatusOptions
數字
GetStatusOptions
會決定必須在 GET_STATUS
訊息的媒體狀態回應中加入的資料量。
值 |
|
---|---|
沒有相關資料 |
數字 請勿加入中繼資料標記。 |
NO_QUEUE_ITEMS 個 |
數字 請勿加入佇列項目旗標。 |
HdrType
string
代表影片高動態範圍 (HDR) 類型。
值 |
|
---|---|
SDR |
string 標準動態範圍。 |
高動態範圍 |
string 高動態範圍。 |
DV |
string Dolby Vision。 |
HlsSegmentFormat
string
HLS 音訊片段的格式。
值 |
|
---|---|
進階音訊編碼 |
string AAC 打包的音訊基本串流。 |
應用程式廣告活動 3 |
string AC3 音訊音訊基本串流。 |
MP3 |
string MP3 音訊音訊基本串流。 |
疑難排解 |
string MPEG-2 傳輸串流。 |
區域服務合約 |
string AAC 低複雜度包含 MPEG-2 傳輸串流 (AAC-LC)。 |
TS_HE_AAC |
string AAC 高效封包 MPEG-2 傳輸串流 (HE-AAC)。 |
E_AC3 |
string E-AC3 音訊音訊基本串流。 |
FMP4 |
string 採用 ISO BMFF CMAF 片段 MP4 格式的音訊。 |
HlsVideoSegmentFormat
string
HLS 影片片段的格式。
值 |
|
---|---|
MPEG2_TS |
string MPEG-2 傳輸串流。支援 AVC。 |
FMP4 |
string 影片採用 ISO BMFF CMAF 片段 MP4。支援 AVC 和 HEVC。 |
放置原因
string
玩家處於閒置狀態的原因。
值 |
|
---|---|
CANCELLED |
string 寄件者使用 STOP 指令要求停止播放。 |
INTERRUPTED |
string 一位寄件者使用 LOAD 指令要求播放不同媒體。 |
完成 |
string 媒體播放完成。 |
錯誤 |
string 媒體因錯誤而中斷,例如,如果播放器因網路錯誤而無法下載媒體,就可能發生這種狀況。 |
媒體類別
string
媒體類別。
值 |
|
---|---|
音軌 |
string 媒體只能播放音訊。 |
影片 |
string 媒體為影片和音訊 (預設)。 |
圖片 |
string 媒體就是圖片。 |
MessageType
string
代表媒體訊息類型。
值 |
|
---|---|
媒體狀態 |
string 目前的媒體狀態的外寄郵件。 訊息類型為 cast.framework.messages.MediaStatus。 |
CLOUD_STATUS |
string 將媒體狀態的外寄郵件傳送至雲端寄件者。 訊息類型為 cast.framework.messages.CloudMediaStatus。 |
QUEUE_CHANGE |
string 佇列變更的外寄郵件。訊息類型為 cast.framework.messages.QueueChange。 |
QUEUE_ITEMS 個 |
string 佇列項目資訊的外寄郵件。訊息類型為 cast.framework.messages.ItemsInfo。 |
QUEUE_ITEM_IDS |
string 佇列 ID 清單的外寄郵件。訊息類型為 cast.framework.messages.QueueIds。 |
GET_STATUS |
string 要求取得目前的媒體狀態。 訊息類型為 cast.framework.messages.GetStatusRequestData。 |
裝載 |
string 要求載入媒體。 訊息類型為 cast.framework.messages.LoadRequestData。 |
暫停 |
string 要求暫停播放器。 訊息類型為 cast.framework.messages.RequestData |
停止 |
string 要求停止播放播放器。 訊息類型為 cast.framework.messages.RequestData。 |
播放 |
string 繼續播放。 訊息類型為 cast.framework.messages.RequestData。 |
略過 |
string 要求略過播放廣告。訊息類型為 cast.framework.messages.RequestData。 |
PLAY_AGAIN |
string 要求播放目前媒體。 訊息類型為 cast.framework.messages.RequestData。 |
查看 |
string 要求搜尋媒體。 訊息類型為 cast.framework.messages.SeekRequestData。 |
SET_PLAYBACK_RATE |
string 要求變更播放速率。 訊息類型為 cast.framework.messages.SetplayRateRequestData。 |
預設值 |
string 要求變更目前的媒體音量。 訊息類型為 cast.framework.messages.VolumeRequestData。 |
EDIT_TRACKS_INFO |
string 要求變更播放文字或音軌。 訊息類型為 cast.framework.messages.EditTracksInfoRequestData。 |
EDIT_AUDIO_TRACKS |
string 要求變更播放音軌。 訊息類型為 cast.framework.messages.EditAudioTracksRequestData。 |
預測 |
string 要求預先快取資料。訊息類型為 cast.framework.messages.PrecacheRequestData。 |
預載 |
string 要求預先載入項目。訊息類型為 cast.framework.messages.PreloadRequestData。 |
QUEUE_LOAD |
string 要求載入佇列。訊息類型為 cast.framework.messages.QueueLoadRequestData。 |
QUEUE_INSERT |
string 要求插入佇列。訊息類型為 cast.framework.messages.QueueInsertRequestData。 |
QUEUE_UPDATE |
string 要求更新佇列。 訊息類型為 cast.framework.messages.QueueUpdateRequestData。 |
QUEUE_REMOVE |
string 要求從佇列中移除。 訊息類型為 cast.framework.messages.QueueRemoveRequestData。 |
QUEUE_REORDER |
string 要求重新排序佇列。訊息類型為 cast.framework.messages.QueueReorderRequestData。 |
待播清單 |
string 要求佇列中的下一個項目。當接收器從傳送端收到這則訊息時,訊息會對應至具有 |
QUEUE_PREV |
string 要求佇列中的上一個項目。當接收器從傳送端收到這則訊息時,訊息會對應至具有 |
QUEUE_GET_ITEM_RANGE |
string 要求擷取佇列中的項目。訊息類型為 cast.framework.messages.FetchItemsRequestData。 |
QUEUE_GET_ITEMS |
string 要求取得項目資訊。訊息類型為:cast.framework.messages.GetItemsInfoRequestData。 |
QUEUE_GET_ITEM_IDS |
string 要求取得佇列 ID。訊息類型為 cast.framework.messages.RequestData。 |
QUEUE_SHUFFLE |
string 要求隨機播放佇列。訊息類型為 cast.framework.messages.RequestData。 |
SET_CREDENTIALS |
string 設定使用者憑證。訊息類型為 cast.framework.messages.SetCredentialsRequestData。 |
LOAD_BY_ENTITY |
string 依實體 ID 載入媒體。訊息類型為 cast.framework.messages.LoadByEntityRequestData。 |
使用者動作 |
string 按照下列方式處理使用者動作: 訊息類型為 cast.framework.messages.UserActionRequestData。 |
DISPLAY_STATUS |
string 在螢幕上顯示媒體狀態。 訊息類型為 cast.framework.messages.DisplayStatusRequestData。 |
FOCUS_STATE |
string 接收端應用程式焦點狀態已變更。訊息類型為 cast.framework.messages.FocusStateRequestData。 |
CUSTOM_COMMAND |
string 處理自訂應用程式指令。 訊息類型為 cast.framework.messages.CustomCommandRequestData。 |
STORE_SESSION |
string 儲存工作階段指令。訊息類型為 cast.framework.messages.StoreSessionRequestData。 |
RESUME_SESSION 賽程 |
string 繼續工作階段指令。訊息類型為 cast.framework.messages.ContinueSessionRequestData。 |
SESSION_STATE |
string StoreSession 的回應類型。訊息類型為 cast.framework.messages.StoreSessionResponseData。 |
中繼資料類型
數字
媒體中繼資料的類型,
值 |
|
---|---|
一般 |
數字 適合大多數媒體類型的通用範本。由 cast.framework.messages.GenericMediaMetadata 使用。 |
電影 |
數字 完整電影。 由 cast.framework.messages.MovieMediaMetadata 使用。 |
電視節目 |
數字 電視影集的劇集。 由 cast.framework.messages.TvShowMediaMetadata 使用。 |
音樂曲目 |
數字 音樂曲目。 由 cast.framework.messages.MusicTrackMediaMetadata 使用。 |
相片 |
數字 |
音訊轉錄 |
數字 章節。 由 cast.framework.messages.AudiobookChapterMediaMetadata 使用。 |
- 另請參閱
- cast.framework.messages.MediaInformation.metadata
玩家狀態
string
代表玩家狀態。
值 |
|
---|---|
閒置 |
string 玩家處於閒置狀態。閒置狀態表示沒有有效的播放作業。一般來說,玩家會在收到 LOAD 要求之前或播放完成後,才啟動 Cast 應用程式。播放器根據 cast.framework.messages.MediaStatus 中設定的 cast.framework.messages.IdleReason,轉換為這個狀態。 |
播放中 |
string 玩家處於 PLAYING 狀態。 |
已暫停 |
string 玩家處於「已暫停」狀態。 |
緩衝處理中 |
string 玩家處於「BUFFERING」狀態。 |
佇列變更類型
string
QUEUE_CHANGE
則外寄郵件使用的佇列變更類型。
值 |
|
---|---|
插入 |
string 佇列已插入項目。 |
移除 |
string 佇列已移除項目。 |
ITEMS_CHANGE |
string 已變更項目清單。 |
更新 |
string 佇列已進行更新並傳送新的已排序清單。 |
沒有變化 |
string 佇列沒有變更。當多個傳送者要求取得相同的資料時,這會用來回應。 |
佇列類型
string
媒體容器/佇列的類型。
值 |
|
---|---|
專輯 |
string 音樂專輯。 |
播放清單 |
string 音樂播放清單,例如私人播放清單、公開播放清單或自動產生的播放清單。 |
手冊 |
string 有聲書。 |
RADIO_STATION |
string 傳統廣播電台。 |
PODCAST_SERIES |
string Podcast 系列節目。 |
TV_SERIES |
string 電視影集。 |
VIDEO_PLAYLIST |
string 影片播放清單。 |
LIVE_TV |
string 直播電視頻道。 |
電影 |
string 電影。 |
重複模式
string
佇列中所有項目都播放完畢時的行為。
值 |
|
---|---|
REPEAT_OFF (關閉) |
string 佇列結束時,媒體工作階段就會終止。 |
重複 |
string 佇列中的所有項目都將無限期播放,當最後一個項目播放完畢時,就會再次播放第一個項目。 |
重複 |
string 系統會重複播放目前的項目。 |
REPEAT_ALL_AND_SHUFFLE |
string 佇列中的所有項目都會無限期地播放,當最後一個項目播放完畢時,就會再次播放第一個項目 (清單會由接收器先隨機播放)。 |
SeekContinueState
string
代表 SEEK 要求之後的播放狀態。
值 |
|
---|---|
PLAYBACK_START |
string 這會強制啟動媒體。 |
PLAYBACK_PAUSE |
string 這會強制暫停媒體。 |
串流通訊協定類型
數字
串流通訊協定類型。
值 |
|
---|---|
不明 |
數字 不明的串流通訊協定類型。 |
MPEG_DASH |
數字 MPEG-DASH (透過 HTTP 的動態自動調整串流) 通訊協定類型。 |
HTTP 即時串流 |
數字 HLS (HTTP 即時串流) 通訊協定類型。 |
SMOOTH_STREAMING |
數字 流暢串流通訊協定類型。 |
串流類型
string
代表串流類型。
值 |
|
---|---|
已購買 |
string VOD 和 DVR 內容。 |
直播 |
string 直播線性串流內容。 |
無 |
string |
文字軌邊緣類型
string
定義文字軌邊緣 (邊框) 類型。
值 |
|
---|---|
無 |
string 文字周圍不會顯示任何邊緣。 |
輪廓線 |
string 文字周圍會顯示實線外框。 |
DROP_SHADOW |
string 文字周圍會淡出陰影。 |
已提高 |
string 文字會與背景相強調或凸起。 |
已淘汰 |
string 應用程式在背景上呈現了去模糊化的文字。 |
TextTrack 字型一般家庭
string
在文字軌中未定義字型時使用的通用字型系列。
值 |
|
---|---|
SANS_SERIF (沙烏地裡亞爾) |
string 使用 Sans-Se 字型。 |
MONOSPACED_SANS_SERIF |
string 使用單行空格格式。 |
SERIF (塞爾維亞) |
string 使用 Serif 字型。 |
MONOSPACED_SERIF |
string 使用單行線性字型。 |
基本 |
string 使用手作風格的字型。 |
含量 |
string 使用草寫字型。 |
SCAPALL_CAPITALS |
string 使用小型大寫字母。 |
文字音軌字型樣式
string
文字軌字型樣式。
值 |
|
---|---|
一般 |
string 未修改的字體。 |
頻道 |
string 粗體樣式。 |
BOLD_YES |
string 同時套用粗體與斜體樣式。 |
兒童 |
string 斜體樣式。 |
文字音軌類型
string
文字音軌類型 (依循 HTML5 文字音軌類型定義)。
值 |
|
---|---|
字幕 |
string 對話的語音轉錄或翻譯內容,適合觀眾使用,但無法讓觀眾瞭解到的內容,例如,因為觀眾不瞭解媒體資源的配樂語言。 |
說明文字 |
string 對話的語音轉錄、翻譯、相關音樂提示和其他相關音訊資訊,適用於靜音音效 (例如靜音或使用者聽障)。字幕會顯示在影片上。 |
說明 |
string 媒體資源影片元件的文字說明,在視覺元件無法使用時進行音訊合成 (例如,因為使用者與螢幕沒有互動,或使用者因視覺上的功能受損)。說明會合成為獨立的音軌。 |
章節 |
string 章節標題,用來瀏覽媒體資源。 |
中繼資料 |
string 可透過指令碼使用的曲目。 |
文字視窗視窗類型
string
文字軌視窗類型。
值 |
|
---|---|
無 |
string |
一般 |
string |
ROUNDED_CORNERS |
string |
追蹤類型
string
媒體曲目類型。
值 |
|
---|---|
文字 |
string 文字軌。 |
音軌 |
string 音軌。 |
影片 |
string 視訊軌。 |
使用者操作
string
使用者動作。
值 |
|
---|---|
LIKE |
string 使用者表示自己對目前播放的內容表示喜歡。 |
不喜歡 |
string 使用者表示對目前播放的內容表示不喜歡。 |
追蹤 |
string 使用者想要追蹤目前播放的內容,或為內容加上星號。 |
取消追蹤 |
string 使用者想要停止追蹤目前正在播放的內容。 |
檢舉 |
string 使用者檢舉目前播放不當內容的內容。 |
略過 |
string 使用者想要略過目前播放的廣告。 |
歌詞 |
string 使用者想要顯示目前播放歌詞的歌詞。 |
使用者動作內容
string
UserAction
的情境資訊。
值 |
|
---|---|
UNKNOWN_CONTEXT |
string |
追蹤 |
string |
專輯 |
string |
藝人 |
string |
播放清單 |
string |
劇集 |
string |
系列 |
string |
電影 |
string |
頻道 |
string |
小組 |
string |
播放器 |
string |
教練 |
string |