圖片處理

OSS圖片處理，是OSS對外提供的海量、安全、低成本、高可靠的圖片處理服務。使用者將原始圖片上傳保存到OSS，通過簡單的 RESTful 介面，在任何時間、任何地點、任何互連網裝置上對圖片進行處理。

圖片處理提供圖片處理介面，圖片上傳請使用上傳介面。基於OSS圖片處理，使用者可以搭建自己的圖片處理服務。

圖片處理基礎功能

OSS圖片處理提供以下功能：

• 獲取圖片資訊
• 圖片格式轉換
• 圖片縮放、裁剪、旋轉
• 圖片效果
• 圖片添加圖片、文字、圖文混合浮水印
• 自訂圖片處理樣式，在控制台的 圖片處理 -> 樣式管理 中定義
• 通過級聯處理調用多個圖片處理功能

圖片處理使用

圖片處理使用標準的 HTTP GET 請求來訪問，所有的處理參數是編碼在 URL 中的QueyString。

匿名訪問

如果圖片檔案（Object）的存取權限是 公共讀 ，如下表所示的許可權，則可以匿名訪問圖片服務。

通過如下格式的第三層網域名匿名訪問圖片處理：

http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value

• bucket：使用者的儲存空間（bucket）名稱
• endpoint：使用者儲存空間所在資料中心的訪問網域名稱
• object：使用者上傳在OSS上的圖片檔案
• image：圖片處理保留標誌符
• action：使用者對圖片做的操作，如縮放、裁剪、旋轉等
• parame：使用者對圖片做的操作所對應的參數

例如：

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

自訂樣式，使用如下格式的第三層網域名匿名訪問圖片處理：

http://bucket.<endpoint>/object?x-oss-process=x-oss-process=style/name

• style：使用者自訂樣式系統保留標誌符
• name：自訂樣式名稱，即控制台定義樣式的 規則名

例如：

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/oss-pic-style-w-100

通過級聯處理，可以對一張圖片順序實施多個操作，格式如下：

http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value/action,parame_value/...

例如：

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100/rotate,90

圖片服務也支援HTTPS訪問，例如：

https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

授權訪問

對私有許可權的檔案（Object），如下表所示的許可權，必須通過授權才能訪問圖片服務。

生成帶簽名的圖片處理的URL代碼如下：

public static void GenerateIamgeUri(string bucketName)
{
    try
    {
        var process = "image/resize,m_fixed,w_100,h_100";
        var req = new GeneratePresignedUriRequest(bucketName, key, SignHttpMethod.Get)
        {
            Expiration = DateTime.Now.AddSeconds(30 * 60),
            Process = process
        };
        // 產生帶有簽名的URI
        var uri = client.GeneratePresignedUri(req);
        Console.WriteLine("Generate Presigned Uri:{0} with process:{1} succeeded ", uri, process);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Failed with error info: {0}", ex.Message);
    }
}

提示：

• 授權訪問支援 自訂樣式、 HTTPS、 級聯處理
• GeneratePresignedUri 過期時間單位是秒
• 完整的代碼請參看 GitHub

SDK訪問

對於任意許可權的圖片檔案，都可以直接使用 SDK 訪問圖片、進行處理。

提示：

• 圖片處理的完整代碼請參考：GitHub
• SDK處理圖片檔案支援 自訂樣式、 HTTPS、 級聯處理

基礎操作

圖片處理的基礎操作包括，獲取圖片資訊、格式轉換、縮放、裁剪、旋轉、效果、浮水印等。

public static void ImageProcess(string bucketName)
{
    try
    {
        client.PutObject(bucketName, key, imageFile);
        // 圖片縮放
        var process = "image/resize,m_fixed,w_100,h_100";
        var ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-resize.jpg", ossObject.Content);
        // 圖片裁剪
        process = "image/crop,w_100,h_100,x_100,y_100,r_1";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-crop.jpg", ossObject.Content);
        // 圖片旋轉
        process = "image/rotate,90";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-rotate.jpg", ossObject.Content);
        // 圖片銳化
        process = "image/sharpen,100";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-sharpen.jpg", ossObject.Content);
        // 圖片加浮水印
        process = "image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-watermark.jpg", ossObject.Content);
        // 圖片格式轉換
        process = "image/format,png";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-format.png", ossObject.Content);
        // 圖片資訊
        process = "image/info";
        ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-info.txt", ossObject.Content);
        Console.WriteLine("Get Object:{0} with process:{1} succeeded ", key, process);
    }
    catch (OssException ex)
    {
        Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}", 
            ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Failed with error info: {0}", ex.Message);
    }
}

自訂樣式

public static void ImageProcess(string bucketName)
{
    try
    {
        client.PutObject(bucketName, key, imageFile);
        // 自訂樣式
        var process = "style/oss-pic-style-w-100";
        var ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-style.jpg", ossObject.Content);
    }
    catch (OssException ex)
    {
        Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}", 
            ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Failed with error info: {0}", ex.Message);
    }
}

級聯處理

public static void ImageProcess(string bucketName)
{
    try
    {
        client.PutObject(bucketName, key, imageFile);
        // 級聯處理
        var process = "image/resize,m_fixed,w_100,h_100/rotate,90";
        var ossObject = client.GetObject(new GetObjectRequest(bucketName, key, process));
        WriteToFile(dirToDownload + "/sample-style.jpg", ossObject.Content);
    }
    catch (OssException ex)
    {
        Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}", 
            ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Failed with error info: {0}", ex.Message);
    }
}

圖片處理工具

• 可視化圖片處理工具 ImageStyleViever ，可以直觀的看到OSS圖片處理的結果
• OSS圖片處理的功能、使用示範 頁面