视频转码

前提条件

• 已开通智能媒体管理（IMM）服务。

• 在OSS中创建存储空间（Bucket），上传需要处理的文件至Bucket中。

• 已创建并绑定 IMM Project，您可以通过OSS控制台绑定或调用API绑定，IMM Project需要跟Bucket在同一地域下。

• 已授权用户对应操作的权限。若您使用阿里云账号，则默认拥有全部权限，无需进行授权操作；若您使用阿里云账号下的RAM用户或RAM角色，默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

  权限说明

  • 授予用户访问关联资源的权限。

    • 授予用户使用OSS进行数据处理的权限。

      API	Action	说明
      GetObject	oss:GetObject	下载Object。
      	oss:GetObjectVersion	下载Object时，如果通过versionId指定了Object的版本，则需要授予此操作的权限。
      	kms:Decrypt	下载Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要此操作的权限。
      无	oss:ProcessImm	通过OSS使用IMM进行数据处理的权限。
      PostProcessTask	oss:PostProcessTask	通过POST请求使用数据处理功能的权限，例如异步处理（x-oss-async-process）。

    • 授予用户使用 IMM 的媒体转码功能的权限。

      API	Action	说明
      CreateMediaConvertTask	imm:CreateMediaConvertTask	使用IMM进行媒体转码的权限。

  • 授予IMM服务使用的角色（默认为AliyunIMMDefaultRole，其资源ARN为acs:ram:*:<account-id>:role/aliyunimmdefaultrole）访问关联资源进行数据处理的权限。

    API	Action	说明
    无	ram:PassRole	执行跨服务资源操作。
    GetObject	oss:GetObject	下载Object。
    	oss:GetObjectVersion	下载Object时，如果通过versionId指定了Object的版本，则需要授予此操作的权限。
    	kms:Decrypt	下载Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要此操作的权限。
    HeadObject	oss:GetObject	获取某个Object的元数据。
    PutObject	oss:PutObject	上传Object。
    	oss:PutObjectVersion	上传Object 时，如果通过versionId指定了Object的版本，则需要授予此操作的权限。
    	kms:GenerateDataKey	上传Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要这两个操作的权限。
    	kms:Decrypt

视频转码

仅支持使用Java、Python、Go SDK通过异步处理的方式完成视频转码。

import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.AsyncProcessObjectRequest;
import com.aliyun.oss.model.AsyncProcessObjectResult;
import com.aliyuncs.exceptions.ClientException;

import java.util.Base64;

public class Demo {
    public static void main(String[] args) throws ClientException {
        // yourEndpoint填写Bucket所在地域对应的Endpoint。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 指定阿里云通用Region ID，例如cn-hangzhou。
        String region = "cn-hangzhou";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 指定Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
        // 指定处理后视频文件名称。
        String targetKey = "dest.avi";
        // 指定原视频文件名称。
        String sourceKey = "src.mp4";

        // 创建OSSClient实例。
        // 当OSSClient实例不再使用时，调用shutdown方法以释放资源。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 构建视频处理样式字符串以及视频转码处理参数。
            String style = String.format("video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1");
            // 构建异步处理指令。
            String bucketEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(bucketName.getBytes());
            String targetEncoded = Base64.getUrlEncoder().withoutPadding().encodeToString(targetKey.getBytes());
            String process = String.format("%s|sys/saveas,b_%s,o_%s", style, bucketEncoded, targetEncoded);
            // 创建AsyncProcessObjectRequest对象。
            AsyncProcessObjectRequest request = new AsyncProcessObjectRequest(bucketName, sourceKey, process);
            // 执行异步处理任务。
            AsyncProcessObjectResult response = ossClient.asyncProcessObject(request);
            System.out.println("EventId: " + response.getEventId());
            System.out.println("RequestId: " + response.getRequestId());
            System.out.println("TaskId: " + response.getTaskId());

        } finally {
            // 关闭OSSClient。
            ossClient.shutdown();
        }
    }
}

# -*- coding: utf-8 -*-
import base64
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider


def main():
    # 填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
    # 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

    # 填写Bucket名称。
    bucket_name = 'examplebucket'
    # 填写阿里云通用Region ID，例如cn-hangzhou。
    region = 'cn-hangzhou'
    # 创建Bucket实例。
    bucket = oss2.Bucket(auth, endpoint, bucket_name, region=region)

    # 指定原视频文件名称。
    source_key = 'src.mp4'
    # 指定处理后视频文件名称。
    target_key = 'dest.avi'
    # 构建视频处理样式字符串以及视频转码处理参数。
    style = 'video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1'
    process = "{0}|sys/saveas,o_{1}".format(style,
                                            oss2.compat.to_string(base64.urlsafe_b64encode(
                                                oss2.compat.to_bytes(target_key))).replace('=', ''))

    # 调用异步流媒体处理接口。
    try:
        # 执行异步处理任务。
        result = bucket.async_process_object(source_key, process)
        print(f"EventId: {result.event_id}")
        print(f"RequestId: {result.request_id}")
        print(f"TaskId: {result.task_id}")
    except Exception as e:
        print(f"Error: {e}")


if __name__ == "__main__":
    main()

package main

import (
	"encoding/base64"
	"fmt"
	"os"
	"strings"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 创建OSSClient实例。
	// yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
	client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 指定视频所在的Bucket名称，例如examplebucket。
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	// 指定处理后视频文件名称。
	targetObject := "dest.avi"
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 指定原视频文件名称。
	sourceObject := "src.mp4"

	// 构建视频处理样式字符串以及视频转码处理参数。
	style := "video/convert,f_avi,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1"

	process := fmt.Sprintf("%s|sys/saveas,b_%v,o_%v", style, strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(bucketName)), "="), strings.TrimRight(base64.URLEncoding.EncodeToString([]byte(targetObject)), "="))
	fmt.Printf("%#v\n", process)
	rs, err := bucket.AsyncProcessObject(sourceObject, process)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	fmt.Printf("EventId:%s\n", rs.EventId)
	fmt.Printf("RequestId:%s\n", rs.RequestId)
	fmt.Printf("TaskId:%s\n", rs.TaskId)
}

将AVI格式转换为MP4格式

POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 对文件example.avi进行视频转码，转码输出媒体文件容器为MP4，视频流格式为H.265，分辨率为1920x1080，帧率为30 fps，视频码率为2 Mbps；音频流格式为AAC，音频码率为100 Kbps；禁用字幕流；转码完成后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

将AVI格式转换为TS格式

POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 对文件example.avi进行视频转码。
x-oss-async-process=video/convert,ss_10000,t_60000,f_ts,vcodec_h264,vb_1000000,acodec_mp3,ab_100000/segment,f_hls,t_30000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_QXVkaW9Db252ZXJ0

将AVI格式转换为MP3格式

POST /example.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: SignatureValue
 
// 对文件example.avi进行音频提取并将提取的音频进行转码。
x-oss-async-process=video/convert,f_mp3,acodec_mp3,ab_100000,vn_1,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

视频转码时提示无法找到资源怎么办？

视频转码时出现报错信息“ResourceNotFound, The specified resource Attachment is not found.”错误，可能是未绑定Bucket。请在创建IMM项目后绑定Bucket。具体操作请参见oss数据处理使用指南。

视频转码时能否转存到原路径？

不可以，视频转码时输出路径应避免以输入路径为前缀，否则将导致触发器循环触发和源文件被覆盖等非预期行为。

视频转码是否支持设置音频位深？

视频转码支持位深设置，通过OSS x-oss-process方式的pixfmt参数来进行设置。

视频转码如何通过返回的taskid获取task执行结果？

建议参考智能媒体管理的GetTask - 获取任务信息来获取。

视频转码时OSS如何根据后缀检索删除特定格式文件？

OSS不支持通过后缀搜索文件，因为OSS是无序存储。

视频转码已配置消息队列推送，但后端未能接收到消息？

确认主题及订阅是否已创建。如不存在或被删除，则需重新配置订阅。根据当前配置的订阅，重新发起转码处理。

将视频上传至OSS后，可以使用指定的模板进行转码吗？

配置相应的触发器即可实现相关功能。视频处理的相关数据处理能力可以由用户主动提交，也可以通过配置批处理和触发器来自动触发对存储桶中存量和增量视频的处理。任务、批处理和触发器可以采用系统样式或自定义样式，具体请参见批处理和触发器。

转码后的视频是否会产生收费？

转码后的视频将占用存储空间，产生计费。

转码输出的文件路径是否可与源路径一致，会不会导致文件被替换？

不建议将输出路径与源文件路径设置为一致，否则会覆盖源文件。