本頁面由 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 bucket 名稱。
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。這個欄位應考量您在 bucket 中建立的任何資料夾 (例如 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 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 bucket 名稱。
- 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。這個欄位應考量您在 bucket 中建立的任何資料夾 (例如 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
}