（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）
要建立 VOD 轉檔請求，必須事先準備好某些資源，如字幕、影片檔案和浮水印（可選）。在提交編碼請求之前，確保這些所需資源可用非常重要。如果還沒有這些資源，則必須先將其上傳到影片庫。一旦上傳，就可以取得對應的 ID 並在 VOD 轉檔請求中使用。
以下是一個簡單的過程示意圖：
在確保所有所需資源都已存在並取得對應的 ID 後，您就可以使用這些 ID 建立 VOD 轉檔請求。 該請求可包括字幕、佇列類型、後設資料、安全控制、隱私設置、浮水印、網域管理、地區控制、DRM 和時間表。
POST /bv/cms/v1/vods
{
"name":"string",
"profile_set_id":"string",
"source":{
"type":"SOURCE_TYPE_UNSPECIFIED",
"library":{
"video":{
"id":"string"
},
"subtitles":[
{
"id":"string",
"name":"string",
"code":"string",
"display":"string"
}
]
},
"cloud_storage":{
"id":"string",
"file_path":"string",
"subtitles":[
{
"id":"string",
"name":"string",
"code":"string",
"display":"string"
}
]
}
},
"queue":"QUEUE_STANDARD",
"pte":{
"profile":"PTE_PROFILE_UNSPECIFIED"
},
"metadata":{
"short_description":"string",
"long_description":"string",
"labels":[
{
"name":"string"
}
]
},
"security":{
"privacy":{
"type":"SECURITY_PRIVACY_TYPE_UNSPECIFIED",
"token":{
"device_limit":0
}
},
"watermark":{
"enabled":true,
"type":"WATERMARK_TYPE_UNSPECIFIED",
"position":"WATERMARK_POSITION_UNSPECIFIED",
"image":{
"library_id":"string"
}
},
"domain_control":{
"enabled":true,
"domains":[
"string"
]
},
"protection":{
"type":"PROTECTION_TYPE_UNSPECIFIED"
},
"geo_control":[
"string"
]
},
"schedule":{
"enable":true,
"start_time":"2019-08-24T14:15:22Z",
"end_time":"2019-08-24T14:15:22Z"
},
"export":{
"cloud_storage":{
"id":"string"
}
}
}
下文將詳細介紹每個重要屬性：
資料來源
向 BlendVision 請求 VOD 轉檔時，我們需要指定媒體檔案的來源和字幕。
1. 確定來源類型
來源類型可以是以下類型之一：
-
SOURCE_TYPE_LIBRARY: 如果原始檔案是從本機檔案上傳 -
SOURCE_TYPE_CLOUD_STORAGE: 如果原始檔案是從指定的雲端儲存空間中複製。
2. 建立來源物件
根據來源類型，建立相應的來源物件。
如果來源類型為 SOURCE_TYPE_LIBRARY ，則按以下方式建立來源物件：
"source":{
"type":"SOURCE_TYPE_LIBRARY",
"library":{
"video":{
"id":"your_video_id_in_library"
}
}
}
如果來源類型為 SOURCE_TYPE_CLOUD_STORAGE，則按以下方式建立來源物件：
"source":{
"type":"SOURCE_TYPE_CLOUD_STORAGE",
"cloud_storage":{
"id":"your_cloud_storage_id",
"file_path":"/path/to/cloud/storage/file.mp4"
}
}
有關雲端存儲空間的更多詳情，請參閱 將 AWS S3 儲存空間用於影片。
3. 指定媒體檔案的字幕
需要先使用 /bv/cms/v1/library/files:upload 上傳字幕，並使用回應中的 uploaded_data.id 在來源物件中指定字幕。以下是一個如何指定字幕的範例：
"source":{
"type":"SOURCE_TYPE_LIBRARY",
"library":{
"video":{
"id":"6d706ee2-a1c2-41fe-9a68-b8ef23604f1a"
},
"subtitles":[
{
"id":"your_subtitles_id",
"name":"English",
"code":"en",
"display":"true"
}
]
}
}
有關字幕的更多資訊，請參閱 更新影片字幕 。
佇列
您可以通過將queue欄位設置為 QUEUE_STANDARD 或 QUEUE_PRIORITY ，為轉檔任務選擇標準佇列或快速佇列。請注意，如果您選擇處理轉檔任務，將被收取更高的費用。
PTE
您可以將 pte 物件中的 profile 欄位設置為 PTE_PROFILE_HIGH，爲轉檔任務啓用 PTE。 PTE 將適用於您選擇的 ProfileSet 中的每個配置檔案。
後設資料
通過提供簡短描述、詳細描述和標籤等附加資訊，BlendVision One 可以加強您的內容的分類、組織和搜索功能。
以下範例說明如何指定後設資料：
"metadata":{
"short_description":"string",
"long_description":"string",
"labels":[
{
"name":"string"
}
]
}
關於後設資料的更多資訊，請參考 此處 。
安全性
隱私權
通過指定授權訪問內容的地區或受眾來管理內容的可見性，確保符合許可協議和目標受眾限制。有關隱私的更多資訊，請參考 內容的可見性. 。
浮水印
在影片上疊加浮水印，以主張版權、阻止盜版和識別未經授權的使用，提供額外的內容保護。您可以啓用指定類型和位置的浮水印。有關啓用浮水印的更多資訊，請參考 浮水印 。
網域管理
將內容的發佈限制在已授權的網域內，確保您的內容只能在經過批准的網站和平台上訪問，降低未經授權發佈的風險。有關啓用網域管理的更多資訊，請參考 網域管理 。
地區控制
根據地區限制對內容的訪問，讓您可以鎖定特定市場並遵守內容發佈規定。有關啓用地區控制的更多資訊，請參閱 地區控制 。
DRM
通過實施 FairPlay、PlayReady 和 Widevine 等 DRM 技術，你可以加密內容並控制其播放，防止未經授權的複製和盜版。有關啓用 DRM 保護內容的更多資訊，請參考 數位版權管理 。
日程設定
在默認情況下，內容將始終可用；但是，您可以通過設置開始和結束時間，將內容的可用性限制在一定時間段內。
如果要安排可用性，可以使用帶有以下選項的 schedule 請求主體：
1. enable
這是一個布林值，用於確定是否啓用日程設定。
2. start_time 與 end_time
start_time 和 end_time 分别指定内容可用和不可用的日期和时间。 start_time 和 end_time 的格式均为 ISO 8601，即 YYYY-MM-DDTHH:MM:SSZ。
時區會自動檢測並設置為使用者所在的本地時區。這意味著，如果使用者所在的時區與伺服器所在的時區不同， start_time 和 end_time 將自動調整為與使用者所在的時區一致。
以下是一個請求主體的範例，它將影片的可播放時間安排為 2023 年 8 月 24 日 2:15:22 PM UTC 至 2023 年 8 月 31 日 2:15:22 PM UTC：
"schedule":{
"enable":true,
"start_time":"2023-08-24T14:15:22Z",
"end_time":"2023-08-31T14:15:22Z"
}
如果要編輯已排定影片的自定義日期和時間，可以在開始或結束時間之前編輯。之後，開始和結束時間將不可編輯了。
- 預定開始時間之前：如果尚未到預定開始時間，則可以編輯開始和結束時間。
- 預定結束時間之前：如果尚未到預定結束時間，您可以編輯結束時間。