Object Storage Service：Konversi format citra

Skenario

• Menyesuaikan dengan berbagai perangkat dan platform: Perangkat dan platform yang berbeda mendukung format citra yang berbeda. Anda dapat menggunakan fitur konversi format citra OSS untuk memastikan kompatibilitas dan tampilan optimal di berbagai perangkat.

• Menghemat biaya penyimpanan: Beberapa format citra, seperti WebP, memiliki ukuran file lebih kecil sambil mempertahankan kualitas visual. Anda dapat mengonversi citra ke format tersebut untuk mengurangi penggunaan penyimpanan dan menekan biaya penyimpanan.

• Menyatukan manajemen sumber daya: Di industri seperti e-commerce, media sosial, dan media berita, Anda dapat mengonversi citra yang diunggah ke format standar. Hal ini menyederhanakan manajemen dan distribusi selanjutnya.

Catatan penggunaan

• Jika permintaan pemrosesan citra mencakup operasi penskalaan, letakkan parameter konversi format di akhir daftar parameter pemrosesan. Contohnya: image/resize,w_100/format,jpg.

• Jika permintaan pemrosesan citra mencakup operasi penskalaan dan watermark, tambahkan parameter konversi format setelah parameter penskalaan. Contohnya: image/resize,w_100/format,jpg/watermark,....

• Jika citra sumber tidak memiliki alpha channel dan Anda mengonversinya ke format yang memiliki alpha channel, seperti PNG, WebP, atau BMP, area transparan akan diisi dengan warna putih secara default. Perhatikan bahwa OSS tidak mendukung pengisian area transparan dengan warna hitam.

Metode

Anda dapat mengatur parameter pemrosesan citra menggunakan URL file, SDK, atau API. URL file hanya dapat digunakan untuk citra dengan akses public-read. Untuk citra privat, Anda harus menggunakan SDK atau API. Untuk informasi selengkapnya, lihat Metode pemrosesan citra.

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GetObjectRequest;
import java.io.File;

public class Demo {
    public static void main(String[] args) throws Throwable {
        // Titik akhir wilayah China (Hangzhou) digunakan sebagai contoh. Tentukan titik akhir yang sebenarnya.
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // Tentukan wilayah yang sesuai dengan titik akhir, misalnya cn-hangzhou.
        String region = "cn-hangzhou";
        // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // Tentukan nama bucket, misalnya examplebucket.
        String bucketName = "examplebucket";
        // Tentukan path lengkap objek. Path lengkap tidak boleh mengandung nama bucket.
        String objectName = "src.gif";
        // Tentukan path lengkap file lokal, misalnya D:\\dest.jpg. Jika file lokal yang ditentukan sudah ada, file tersebut akan ditimpa. Jika belum ada, file tersebut akan dibuat.
        String pathName = "D:\\dest.png";

        // Buat instance OSSClient.
        // Saat instance OSSClient tidak lagi digunakan, panggil metode shutdown untuk melepaskan sumber daya.
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // Konversi citra sumber ke format PNG.
            String image = "image/format,png";
            GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
            request.setProcess(image);
            // Beri nama citra hasil sebagai dest.png dan simpan ke path lokal.
            // Jika Anda hanya menentukan nama file, seperti dest.png, tanpa path lokal, file akan disimpan ke path lokal proyek secara default.
            ossClient.getObject(request, new File("D:\\dest.png"));
        } catch (OSSException oe) {
            System.out.println("Terjadi OSSException, yang berarti permintaan Anda sampai ke OSS, "
                    + "tetapi ditolak dengan tanggapan error karena suatu alasan.");
            System.out.println("Pesan Error:" + oe.getErrorMessage());
            System.out.println("Kode Error:" + oe.getErrorCode());
            System.out.println("ID Permintaan:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Terjadi ClientException, yang berarti klien mengalami "
                    + "masalah internal serius saat mencoba berkomunikasi dengan OSS, "
                    + "seperti tidak dapat mengakses jaringan.");
            System.out.println("Pesan Error:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;

// Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
$provider = new EnvironmentVariableCredentialsProvider();
// Tetapkan yourEndpoint ke titik akhir wilayah tempat bucket berada. Titik akhir wilayah China (Hangzhou) digunakan sebagai contoh: https://oss-cn-hangzhou.aliyuncs.com.
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// Tentukan nama bucket, misalnya examplebucket.
$bucket= "examplebucket";
// Tentukan path lengkap objek. Path lengkap tidak boleh mengandung nama bucket.
$object = "src.gif";
// Tentukan path lengkap file lokal, misalnya D:\\dest.png. Jika file lokal yang ditentukan sudah ada, file tersebut akan ditimpa. Jika belum ada, file tersebut akan dibuat.
// Jika Anda hanya menentukan nama file, seperti dest.png, tanpa path lokal, file akan disimpan ke path lokal proyek secara default.
$download_file = "D:\\dest.png";

$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,        
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // Tentukan ID wilayah umum Alibaba Cloud.
        "region" => "cn-hangzhou"
    );
$ossClient = new OssClient($config);

// Konversi citra sumber ke format PNG.
$image = "image/format,png";

$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => $image);

// Simpan citra hasil ke path lokal.
$ossClient->getObject($bucket, $object, $options);                           

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

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Tetapkan yourEndpoint ke titik akhir wilayah tempat bucket berada. Titik akhir wilayah China (Hangzhou) digunakan sebagai contoh: https://oss-cn-hangzhou.aliyuncs.com.
## Tetapkan titik akhir ke wilayah tempat bucket berada. Titik akhir wilayah China (Hangzhou) digunakan sebagai contoh: https://oss-cn-hangzhou.aliyuncs.com.
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# Tentukan ID wilayah umum Alibaba Cloud.
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
# Tentukan nama citra sumber. Jika citra tidak berada di direktori root bucket, Anda harus menentukan path lengkapnya, misalnya exampledir/src.gif.
key = 'src.gif'
# Tentukan nama citra hasil.
new_pic = 'D:\\dest.png'

# Konversi citra sumber ke format PNG.
image = 'image/format,png'
bucket.get_object_to_file(key, new_pic, process=image)

package main

import (
	"fmt"
	"os"

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

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// Buat instance OSSClient.
	// Tetapkan yourEndpoint ke titik akhir bucket. Titik akhir wilayah China (Hangzhou) digunakan sebagai contoh: https://oss-cn-hangzhou.aliyuncs.com. Tentukan titik akhir sesuai wilayah Anda.
	client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
	if err != nil {
		HandleError(err)
	}

	// Tentukan nama bucket tempat citra sumber disimpan, misalnya examplebucket.
	bucketName := "examplebucket"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}

	// Tentukan nama citra sumber. Jika citra tidak berada di direktori root bucket, Anda harus menentukan path lengkapnya, misalnya exampledir/src.gif.
	sourceImageName := "src.gif"
	// Tentukan nama citra hasil.
	targetImageName := "D://dest.png"
	// Konversi citra sumber ke format PNG.
	image := "image/format,png"
	err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
	if err != nil {
		HandleError(err)
	}
}

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

Parameter

Aksi: format

Contoh

FAQ

Tentang kualitas citra hasil

Format citra memiliki kualitas default. Jika Anda tidak menentukan kualitas selama konversi format, OSS akan menggunakan kualitas default tersebut.

Jika Anda ingin meningkatkan kualitas citra, Anda dapat mengatur kualitas ke 100 selama konversi format, misalnya menggunakan ?x-oss-process=image/quality,Q_100. Untuk informasi selengkapnya tentang konversi kualitas, lihat Konversi kualitas.

Apakah proses konversi format citra memengaruhi kecepatan pemuatan halaman?

Konversi format citra dilakukan secara dinamis saat permintaan masuk. Sedikit penundaan mungkin terjadi pada akses pertama. Namun, citra yang telah dikonversi biasanya berukuran lebih kecil dan dalam format yang lebih efisien, seperti ketika Anda mengonversi citra PNG ke format WebP. Hal ini membantu mempercepat pemuatan berikutnya dan meningkatkan performa halaman secara keseluruhan.

Bisakah saya mengonversi citra GIF ke format MP4?

Untuk mengonversi citra GIF ke format MP4, kirim tiket untuk meminta fitur ini.