即時 API：建立點播剪輯

概覽

剪輯是從實時流中提取的視頻。可以將它們發送到S3存儲桶，FTP站點或Video Cloud帳戶。該剪輯將創建為MP4視頻，並且在所有情況下都是發送到目的地的內容。如果是Video Cloud，MP4將由攝取系統進行轉碼，為視頻創建哪種格式的呈現將取決於所使用的攝取配置文件。

剪輯的定義是使用/vods端點。

剪輯可以通過幾種方式創建：

• 用stream_start_timecode和/或stream_end_timecode在SMPTE時間碼中為直播事件定義的- 請注意，這要求編碼器發送時間碼信息
• 用start_time和/或end_time相對於開始時間（stream_start_time）的整個直播活動
• 用start_time和/或end_time以紀元（Unix）時間定義（以秒為單位）
• 用duration
• Live API 和 Live Module 都支持從加密或受 DRM 保護的作業創建剪輯。

注意事項

1. 為了盡可能快地使剪輯可用，首先創建了一個段精確的剪輯，然後在可用時立即將其替換為幀精確的剪輯。
2. 如果指定duration，結果片段將如下所示：
   • 如果作業處於活動狀態並且仍然有效：（請求時間-持續時間）至（請求時間）
   • 如果作業完成：（finished_at -持續時間）至（finished_at）
3. 如果同時指定start_time和end_time：
   • 如果工作處於活動狀態並且仍然有效：只要大紀元時間窗口完全落在created_at和請求時間，將製作剪輯
   • 如果作業完成：只要Epoch時間窗口完全落在created_at和finished_at，將製作剪輯
4. 直播視頻片段使用智囊團將不包含廣告。
5. 活動結束後最多7天即可創建剪輯。對於SEP，它們可以創建到下一次激活或7天（以較短者為準）。
6. VOD API不會在流中添加任何內容。如果在300秒長的實時流中指定350，則輸出將為300秒長。
7. 您無需使用啟用DVR的直播就可以進行剪輯，因為直播是在廣播時存儲的，並且可以在事件結束後的7天內立即使用。
8. Brightcove Live剪輯只會產生與高分辨率輸出相同分辨率的剪輯。它不會匹配源輸入分辨率（除非與最高分辨率輸出相同）。

剪輯也可以發送到多個目的地：

• 一種Video Cloud帳戶
• FTP服務器
• 一個S3存儲桶

指定剪輯時，輸出必須包含要么一種url目的地要么一種videocloud對象，以詳細介紹視頻的創建和片段的攝取Video Cloud。

注意：剪輯可以在直播流運行時創建。為此，您需要以紀元時間或相對於時間定義片段的開始和結束時間開始直播時間。

身份證明

如果要將剪輯發送到的目標位置需要訪問憑據，則可以使用Live API的憑據操作來創建這些憑據。看到管理Live API的憑據更多細節。

端點

剪輯是通過發送POST請求：

https://api.bcovlive.io/v1/vods

要求正文- Video Cloud

示例1：相對於流開始的開始/結束時間

要求主體包括開始和結束時間，以及要傳送剪輯片段的詳細資料。以下是一個示例請求主體，它創建一個流的第三分鐘剪輯並將其發送到一個Video Cloud帳戶：

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs by stream from min 2 to min 3",
      "stream_start_time": 120,
      "stream_end_time": 180,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
          "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

在此示例中，我們將創建一分鐘持續時間的剪輯並將其發送到Video Cloud。我們為剪輯指定了名稱和幾個標籤，但未指定ingest profile進行重新轉碼，以便使用帳戶默認值，並指示Video Cloud在轉碼過程中從剪輯中捕獲縮略圖和海報圖像。

範例2：以大紀元時間開始/結束時間

要求主體包含 Epoch 時間的開始和結束時間，以及有關傳送剪輯片段的詳細資料。以下是一個示例請求主體，它創建一個流的第三分鐘剪輯並將其發送到一個Video Cloud帳戶：

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
    "outputs":[
      {
        "label": "60 secs - epoch time",
        "start_time": 1516652694,
        "end_time": 1516652754,
        "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
        "videocloud": {
          "video": {
          "name": "One Minute Clip",
          "tags": ["live", "clip"]
          },
            "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

在此示例中，我們將在特定的紀元時間（本例中為2018年1月22日格林尼治標準時間08:24:54）創建一分鐘持續時間的剪輯。

示例3：具有相對於流開始的開始時間的持續時間

請求主體包括持續時間和stream_start_time，以及有關將剪輯發送到何處的詳細信息。以下是一個示例請求主體，它創建一個流的第三分鐘剪輯並將其發送到一個Video Cloud帳戶：

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs from start time",
      "stream_start_time": 300,
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true,
        "profile": "valid-ingest-profile-name"
        }
      }
    }
  ]
}

在此示例中，我們將創建一個實時直播開始後5分鐘開始的一分鐘持續時間的剪輯。

示例4：沒有開始或結束時間的持續時間

要求主體包含 Epoch 時間的開始和結束時間，以及有關傳送剪輯片段的詳細資料。以下是一個示例請求主體，它創建一個流的第三分鐘剪輯並將其發送到一個Video Cloud帳戶：

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs - duration",
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
          "capture-images": true
        }
      },
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ]
}

在此示例中，我們將創建一個持續時間為一分鐘的剪輯。由於我們未指定開始時間或結束時間，因此將從實時流的最後60秒開始提取剪輯。

示例5：使用stream_start_timecode和stream_end_timecode

請求主體包括HH：MM：SS：FF時間碼中的開始和結束時間/幀，以及有關將剪輯發送到何處的詳細信息。請注意，要使用時間碼，編碼器必須正在發送時間碼。這是一個示例請求正文，它創建了一個流的50分鐘的片段並將其發送到Video Cloud帳戶：

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "Clipping using Timecode from-01:10:18:15 to-01:11:08:15",
      "stream_start_timecode": "01:10:18:15",
      "stream_end_timecode": "01:11:08:15",
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
          "name": "Fifty Minute Clip",
          "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true
        }
      }
    },
    "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
  ]
}

有關將剪輯發送到的一般信息Video Cloud

要查看哪些字段可以包含在video和ingest對象，請參閱Dynamic Ingest API Reference。

{
  "live_job_id":"",
  "outputs":[
    {
      "label": "last_30",
      "duration": 30,
      "url": "s3://YOUR_BUCKET_NAME/file_name.mp4",
      "credentials": "s3-credentials",
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ],
}

{
  "vod_jobs": [
    {
      "jvod_id": "9582606c50d84be5ad4bc104f2aa3360",
      "label": "last 60 secs of live job"
    }
  ],
  "live_job_id": "88ba5d87b61a4ef3a6dddabd0c38d319"
}