支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    CMS API 視頻場參考

    這是對由 CMS API.

    視頻領域

    視頻場
    場 類型 產品描述
    account_id 串 Video Cloud 帳戶ID
    ad_keys 串 字符串，代表分配給視頻的廣告鍵/值對。 鍵/值對的格式設置為鍵=值，並用與號分隔。 例如： "adKeys": "category=sports&live=true"
    clip_source_video_id 串 裁剪產生該視頻的源視頻的ID或 null 如果該視頻不是另一個視頻的剪輯。
    complete 布爾 處理是否完成-注意：創建新視頻時，complete屬性將自動設置為 false。 視頻存在一個副本時，complete屬性將自動設置為 true
    created_at 數字，從紀元開始的毫秒數 在視頻中創建視頻時 Video Cloud 系統
    created_by 對象 有關創建視頻的人的信息（如果有）
    cue_points 地圖陣列 提示點圖數組
    custom_fields 字段-值對映射（字符串） 為視頻設置了自定義字段值-請注意， 不 該視頻的價值未包含在此地圖中； 自定義字段值的最大長度為1024個單字節字符
    dash_manifest_id 串 DASH清單的系統ID
    delivery_type 串 視頻的投放類型：
    • dynamic_origin -動態交付
    • live_origin -來自Brightcove的直播 Live
    • remote -資產
    • static_origin -舊版攝取系統
    • unknown -無法確定（可能意味著視頻沒有可播放的演繹形式）
    description 串; 代替舊的簡短描述 視頻的簡短描述（最大長度：248個單字節字符）
    digital_master_id 串 數字主站的系統ID
    drm_disabled 布爾 對於啟用DRM的帳戶，將其設置為true將防止視頻被DRM打包。 如果帳戶未啟用DRM，則不會顯示此字段。
    duration 數，毫秒 視頻的持續時間（以毫秒為單位）
    economics 字符串，必須是有效的枚舉值之一 “ AD_SUPPORTED”（默認）或“ FREE”
    folder_id 串 視頻所屬文件夾的ID
    geo [1-3] 屬性值對映射 視頻的地理限制屬性
    has_digital_master 布爾 視頻是否具有可用於重新轉碼的存檔母帶。 請注意，如果您使用此字段測試視頻是否可以重新轉碼，則共享視頻不可靠。 如果視頻已共享到帳戶，則需要同時測試 has_digital_master = true 和 sharing.by_external_acct = false
    id 串 影片編號
    images 屬性值對映射 有關海報和縮略圖的信息圖
    link 屬性值對映射 相關鏈接屬性的地圖
    long_description 串 詳細說明（最多5000個字符）
    name 串 視頻名稱（最大長度：248個單字節字符）
    offline_enabled 布爾 視頻是否已啟用離線播放
    original_filename 串 提取的視頻文件的名稱-對於遠程資產視頻將為空
    projection 串 360°視頻的映射投影，例如“矩形”
    published_at 串 ISO-8601日期時間字符串，指示視頻何時發布-請注意，此字段可寫； 默認情況下，它設置為視頻首次激活的日期。
    reference_id 串 用戶指定的ID 唯一地標識視頻，限制為150個字符。 referenceId可以用作在另一個系統中標識此視頻的外鍵。 參考ID不得包含空格，逗號或特殊字符。
    schedule [1-1] 屬性值對映射 視頻可用性的開始和結束日期時間圖
    sharing 屬性值對映射 視頻共享屬性的地圖
    smooth_client_manifest_id 串 平滑清單的系統ID
    smooth_server_manifest_id 串 平滑清單服務器的系統標識
    state [1-4] 串 活動，不活動，待處理，已刪除
    tags [1-5] 標籤數組（字符串） 分配給視頻的標籤數組
    text_tracks HTML5樣式的文本軌道的數組 分配給視頻的文本軌道（WebVTT文件）的數組
    updated_at 日期時間字符串 視頻的上次修改日期 [1-2]
    updated_by 對象 有關誰最後更新了視頻的信息（如果有）

    筆記

    • [1-1] 請注意，預定視頻是 不 在計劃的可用性時段之外處於非活動狀態
    • [1-2] 修改可能已由用戶或 Video Cloud 系統
    • [1-3] 地理位置限制是付費的附加功能 Video Cloud; 如果您想購買地理過濾功能，請聯繫您的客戶經理
    • [1-4] state 可以設置為 ACTIVE or INACTIVE，但 不 至 PENDING or DELETED.
    • [1-5] 請注意標籤的以下限制：
      • 標籤最多可包含128個字符。 如果任何標籤的字符數超過128個，則嘗試保存更改時將顯示錯誤消息
      • 標籤不能包含逗號。 例如，一個標籤 roof, attic + front yard 不受支持
      • 一個視頻的標籤總數不能超過1200個
      • 僅將大小寫不同的標籤（小寫，大寫）視為相同的標籤，並且大小寫會自動與原始標籤匹配-區分大小寫的問題需要從外部處理 Video Cloud，例如，使用JavaScript方法修改字符串

    視頻源字段

    下表顯示了來源（信譽）字段。

    動態投放來源

    場 類型 產品描述
    src 串 來源網址
    type 串 分段視頻類型，通常 application/x-mpegURL （對於HLS）或 application/dash+xml （對於DASH）
    ext_x_version 串 HLS版本-僅適用於HLS源
    profiles 串 配置文件-僅適用於DASH源
    codec 串 視頻編解碼器-僅適用於MP4源
    container 串 視頻容器-僅適用於MP4源
    duration 整型 持續時間（以毫秒為單位）-僅適用於MP4來源
    encoding_rate 整型 BPS中的編碼率-僅適用於MP4來源
    height 整型 幀高（以像素為單位）-僅適用於MP4源
    size 整數 文件大小（以字節為單位）-僅適用於MP4源
    uploaded_at 串 以ISO-8601日期格式上傳視頻的日期
    width 整型 幀寬度（以像素為單位）-僅適用於MP4源

    舊版攝取源（翻譯）

    場 類型
    src 字符串網址， 僅適用於PD網站資產和HLS資產
    app_name 串， 僅適用於流媒體網絡資產
    stream_name 串， 僅適用於流媒體網絡資產
    codec 串
    container 串
    duration 長？
    encoding_rate 長？
    height 整型
    id 串
    size 長
    uploaded_at ISO-8601日期格式的字符串
    width 整型

    舊版攝取HLS清單

    場 類型
    src 字串網址
    type 字符串（application / x-mpegURL）
    codec 串
    container 串

    舊版攝取HDS清單

    場 類型
    asset_id 串
    src 字串網址
    type 字符串（應用程序/ f4m）

    舊版攝取Dash清單

    場 類型
    asset_id 串
    SRC 字串網址
    type 字符串（application / dash + xml）

    舊版攝取平滑清單（服務器和客戶端）

    場 類型
    asset_id 串
    src 字串網址
    type 字符串（application / vnd.ms-sstr + xml）

    提示點字段

    下表顯示了提示點的字段。

    提示點字段
    場 類型 產品描述
    id 串 提示點的系統ID
    force_stop 布爾 視頻是否應在提示點停止
    metadata 串; 僅代碼點 與提示點關聯的元數據字符串
    name 串 提示點名稱
    time 浮球 從視頻開始算起的提示點時間（以秒為單位）
    type 串 提示點類型（ AD or DATA)

    地理領域

    下表顯示了地理對象字段。

    地理過濾字段
    場 類型 產品描述
    countries 國家/地區代碼字符串數組 允許或不允許播放視頻的國家/地區的ISO 3166 2字母代碼列表（https://www.iso.org/obp/ui/）的數組
    exclude_countries 布爾 如果為true，則將國家/地區數組視為被排除在外的國家/地區列表
    restricted 布爾 是否為此視頻啟用了地理過濾

    圖像場

    下表顯示圖像對象字段

    海報領域

    場 類型 產品描述
    images.thumbnail 地圖 映射縮略圖屬性
    poster 對象 視頻海報的屬性（又稱視頻靜止圖像）
    poster.asset_id 串 默認海報的系統ID
    poster.src 字串網址 默認海報的URL
    poster.sources 地圖陣列 海報地圖陣列
    poster.sources.asset_id 串 海報的系統ID
    poster.sources.src 字串網址 海報的網址
    poster.sources.height 數 海報高度（以像素為單位）
    poster.sources.width 數 海報寬度（以像素為單位）

    縮略圖字段

    場 類型 產品描述
    thumbnail 對象 視頻縮略圖的屬性
    thumbnail.asset_id 串 默認縮略圖的系統ID
    thumbnail.src 字串網址 默認縮略圖的源URL
    thumbnail.sources 地圖陣列 縮略圖的地圖數組
    thumbnail.sources.asset_id 串 縮略圖的系統ID
    thumbnail.sources.src 字串網址 縮略圖的URL
    thumbnail.sources.height 數 圖像高度（以像素為單位）
    thumbnail.sources.width 數 圖像寬度（以像素為單位）

    下表顯示了鏈接對象字段。

    連結欄位
    場 類型 產品描述
    url 串 相關鏈接網址
    text 串 相關鏈接文字

    時間表欄位

    下表顯示了計劃對象的字段

    計劃字段
    場 類型 產品描述
    ends_at ISO-8601日期格式的字符串 視頻無法觀看的日期時間
    starts_at ISO-8601日期格式的字符串 視頻可供觀看的日期時間

    共享領域

    下表顯示了共享對象字段

    共享領域
    場 類型 產品描述
    by_external_acct 布爾 如果該視頻是通過其他帳戶共享的，則為true。
    by_id 串 發起共享的帳戶ID
    source_id 串 原始視頻的視頻ID（共享者的副本）
    to_external_acct 布爾 如果此視頻與其他帳戶共享，則為True
    by_reference 布爾 確實，該視頻是通過參考共享的（將始終是 true 通過共享的視頻 CMS API)

    文字跟踪字段

    下表顯示了文本跟踪字段。

    場 類型 產品描述
    id 串 文字跟踪項的系統ID
    src 串 跟踪文件的地址（URL）
    srclang 串 曲目的語言，例如“ en”
    label 串 文本軌道集的用戶可讀標題
    kind 串 軌道的使用方式：“字幕”，“字幕”，“描述”，“章節”，“元數據”
    mime_type 串 文本軌道的mime類型，例如“ text / vtt”
    asset_id 串 跟踪文件的系統ID； 如果資產是遠程的，則為null
    in_band_metadata_track_dispatch_type 串 跟踪文件的系統ID； 如果資產是遠程的，則為null
    sources 排列 唯讀
    src 串 跟踪文件的地址（URL）
    default 布爾 指示默認情況下應啟用該軌道。 只能在一條軌道上為真。

    由字段創建

    下表顯示了 created_by 對象字段。

    由字段創建
    場 類型 產品描述
    type 串 更新程序的類型-可以是：
    • user -Studio中的用戶
    • api-key -通過API的用戶
    id 串 中的用戶ID Video Cloud 系統
    email 串 用戶的電子郵件地址在 Video Cloud 系統

    按字段更新

    下表顯示了 updated_by 對象字段。

    由字段更新
    場 類型 產品描述
    type 串 更新程序的類型-可以是：
    • user -Studio中的用戶
    • api-key -通過API的用戶
    id 串 中的用戶ID Video Cloud 系統
    email 串 用戶的電子郵件地址在 Video Cloud 系統
    頁面最後更新於12年2020月XNUMX日