此页面由 Cloud Translation API 翻译。

串联多个输入视频

本页介绍如何将多个输入视频合并为一个输出视频。您还可以剪辑输入视频的时间轴。

对于每个输入视频，向 inputs 数组添加 Input 对象。每个 Input 对象都为关联的输入视频定义键和 URI。您可以向 Input 添加可选的 PreprocessingConfig 对象，以对输入视频执行剪裁、填充，或其他预处理操作。inputs 数组未排序；您可以按任意顺序添加输入视频。

要向输出视频时间轴添加输入视频，请向 editList 数组添加 EditAtom 对象。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
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 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
- 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
}