當您需要修改視頻的編碼格式、降低分辨率和碼率以縮小視頻文件體積、轉換視頻封裝格式，以提高視頻質量時，可以使用視頻轉碼功能。本文介紹視頻轉碼處理功能參數及示例。
前提條件
已綁定IMM Project。通過OSS控制臺綁定的具體操作，請參見快速入門。通過API綁定的具體操作，請參見AttachOSSBucket。
注意事項
視頻轉碼僅支持異步處理（x-oss-async-process處理方式）。
不支持匿名訪問。
必須擁有IMM處理所需的相關權限。更多信息，請參見權限。
參數說明
操作名稱：video/convert
具體參數如下表所示。
參數 | 類型 | 是否必選 | 描述 |
ss | int | 否 | 起始時間，單位為毫秒。取值：
|
t | int | 否 | 轉碼時長，單位為毫秒。取值：
|
f | string | 是 | 媒體容器類型。取值：
|
vn | int | 否 | 是否禁用視頻流。取值：
|
vcodec | string | 否 | 視頻codec（編碼格式）。取值：
|
fps | float | 否 | 視頻幀率。取值范圍：0~240。 |
fpsopt | int | 否 | 視頻幀率選項。取值：
|
pixfmt | string | 否 | 像素采樣格式，默認與源視頻一致。取值：
|
s | string | 否 | 目標分辨率。
|
sopt | int | 否 | 分辨率選項。取值：
|
scaletype | string | 否 | 縮放方式。取值：
|
arotate | int | 否 | 自適應分辨率方向。取值：
|
g | int | 否 | 關鍵幀。取值范圍：1~100000。 |
vb | int | 否 | 視頻比特率（碼率），單位為比特/秒（bps）。取值范圍：10000~100000000。 |
vbopt | int | 否 | 視頻碼率選項。取值：
|
crf | float | 否 | 碼率控制因子。取值范圍：0~51。 |
maxrate | int | 否 | 峰值碼率，單位為比特/秒（bps）。取值范圍：10000~100000000。 |
bufsize | int | 否 | 緩沖區大小，單位為比特（bits）。取值范圍：10000~200000000。 |
an | int | 否 | 是否禁用音頻流。取值：
|
acodec | string | 否 | 音頻codec（編碼格式）。取值：
|
ar | int | 否 | 音頻采樣率。取值：
|
ac | int | 否 | 音頻聲道數。默認保持源音頻的聲道數。取值范圍：1~8。 |
aq | int | 否 | 音頻壓縮質量。與參數ab互斥。取值范圍：0~100。 |
ab | int | 否 | 音頻比特率（碼率）。與參數aq互斥，單位為比特/秒（bps）。取值范圍：1000~10000000。 |
abopt | int | 否 | 音頻碼率選項。取值：
|
sn | int | 否 | 是否禁用字幕。取值：
|
adepth | int | 否 | 音頻采樣位深，取值為16或24。 說明 該參數僅在acodec為flac時有效 |
segment | string | 否 | 媒體切片設置，默認不進行切片。 |
f | string | 否 | 媒體切片方式。取值：
父節點：segment |
t | int | 否 | 切片長度，單位為毫秒。取值范圍：0~3600000。 父節點：segment |
使用REST API
將AVI格式轉換為MP4格式
轉碼信息
轉碼前
視頻格式：AVI
視頻名稱：example.avi
處理方式：視頻轉碼
轉碼后
視頻信息
視頻格式：MP4
視頻名稱：outobjprefix.mp4
視頻流格式：H.265
視頻分辨率：1920x1080
視頻幀率：30 fps
視頻碼率：2 Mbps
音頻信息
音頻流格式：AAC
音頻碼率：100 Kbps
字幕流：禁用
文件存儲路徑：oss://outbucket/outobjprefix.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: OSS qn6q**************:77Dv****************
// 對文件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格式
轉碼信息
轉碼前
視頻格式：AVI
視頻名稱：example.avi
處理方式
轉碼時長：從輸入媒體文件的第1000毫秒開始并持續60000毫秒進行視頻轉碼
切片方式：按30秒間隔進行HLS切片
轉碼完成消息通知：發送MNS消息
轉碼后
視頻信息
視頻格式：TS
視頻流格式：H.264
視頻碼率：1 Mbps
音頻信息
音頻格式：AAC
音頻碼率：100 Kbps
文件存儲路徑
ts文件：oss://outbucket/outobjprefix-%d.ts
m3u8文件：oss://outbucket/outobjprefix.m3u8
處理示例
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: OSS qn6q**************:77Dv****************
// 對文件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格式
轉碼信息
轉碼前
視頻名稱：example.avi
視頻格式：AVI
處理方式：提取音頻并將提取的音頻進行轉碼
轉碼后
音頻容器：MP3
音頻編碼格式：MP3
音頻碼率：100 Kbps
視頻流：禁用
字幕流：禁用
文件存儲路徑：音頻文件存儲路徑為oss://outbucket/outobjprefix.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: OSS qn6q**************:77Dv****************
// 對文件example.avi進行音頻提取并將提取的音頻進行轉碼。
x-oss-async-process=video/convert,f_mp3,acodec_mp3,ab_100000,vn_1,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ使用SDK
僅支持使用Java、Python、Go SDK通過異步處理的方式完成視頻轉碼。
Java
要求使用3.17.4及以上版本的Java 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實例。
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();
}
}
}Python
要求使用Python SDK 2.18.4及以上版本。
# -*- 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()
Go
要求使用Go SDK 3.0.2及以上版本。
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)
}
常見問題
視頻轉碼時提示無法找到資源怎么辦？
視頻轉碼時出現報錯信息“ResourceNotFound, The specified resource Attachment is not found.”是因為您沒有綁定Bucket。請在創建IMM項目后綁定Bucket。具體操作，請參見步驟二：綁定Bucket。
視頻轉碼時能否轉存到原路徑？
建議您不要將文件轉存至原始路徑。在進行視頻轉碼時，輸出路徑不應以前置輸入路徑作為前綴，以免引起觸發器的循環激活或意外覆蓋源文件等問題。
視頻轉碼是否支持設置音頻位深？
視頻轉碼支持位深設置，通過OSS x-oss-process方式的pixfmt參數來進行設置。