feat(samples): add code samples and tests for overlay creation (#39)

samples/createJobWithAnimatedOverlay.js

@@ -0,0 +1,131 @@
+/**
+ * Copyright 2021, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+function main(projectId, location, inputUri, overlayImageUri, outputUri) {
+  // [START transcoder_create_job_with_animated_overlay]
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  // projectId = 'my-project-id';
+  // location = 'us-central1';
+  // inputUri = 'gs://my-bucket/my-video-file';
+  // overlayImageUri = 'gs://my-bucket/my-overlay-image-file'; // Must be a JPEG
+  // outputUri = 'gs://my-bucket/my-output-folder/';
+
+  // Imports the Transcoder library
+  const {TranscoderServiceClient} = require('@google-cloud/video-transcoder');
+
+  // Instantiates a client
+  const transcoderServiceClient = new TranscoderServiceClient();
+
+  async function createJobFromAnimatedOverlay() {
+    // Construct request
+    const request = {
+      parent: transcoderServiceClient.locationPath(projectId, location),
+      job: {
+        inputUri: inputUri,
+        outputUri: outputUri,
+        config: {
+          elementaryStreams: [
+            {
+              key: 'video-stream0',
+              videoStream: {
+                codec: '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'],
+            },
+          ],
+          overlays: [
+            {
+              image: {
+                uri: overlayImageUri,
+                resolution: {
+                  x: 0,
+                  y: 0,
+                },
+                alpha: 1.0,
+              },
+              animations: [
+                {
+                  animationFade: {
+                    fadeType: 'FADE_IN',
+                    xy: {
+                      x: 0.5,
+                      y: 0.5,
+                    },
+                    startTimeOffset: {
+                      seconds: 5,
+                    },
+                    endTimeOffset: {
+                      seconds: 10,
+                    },
+                  },
+                },
+                {
+                  animationFade: {
+                    fadeType: 'FADE_OUT',
+                    xy: {
+                      x: 0.5,
+                      y: 0.5,
+                    },
+                    startTimeOffset: {
+                      seconds: 12,
+                    },
+                    endTimeOffset: {
+                      seconds: 15,
+                    },
+                  },
+                },
+              ],
+            },
+          ],
+        },
+      },
+    };
+
+    // Run request
+    const [response] = await transcoderServiceClient.createJob(request);
+    console.log(`Job: ${response.name}`);
+  }
+
+  createJobFromAnimatedOverlay();
+  // [END transcoder_create_job_with_animated_overlay]
+}
+
+// node createJobFromAnimatedOverlay.js <projectId> <location> <inputUri> <overlayImageUri> <outputUri>
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

samples/createJobWithStaticOverlay.js

@@ -0,0 +1,119 @@
+/**
+ * Copyright 2021, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+'use strict';
+
+function main(projectId, location, inputUri, overlayImageUri, outputUri) {
+  // [START transcoder_create_job_with_static_overlay]
+  /**
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  // projectId = 'my-project-id';
+  // location = 'us-central1';
+  // inputUri = 'gs://my-bucket/my-video-file';
+  // overlayImageUri = 'gs://my-bucket/my-overlay-image-file'; // Must be a JPEG
+  // outputUri = 'gs://my-bucket/my-output-folder/';
+
+  // Imports the Transcoder library
+  const {TranscoderServiceClient} = require('@google-cloud/video-transcoder');
+
+  // Instantiates a client
+  const transcoderServiceClient = new TranscoderServiceClient();
+
+  async function createJobFromStaticOverlay() {
+    // Construct request
+    const request = {
+      parent: transcoderServiceClient.locationPath(projectId, location),
+      job: {
+        inputUri: inputUri,
+        outputUri: outputUri,
+        config: {
+          elementaryStreams: [
+            {
+              key: 'video-stream0',
+              videoStream: {
+                codec: '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'],
+            },
+          ],
+          overlays: [
+            {
+              image: {
+                uri: overlayImageUri,
+                resolution: {
+                  x: 1,
+                  y: 0.5,
+                },
+                alpha: 1.0,
+              },
+              animations: [
+                {
+                  animationStatic: {
+                    xy: {
+                      x: 0,
+                      y: 0,
+                    },
+                    startTimeOffset: {
+                      seconds: 0,
+                    },
+                  },
+                },
+                {
+                  animationEnd: {
+                    startTimeOffset: {
+                      seconds: 10,
+                    },
+                  },
+                },
+              ],
+            },
+          ],
+        },
+      },
+    };
+
+    // Run request
+    const [response] = await transcoderServiceClient.createJob(request);
+    console.log(`Job: ${response.name}`);
+  }
+
+  createJobFromStaticOverlay();
+  // [END transcoder_create_job_with_static_overlay]
+}
+
+// node createJobFromStaticOverlay.js <projectId> <location> <inputUri> <overlayImageUri> <outputUri>
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));