聯繫支持
系統狀態簡介
您可以攝取六種類型的圖像以進行關聯 Video Cloud 視頻：
- 海報
- 海報圖像顯示在 Brightcove Player 在用戶播放視頻之前。 它通常是從視頻捕獲的幀，但不是必須的。
- 縮略圖
- 縮略圖圖像顯示在播放列表，結束屏幕等中。 它通常是從視頻捕獲的幀，但不是必須的。
- 肖像
- 通常在電話和其他設備上以縱向模式用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 表 聯絡一位教師
- 廣場
- 通常用作通道徽標或網格顯示的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 表 聯絡一位教師
- 寬
- 通常在手機和其他設備上以橫向模式用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 表 聯絡一位教師
- 超寬
- 通常在電視等超寬顯示器上用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 表 聯絡一位教師
產品規格
下表提供了圖像規格。
| 類型 | 格式 | 長寬比（W / H） | 最小寬度（像素） |
|---|---|---|---|
| 海報 | jpg或png | 搭配影片 | 沒有 |
| 縮略圖 | jpg或png | 搭配影片 | 沒有 |
| 肖像 | jpg或png | 0.6667（2x3） | 500 |
| 廣場 | jpg或png | 1.0（1x1） | 500 |
| 寬 | jpg或png | 1.7778（16x9） | 2000 |
| 超寬 | jpg或png | 2.3333 21x9 | 2000 |
您可以通過兩種方法將基本海報和縮略圖圖像添加到視頻中， Dynamic Ingest API:
- 拍攝影像 在轉碼過程中位於視頻的中點
- 在攝取視頻的同時或單獨攝取圖像
格局
無論您要攝取視頻，圖像，WebVTT文件還是所有這些，動態攝取請求的設置都是相同的：
- 要求網址
-
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests - 認證
- 身份驗證需要以
Bearer令牌中Authorization標頭：Authorization: Bearer {access_token}
關於S3的注意事項
如果您的圖片是從受保護的S3存儲桶中提取的，則需要設置存儲桶策略以允許 Video Cloud 訪問文件。 看到 在S3上使用動態攝取 有關詳細信息。
多語言變體
您可以提供用於不同語言的圖像的不同版本。 這是由處理 Brightcove Beacon Brightcove Beacon 應用。 一般實施 Brightcove Player 當前需要定制開發。
圖片的語言在 language 屬性將在下一部分中詳細介紹。
攝取圖像
以下是為視頻添加自定義圖像的詳細信息。
請求正文中的圖像字段
攝取請求主體中的圖像被指定為對像數組。 下表中詳細介紹了對象屬性。
| 財產 | 產品描述 | 類型 | 需要的 | 例 |
|---|---|---|---|---|
url |
一個網址 Video Cloud 可以從中檢索圖像 | 串 |  |
https://mysite.com/videos/video123/images/poster.png |
language |
圖片中來自子標籤的語言代碼 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry （可以通過聯繫Brightcove支持為帳戶設置默認值） | 串 |  |
|
variant |
該圖像的類型： poster | thumbnail | portrait | square | wide | ultra-wide |
串 | |
wide |
height |
數 | |
2160 |
|
width |
數 | |
3840 |
{
"images":[
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/poster.jpg",
"variant": "poster",
"height": 1080,
"width": 1920
},
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/thumbnail.jpg",
"variant": "thumbnail",
"height": 108,
"width": 292
},
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/square.jpg",
"language": "de",
"variant": "square",
"height": 570,
"width": 570
},
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/wide.jpg",
"language": "fr",
"variant": "wide",
"height": 1440,
"width": 2560
},
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/portrait.jpg",
"language": "es",
"variant": "portrait",
"height": 1200,
"width": 800
},
{
"url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/ultra-wide.jpg",
"language": "hi",
"variant": "ultra-wide",
"height": 1646,
"width": 3840
}
]
}自動調整大小
當您通過Studio或Google+添加自定義海報和/或縮略圖時 Dynamic Ingest API， 默認 Video Cloud 將調整這些圖片的大小，以匹配該帳戶的默認“攝取配置文件”中定義的圖片大小。
請注意，調整大小和填充是唯一的修改 Video Cloud or Brightcove Beacon。 圖像永遠不會被裁剪。
覆蓋自動調整大小
如果要覆蓋此行為並具有 Video Cloud 保留實際的圖像尺寸，請按照下列步驟操作：
- 創建一個新的自定義攝取配置文件 您的帳戶（或修改現有的自定義配置文件）
- 包括具有以下內容的帖子和縮略圖的圖像副本： 究竟 這些
width和height值：{ "media_type": "image", "format": "jpg", "label": "poster", "width": 9999, "height": 9999 }, { "media_type": "image", "format": "jpg", "label": "thumbnail", "width": 9999, "height": 9999 } - 將此設置為默認配置文件 如果您始終希望以原始尺寸保存圖像，請選擇該帳戶。
現在，當您通過Studio或Dynamic Ingest添加自定義圖像時，它們將具有源圖像的原始尺寸。
拍攝影像
在轉碼過程中， Video Cloud 可以從視頻中點捕獲快照並將其另存為海報和縮略圖。
對於自定義攝取配置文件，圖像捕獲要求向您使用的攝取配置文件添加兩個特殊格式。 看到 提取配置文件中的圖像 聯絡一位教師
您還應該設置 capture-images 在您的請求數據中標記為 true 如果您希望在轉碼過程中從視頻中捕獲海報和縮略圖，但這是默認值 if 所選配置文件包括圖像副本。 （如果配置文件中沒有圖像副本，則默認為 capture-images is false.)
樣品請求數據：
{
"master": { "url": "http://learning-services-media.brightcove.com/videos/mp4/Bird_Titmouse.mp4" },
"profile": "multi-platform-standard-static",
"capture-images": true
}
提取配置文件中的圖像
以下是有關如何在提取配置文件中指定圖像再現的詳細信息。
| 財產 | 值 |
|---|---|
media_type |
“圖片” |
label |
“海報”或“縮略圖”（每個都需要翻譯） |
format |
“ png”或“ jpg” |
width |
數量（像素） |
height |
數量（像素） |
以下是這兩種格式的樣本數據：
{
"media_type": "image",
"format": "jpg",
"label": "poster",
"width": 1280,
"height": 720
},
{
"media_type": "image",
"format": "jpg",
"label": "thumbnail",
"width": 160,
"height": 90
}
檢索圖像數據
您可以使用 CMS API.
CMS API 將以 GET 請求 https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id} 或者，如果您只想要圖像數據， https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/images
無論哪種情況，響應中的圖像數據都將如下所示：
{
"thumbnail": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
"height": 90,
"width": 160
}
]
},
"poster": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
"height": 720,
"width": 1280
}
]
},
"portrait.es": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
"height": 1200,
"width": 800
}
]
},
"thumbnail.en": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
"height": 108,
"width": 292
}
]
},
"poster.en": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
"height": 1080,
"width": 1920
}
]
},
"square.de": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
"height": 570,
"width": 570
}
]
},
"ultra-wide.hi": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
"height": 1646,
"width": 3840
}
]
},
"wide.fr": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
"height": 1440,
"width": 2560
}
]
}
}限制
- 提取系統不允許在同一視頻上同時進行作業。 因此，如果您在視頻被攝取或重新轉換時嘗試上載圖像，則圖像上載將失敗。
- 目前，寬幅，方形，人像和超寬幅變體的圖像數據僅由 CMS API, 不 by Playback API 視頻請求。