本頁面由 Cloud Translation API 翻譯而成。

串連多部輸入影片

本頁面說明如何將多部輸入影片合併為單一輸出影片。您也可以修剪輸入影片的時間軸。

針對每部輸入影片，將 Input 物件新增至 inputs 陣列。每個 Input 物件都會定義關鍵字和相關輸入影片的 URI。您可以將選用的 PreprocessingConfig 物件新增至 Input，以便對輸入影片進行裁剪、填充或其他預先處理作業。inputs 陣列並未排序，您可以以任何順序新增輸入影片。

如要在輸出影片時間軸中新增輸入影片，請將 EditAtom 物件新增至 editList 陣列。editList 陣列已排序。這個陣列中指定的第一個輸入內容會優先用於輸出影片，接著是第二個輸入內容，以此類推。您可以透過鍵來識別輸入影片。

您也可以指定 startTimeOffset 和 endTimeOffset 來裁剪輸入的影片。這些欄位為選填。如果未指定這些欄位，系統會使用整部輸入影片。

以下設定會將兩部輸入影片串連成單一輸出影片。

"inputs": [
  {
    "key": "input1",
    "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO1"
  },
  {
    "key": "input2",
    "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO2"
  }
],
"editList": [
  {
    "key": "atom1",
    "inputs": [
      "input1"
    ],
    "startTimeOffset": "START_TIME_OFFSET1s",
    "endTimeOffset": "END_TIME_OFFSET1s"
  },
  {
    "key": "atom2",
    "inputs": [
      "input2"
    ],
    "startTimeOffset": "START_TIME_OFFSET2s",
    "endTimeOffset": "END_TIME_OFFSET2s"
  }
],

您可以將這項設定新增至工作範本，或納入臨時工作設定：

REST

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您在 IAM 設定中列出的 Google Cloud 專案 ID。
LOCATION：工作執行的位置。使用支援的地區之一。
顯示地區
- us-central1
- us-west1
- us-west2
- us-east1
- us-east4
- southamerica-east1
- northamerica-northeast1
- asia-east1
- asia-northeast1
- asia-northeast3
- asia-south1
- asia-southeast1
- australia-southeast1
- europe-west1
- europe-west2
- europe-west4
- me-west1
- me-central1
- me-central2
STORAGE_BUCKET_NAME：您建立的 Cloud Storage 值區名稱。
STORAGE_INPUT_VIDEO1：Cloud Storage 值區中要轉碼的影片名稱，例如 my-vid.mp4。這個欄位應考量您在儲存空間中建立的任何資料夾 (例如 input/my-vid.mp4)。這部影片會在輸出影片時間軸中優先使用。
START_TIME_OFFSET1：相對於第一個輸入影片時間軸的開始時間，以秒的刻度 (例如 0.0) 為單位。使用這個欄位，從影片開頭剪輯內容。
END_TIME_OFFSET1：相對於第一個輸入影片時間軸線的結束時間，以秒小數位數 (例如 8.1) 為單位。使用這個欄位，即可從影片結尾裁剪內容。
STORAGE_INPUT_VIDEO2：Cloud Storage 值區中要轉碼的影片名稱，例如 my-vid.mp4。這個欄位應考量您在儲存空間中建立的任何資料夾 (例如 input/my-vid.mp4)。這部影片會在輸出影片時間軸中使用第二次。
START_TIME_OFFSET2：相對於第二個輸入影片時間軸的開始時間，以秒的刻度 (例如 3.5) 為單位。使用這個欄位，從第二部影片的開頭剪輯內容。
END_TIME_OFFSET2：相對於第二個輸入影片時間軸線的結束時間，以秒的刻度 (例如 15) 為單位。使用這個欄位，從第二部影片的結尾裁剪內容。
STORAGE_OUTPUT_FOLDER：您要儲存已編碼影片輸出內容的 Cloud Storage 資料夾名稱。
注意：您不必在建立工作之前建立輸出資料夾物件。處理工作時，Transcoder API 會自動將您指定的資料夾名稱加在儲存至 Cloud Storage 的物件名稱前方。

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

cat > request.json << 'EOF'
{
  "config": {
    "inputs": [
      {
        "key": "input1",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO1"
      },
      {
        "key": "input2",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO2"
      }
    ],
    "editList": [
      {
        "key": "atom1",
        "inputs": [
          "input1"
        ],
        "startTimeOffset": "START_TIME_OFFSET1s",
        "endTimeOffset": "END_TIME_OFFSET1s"
      },
      {
        "key": "atom2",
        "inputs": [
          "input2"
        ],
        "startTimeOffset": "START_TIME_OFFSET2s",
        "endTimeOffset": "END_TIME_OFFSET2s"
      }
    ],
    "elementaryStreams": [
      {
        "key": "video-stream0",
        "videoStream": {
          "h264": {
            "heightPixels": 360,
            "widthPixels": 640,
            "bitrateBps": 550000,
            "frameRate": 60
          }
        }
      },
      {
        "key": "audio-stream0",
        "audioStream": {
          "codec": "aac",
          "bitrateBps": 64000
        }
      }
    ],
    "muxStreams": [
      {
        "key": "sd",
        "container": "mp4",
        "elementaryStreams": [
          "video-stream0",
          "audio-stream0"
        ]
      }
    ],
    "output": {
      "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_OUTPUT_FOLDER/"
    }
  }
}
EOF

接著，執行下列指令來傳送 REST 要求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://transcoder.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

@'
{
  "config": {
    "inputs": [
      {
        "key": "input1",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO1"
      },
      {
        "key": "input2",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO2"
      }
    ],
    "editList": [
      {
        "key": "atom1",
        "inputs": [
          "input1"
        ],
        "startTimeOffset": "START_TIME_OFFSET1s",
        "endTimeOffset": "END_TIME_OFFSET1s"
      },
      {
        "key": "atom2",
        "inputs": [
          "input2"
        ],
        "startTimeOffset": "START_TIME_OFFSET2s",
        "endTimeOffset": "END_TIME_OFFSET2s"
      }
    ],
    "elementaryStreams": [
      {
        "key": "video-stream0",
        "videoStream": {
          "h264": {
            "heightPixels": 360,
            "widthPixels": 640,
            "bitrateBps": 550000,
            "frameRate": 60
          }
        }
      },
      {
        "key": "audio-stream0",
        "audioStream": {
          "codec": "aac",
          "bitrateBps": 64000
        }
      }
    ],
    "muxStreams": [
      {
        "key": "sd",
        "container": "mp4",
        "elementaryStreams": [
          "video-stream0",
          "audio-stream0"
        ]
      }
    ],
    "output": {
      "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_OUTPUT_FOLDER/"
    }
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

接著，執行下列指令來傳送 REST 要求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://transcoder.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID",
  "config": {
   ...
  },
  "state": "PENDING",
  "createTime": CREATE_TIME,
  "ttlAfterCompletionDays": 30
}

gcloud

建立定義工作欄位的 request.json 檔案。針對 gcloud 指令，進行以下替換：
- LOCATION：工作執行的位置。使用支援的地區之一。
  顯示地區
  - us-central1
  - us-west1
  - us-west2
  - us-east1
  - us-east4
  - southamerica-east1
  - northamerica-northeast1
  - asia-east1
  - asia-northeast1
  - asia-northeast3
  - asia-south1
  - asia-southeast1
  - australia-southeast1
  - europe-west1
  - europe-west2
  - europe-west4
  - me-west1
  - me-central1
  - me-central2
- STORAGE_BUCKET_NAME：您建立的 Cloud Storage 值區名稱。
- STORAGE_INPUT_VIDEO1：Cloud Storage 值區中要轉碼的影片名稱，例如 my-vid.mp4。這個欄位應考量您在儲存空間中建立的任何資料夾 (例如 input/my-vid.mp4)。這部影片會在輸出影片時間軸中優先使用。
- START_TIME_OFFSET1：相對於第一個輸入影片時間軸的開始時間，以秒的刻度 (例如 0.0) 為單位。使用這個欄位，從影片開頭剪輯內容。
- END_TIME_OFFSET1：相對於第一個輸入影片時間軸線的結束時間，以秒小數位數 (例如 8.1) 為單位。使用這個欄位，即可從影片結尾裁剪內容。
- STORAGE_INPUT_VIDEO2：Cloud Storage 值區中要轉碼的影片名稱，例如 my-vid.mp4。這個欄位應考量您在儲存空間中建立的任何資料夾 (例如 input/my-vid.mp4)。這部影片會在輸出影片時間軸中使用第二次。
- START_TIME_OFFSET2：相對於第二個輸入影片時間軸的開始時間，以秒的刻度 (例如 3.5) 為單位。使用這個欄位，從第二部影片的開頭剪輯內容。
- END_TIME_OFFSET2：相對於第二個輸入影片時間軸線的結束時間，以秒的刻度 (例如 15) 為單位。使用這個欄位，從第二部影片的結尾裁剪內容。
- STORAGE_OUTPUT_FOLDER：您要儲存已編碼影片輸出內容的 Cloud Storage 資料夾名稱。
  注意：您不必在建立工作之前建立輸出資料夾物件。處理工作時，Transcoder API 會自動將您指定的資料夾名稱加在儲存至 Cloud Storage 的物件名稱前方。
```
{
  "config": {
    "inputs": [
      {
        "key": "input1",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO1"
      },
      {
        "key": "input2",
        "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO2"
      }
    ],
    "editList": [
      {
        "key": "atom1",
        "inputs": [
          "input1"
        ],
        "startTimeOffset": "START_TIME_OFFSET1s",
        "endTimeOffset": "END_TIME_OFFSET1s"
      },
      {
        "key": "atom2",
        "inputs": [
          "input2"
        ],
        "startTimeOffset": "START_TIME_OFFSET2s",
        "endTimeOffset": "END_TIME_OFFSET2s"
      }
    ],
    "elementaryStreams": [
      {
        "key": "video-stream0",
        "videoStream": {
          "h264": {
            "heightPixels": 360,
            "widthPixels": 640,
            "bitrateBps": 550000,
            "frameRate": 60
          }
        }
      },
      {
        "key": "audio-stream0",
        "audioStream": {
          "codec": "aac",
          "bitrateBps": 64000
        }
      }
    ],
    "muxStreams": [
      {
        "key": "sd",
        "container": "mp4",
        "elementaryStreams": [
          "video-stream0",
          "audio-stream0"
        ]
      }
    ],
    "output": {
      "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_OUTPUT_FOLDER/"
    }
  }
}
```

請執行下列指令：

gcloud transcoder jobs create --location=LOCATION --file="request.json"

您應該會看到類似以下的回應：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID",
  "config": {
   ...
  },
  "state": "PENDING",
  "createTime": CREATE_TIME,
  "ttlAfterCompletionDays": 30
}