您可以在一個樣式(Style)中包含多個處理參數,快速實現複雜的媒體、文檔或圖片處理操作。
新版資料處理功能API、SDK支援在IMM服務存取點中的地區進行使用。
使用自訂樣式
建立樣式
一個儲存空間(Bucket)最多可建立50個樣式,這些樣式僅支援作用於該Bucket下的檔案。如您的業務有更多樣式的需求,請聯絡支援人員。
根據您需要處理檔案的類型,選擇圖片處理、文檔處理或ApsaraVideo for Media Processing等入口。
選擇樣式管理頁簽,單擊建立樣式。
在建立樣式面板,通過圖形化方式配置您的樣式。
單擊確定。
使用樣式
樣式建立完成後,您可以通過對象URL或非同步請求使用樣式處理檔案。
使用對象URL進行同步處理
您可以將樣式添加到對象訪問URL上進行同步處理,格式為http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName,各參數說明如下表所示。
參數 | 說明 | 樣本 |
| 對象的訪問地址。擷取方式,請參見如何擷取單個或多個檔案的URL?。 | |
| 固定參數,表示使用樣式參數對檔案進行處理。 | |
| 建立樣式時設定的樣式名稱。 |
您可以設定自訂分隔字元和綁定自訂網域名以簡化處理URL,例如進行如下設定:
使用分隔字元
!代替x-oss-process=style/為Bucket綁定自訂網域名,進一步簡化處理,更多資訊,請參見綁定自訂網域名
例如綁定自訂網域名example.com後,使用https://example.com/example.jpg!small處理圖片。
現在必須通過綁定網域名稱。自2022年10月09日00:00:00起,建立的bucket不支援線上預覽。若不綁定網域名稱,無法實現線上預覽功能。更多資訊,請參見公告。
使用樣式進行非同步處理
您可以使用x-oss-async-process=style/StyleName對檔案進行非同步處理,樣本如下:
POST /ObjectName?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// 使用名為StyleName的樣式對檔案example.avi進行非同步處理,處理後將得到的檔案儲存為oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ各參數說明如下表所示:
參數 | 說明 |
| Object名稱。 |
| 固定參數,表示使用樣式參數對檔案進行處理。 |
| 建立樣式時設定的樣式名稱。 |
使用系統樣式
除了使用自訂樣式,您還可以使用系統樣式處理檔案。
使用樣式進行非同步處理
您可以通過x-oss-async-process=style/::systemStyleName對檔案進行非同步處理,樣本如下:
POST /ObjectName?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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// 使用名為h264-mp4-1080p的系統樣式對檔案example.avi進行非同步處理,處理後將得到的檔案儲存為oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ各參數說明如下表所示:
參數 | 說明 |
| Object名稱。 |
| 固定參數,表示使用樣式參數對檔案進行處理。 |
| 使用系統樣式。 |
| 系統樣式名稱。 說明 您可以在數據處理>ApsaraVideo for Media Processing頁面查看支援的所有系統樣式參數。 |
將源Bucket的樣式匯入目標Bucket
僅支援圖片處理樣式。
您可以匯出源Bucket中已建立的樣式,並將樣式匯入到目標Bucket,便於在目標Bucket中快速應用樣式來處理圖片檔案。
在源Bucket中匯出樣式。
在源Bucket管理頁面,選擇數據處理>圖片處理。
在圖片處理頁面,單擊匯出樣式。
在彈出的對話方塊選擇樣式的儲存位置,然後單擊保存。
在目標Bucket匯入樣式。