tencent cloud

Overview

This document helps you get started with MPS. The diagram below describes the basic steps:

Directions

Step 1. Sign up and log in

1. Sign up for a Tencent Cloud account and verify your identity.
2. Log in to the MPS console.

Step 2. Grant access to COS

MPS needs read and write access to COS in order to download and transcode videos in COS buckets and upload files to the buckets. Therefore, you need to create a service role and grant the role access to COS.

If you haven’t granted the access yet, go to the MPS console, and click Go to CAM to enter the authorization page to grant the access.
![]

Note：

You cannot perform further operations in the MPS console before granting the access.

Step 3. Create a bucket

Because video processing is performed on video files uploaded to COS, you need to first create a bucket in the COS console.

In the COS console, select Bucket List and click Create Bucket to create a bucket. You can then create folders in the bucket and upload files to them. For more information, please see Creating Buckets.

Step 4. Create a workflow

With the use of templates, a workflow can automatically process video files uploaded to a specified bucket. You can add tasks such as transcoding, screenshot taking, and animated image generating to a workflow.

1. In the MPS console, click Workflow Management.
2. Click Create Workflow to enter the workflow creation page and set the workflow name, trigger bucket, trigger directory, output bucket, output directory, event notifications and configuration items. For detailed instructions, please see workflow configuration.
   
   The table below lists the information needed to configure a workflow.

   Item	Required	Description
   Workflow name	Yes	Max 128 characters; supports Chinese characters, letters, digits, underscores, and hyphens（_-）. Example: "MPS"
   Trigger bucket	Yes	Select a bucket created under the current `APPID`. After the workflow is enabled, videos uploaded to this bucket will be processed automatically.
   Trigger directory	No	A string that ends with (/). If it is left empty, the workflow will be applied to all directories under the selected trigger bucket.
   Output bucket	Yes	By default, the output bucket is the same as the trigger bucket. You can also select a bucket in the same region under the same `APPID`. After a workflow is executed, the processed videos will be stored in this bucket.
   Output directory	No	A string that ends with (/). If it is left empty, the output directory will be the same as the trigger directory.
   Event notifications	No	Disabled by default. For detailed instructions on how to configure event notifications, please see callback configuration below. To enable CMQ event notifications, you need to activate CMQ and create a model. After CMQ event notifications are enabled, the specified CMQ will receive notifications about video processing events.
   Configuration items	Yes	From transcoding, screenshot taking, animated image generation, moderation, content recognition, and content analysis, select at least one task for configuration. For details, please see task configuration.

   Callback Method	Configuration
   CMQ callback	CMQ model: queue model by default CMQ zone: Guangzhou, Shanghai, Beijing, Shanghai Finance, Shenzhen Finance, Hong Kong (China), Chengdu, North America, or West US Queue name: a custom value
   SCF callback	Click **Go to SCF Console** to configure the callback in the SCF console. For detailed instructions, please see MPS Task Callback Notification. The configuration applies to all workflows and is not saved specifically by one workflow.

Step 5. Enable the workflow

1. You will see the toast message "Created workflow successfully" after creating a workflow. Click Manage Workflow to go to the workflow management page.
   
2. Workflows are disabled by default. To enable your workflow, click the toggle in the Enable column. A workflow will be executed automatically on videos uploaded to the trigger bucket only after it is enabled.

Step 6. Upload a video

1. After the workflow is enabled, go to the COS console and click Bucket List on the left sidebar.
2. Locate the trigger bucket set in the workflow, click its name to enter the File List page, and upload a video file. MPS will automatically process the video according to the workflow settings.

   Note：

   A workflow will be executed automatically on video files uploaded to the trigger bucket only after it is enabled. Files uploaded before the workflow is enabled will not be processed.

Step 7. View the processed video

1. After the video is processed, go to the COS console and click Bucket List on the left sidebar.
2. Locate the output bucket set in the workflow and click its name to enter the File List page, where you can view the video processed according to the workflow settings.