deskripsi parameter pemrosesan media untuk api vod - ApsaraVideo VOD

Topik ini menjelaskan parameter pemrosesan media untuk API ApsaraVideo VOD.

EncryptConfig: Pengaturan enkripsi HLS

Field Name	Tipe	Diperlukan	Deskripsi
CipherText	String	Ya	Ciphertext dari kunci. Gunakan ini untuk mendapatkan kunci plaintext.
DecryptKeyUri	String	Ya	URI yang digunakan untuk memperoleh kunci dekripsi berdasarkan ciphertext kunci tersebut. Contoh: `http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk****`.
KeyServiceType	String	Ya	Jenis layanan kunci. Nilai default: `KMS`. KMS adalah singkatan dari Alibaba Cloud Key Management Service.

Contoh parameter EncryptConfig

{
  "CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk****",
  "DecryptKeyUri":"http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk****",
  "KeyServiceType":"KMS"
}

OverrideParams: Pengaturan penggantian parameter pekerjaan transkoding

Field Name	Tipe	Diperlukan	Deskripsi
Watermarks	Watermark[]	Tidak	Diperlukan untuk mengganti watermark.
SubtitleSetting	SubtitleSetting	Tidak	Diperlukan untuk mengganti subtitle. Catatan Template transkoding yang Anda gunakan harus telah memiliki parameter subtitle yang dikonfigurasi sebelumnya. Jika tidak, parameter subtitle tidak akan ditimpa. Untuk informasi selengkapnya tentang pengaturan subtitle, lihat SubtitleConfig. URL file subtitle pengganti harus berupa URL OSS HTTP (bukan HTTPS). URL dari domain akselerasi CDN tidak didukung. Contoh: `http://out-dda****.cn-shanghai.aliyuncs.com/subtitle/subtitle.ass`
PackageSubtitleSetting	PackageSubtitleSetting[]	Tidak	Diperlukan untuk menimpa URL subtitle selama pengemasan streaming bitrate adaptif.
TranscodeTemplateList	TranscodeTemplate[]	Tidak	Diperlukan untuk mengganti parameter template. Mendukung penimpaan parameter Video, Audio, Clip, Rotate, dan TranscodeFileRegular dalam template transkoding. Parameter template kualitas asli tidak dapat ditimpa. Parameter TranscodeTemplateId diperlukan untuk menimpa parameter.

Catatan

Saat ini, Anda hanya dapat mengganti file gambar atau konten teks dari watermark.

Contoh TranscodeTemplateList

        [
                {
                  "TranscodeTemplateId":"9580424e49b28c952a46544e3e8f****",
                  "Video":{
                          "Width":720,
                          "Height":480,
                          "Bitrate":"600"
                  },
                  "Audio":{
                          "Bitrate":128
                  },
                  "Clip":{
                          "TimeSpan":{
                                "Seek":"1",
                                "Duration":"5"
                        },
                  "Rotate":"270",
                  "TranscodeFileRegular":"{MediaId}/{JobId}/{PlayDefinition}"
                  }
                }
        ]

Watermark: Pengaturan penggantian parameter watermark

Field name	Tipe	Diperlukan	Deskripsi
WatermarkId	String	Ya	ID watermark yang terkait dengan template transkoding. Anda dapat menemukan ID tersebut di Konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Watermark management.
FileUrl	String	Tidak	URL OSS file watermark. Parameter ini wajib untuk watermark gambar. Untuk informasi selengkapnya tentang cara mendapatkan URL OSS file, lihat CreateUploadAttachedMedia.
Content	String	Tidak	Konten watermark teks. Parameter ini wajib untuk watermark teks.

Penting

FileUrl harus sesuai dengan lokasi penyimpanan sumber video.

SubtitleSetting: Pengaturan penggantian parameter subtitle

Field Name	Tipe	Diperlukan	Deskripsi
SubtitleList	Subtitle	Ya	Daftar subtitle pengganti.

Konfigurasi Subtitle

Field Name

Tipe

Diperlukan

Deskripsi

SubtitleUrl

String

URL OSS file subtitle. URL HTTPS tidak didukung.

CharEncode

String

Format encoding konten subtitle. Nilai valid:

auto (deteksi otomatis)
UTF-8
GBK
BIG5

Catatan

Tetapkan CharEncode ke format encoding tertentu. Jika Anda mengatur parameter ini ke auto, format encoding mungkin terdeteksi secara salah.

PackageSubtitleSetting: Parameter penggantian subtitle terkemas

Field name	Tipe	Diperlukan	Deskripsi
PackageSubtitleList	PackageSubtitle[]	Ya	Diperlukan untuk mengganti subtitle.

PackageSubtitle: Parameter penggantian subtitle terkemas

Field name	Tipe	Diperlukan	Deskripsi
SubtitlePackageTemplateId	String	Ya	ID template pengemasan subtitle.
Language	String	Ya	Bahasa. Untuk informasi selengkapnya, lihat RFC 5646. Contoh: en-US. Catatan Parameter Language hanya digunakan untuk mengambil file subtitle yang akan diganti. Bahasa itu sendiri tidak diganti.
SubtitleUrl	String	Ya	URL subtitle. Hanya URL OSS HTTP yang didukung. URL CDN HTTP dan URL HTTPS tidak didukung. Catatan Saat ini, hanya satu URL HTTP yang didukung. File subtitle hanya dapat disimpan di bucket sistem yang dialokasikan oleh ApsaraVideo VOD.

Catatan

Parameter SubtitlePackageTemplateId dan Language digunakan untuk mengambil URL subtitle yang akan diganti. Bahasa itu sendiri tidak dapat diganti.

Contoh parameter OverrideParams

{
  "Watermarks":[
    {
      "WatermarkId":"watermark1",
      "FileUrl":"http://****.bucket.aliyuncs.com/image/replace.png"
    },
    {
      "WatermarkId":"watermark2",
      "Content":"Watermark test"
    }
  ],
  "SubtitleSetting":{
          "SubtitleList":[
                {
                "SubtitleUrl":"http://outin-****.oss-cn-shanghai.aliyuncs.com/subtitles/7b850b-724c-4011-b885-dd16c****.ass",
                "CharEncode":"UTF-8"
                },
                {
                "SubtitleUrl":"http://outin-****.oss-cn-shanghai.aliyuncs.com/subtitles/7b86db-724c-4011-b885-dd161d****.srt",
                "CharEncode":"auto"
                }
        ]
  },
  "PackageSubtitleSetting": {
    "PackageSubtitleList": [
      {
        "Language": "en-US",
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395****", 
        "SubtitleUrl": "http://outin-****.oss-cn-shanghai.aliyuncs.com/789679188D1F36A00AEB****.vtt" 
      },
      {
        "Language": "ja",  
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395ad****",
        "SubtitleUrl": "http://outin-****.oss-cn-shanghai.aliyuncs.com/F43FD90FF4B936A00AEB****.vtt"
      }
    ]
  }
}

WatermarkConfig: Pengaturan watermark

Jika tipe watermark adalah Image

Parameter name	Parameter type	Diperlukan	Deskripsi
Dx	String	Ya	Offset horizontal tersedia dalam dua bentuk. Nilai piksel: [8,4096] Persentase layar: (0,1). Nilai 0 merepresentasikan 0%, nilai 1 merepresentasikan 100%, dan nilai 0,5 merepresentasikan 50%. Nilai lainnya diinterpretasikan secara proporsional.
Dy	String	Ya	Offset vertikal dapat ditentukan dalam dua format. Nilai piksel: [8,4096] Proporsi layar: (0,1). Nilai 0 merepresentasikan 0% layar, 1 merepresentasikan 100%, dan 0,5 merepresentasikan 50%. Nilai lainnya diinterpretasikan dengan cara yang sama.
Width	String	Ya	Anda dapat menentukan lebar watermark dalam dua format. Nilai piksel: [8,4096] Proporsi layar: (0,1). Nilai 0 merepresentasikan 0% layar, nilai 1 merepresentasikan 100%, dan nilai 0,5 merepresentasikan 50%. Nilai lainnya diinterpretasikan dengan cara yang sama.
Height	String	Ya	Watermark tinggi mendukung dua format nilai. Nilai piksel: [8,4096] Proporsi gambar: (0,1). Nilai 0 merepresentasikan 0% area gambar, 1 merepresentasikan 100%, dan 0,5 merepresentasikan 50%. Nilai lainnya diinterpretasikan secara proporsional.
ReferPos	String	Ya	Posisi watermark: BottomRight (kanan bawah) BottomLeft (kiri bawah) TopRight (kanan atas) TopLeft (kiri atas)
Timeline	Timeline	Tidak	Timeline watermark. Ini menentukan waktu mulai dan akhir tampilan watermark. Nilainya berupa string JSON.

Penting

Parameter Timeline hanya berlaku untuk watermark gambar.

Jika tipe watermark adalah Text

Parameter name	Parameter type	Diperlukan	Deskripsi
Content	String	Ya	Konten watermark teks. Contoh: "Text watermark".
FontName	String	Tidak	Nama font
FontColor	String	Tidak	Warna font
FontAlpha	String	Tidak	Transparansi font. Nilai yang valid: (0, 1]. Nilai default: 1.0.
BorderColor	String	Tidak	Warna garis luar
Top	Integer	Tidak	Margin atas teks. Hanya mendukung nilai integer. Satuan: px. Nilai default: 0. Nilai yang valid: [0, 4096].
Left	Integer	Tidak	Margin kiri teks. Hanya mendukung nilai integer. Satuan: px. Nilai default: 0. Nilai yang valid: [0, 4096].
FontSize	Integer	Tidak	Ukuran font. Hanya mendukung nilai integer. Nilai default: 16. Nilai yang valid: (4, 120).
BorderWidth	Integer	Tidak	Lebar garis luar. Hanya mendukung nilai integer. Satuan: px. Nilai default: 0. Nilai yang valid: (0, 4096].

Timeline Watermark

Parameter name	Tipe	Diperlukan	Deskripsi
Start	String	Ya	Waktu saat watermark mulai muncul. Satuan: detik. Nilainya harus berupa angka. Nilai default: 0.
Duration	String	Ya	Durasi tampilan watermark. Satuan: detik. Nilai yang valid: angka atau `ToEND`. Nilai default: `ToEND`, yang menunjukkan akhir video.

Penting

Parameter Timeline hanya berlaku untuk watermark gambar.

Nama font

Nama font	Deskripsi
SimSun	Song typeface
WenQuanYi Zen Hei	WenQuanYi Zen Hei
WenQuanYi Zen Hei Mono	WenQuanYi Zen Hei Monospace
WenQuanYi Zen Hei Sharp	WenQuanYi Zen Hei Bitmap
Yuanti SC	Simplified Round, Regular

Cuplikan video

Pengaturan templat snapshot

SnapshotTemplateConfig

Name

Tipe

Diperlukan

Deskripsi

SnapshotType

String

Jenis snapshot. Nilai yang valid:

NormalSnapshot: snapshot normal.
SpriteSnapshot: sprite.
WebVttSnapshot: snapshot WebVTT.

SnapshotConfig

JSON

Pengaturan templat snapshot. Pengaturan ini berbeda-beda tergantung pada nilai SnapshotType. Untuk informasi selengkapnya, lihat SnapshotConfig di bawah.

SnapshotConfig

Catatan

Sprite dibuat dengan mengambil snapshot normal lalu menggabungkannya. Oleh karena itu, parameter SnapshotConfig diperlukan baik untuk snapshot normal maupun sprite.

Parameter Name	Type	Diperlukan	Deskripsi
FrameType	String	Ya	Jenis frame untuk snapshot. Nilai yang valid: intra: keyframe. normal: frame normal.
Count	Long	Ya	Jumlah snapshot yang diambil.
Interval	Long	Ya	Interval pengambilan snapshot. Nilainya harus lebih besar dari atau sama dengan 0. Satuan: detik. Nilai 0 berarti snapshot diambil pada interval yang merata berdasarkan durasi video dan nilai Count.
SpecifiedOffsetTime	Long	Ya	Waktu mulai pengambilan snapshot. Satuan: milidetik.
Width	Integer	Tidak	Lebar snapshot. Nilai yang valid: [8, 4096]. Nilai default: lebar video sumber. Satuan: px.
Height	Integer	Tidak	Tinggi snapshot. Nilai yang valid: [8, 4096]. Nilai default: tinggi video sumber. Satuan: px.
SpriteSnapshotConfig	JSON	Tidak	Pengaturan sprite. Parameter ini wajib jika SnapshotType diatur ke SpriteSnapshot. Untuk informasi selengkapnya, lihat SpriteSnapshotConfig di bawah.
Format	String	Tidak	Format file snapshot output. Tetapkan nilainya ke `vtt`. Parameter ini hanya berlaku jika SnapshotType diatur ke `WebVttSnapshot`.
SubOut	JSON	Tidak	Mengontrol cara snapshot ditampilkan ketika SnapshotType diatur ke WebVttSnapshot. Untuk informasi selengkapnya, lihat SubOut di bawah.

SpriteSnapshotConfig

Parameter name	Jenis	Diperlukan	Deskripsi
CellWidth	String	Tidak	Lebar setiap gambar kecil dalam sprite. Nilai default: lebar snapshot normal. Satuan: px.
CellHeight	String	Tidak	Tinggi setiap gambar kecil dalam sprite. Nilai default: tinggi snapshot normal. Satuan: px.
Padding	String	Ya	Padding setiap gambar kecil. Satuan: px.
Margin	String	Ya	Margin setiap gambar kecil. Satuan: px.
Color	String	Ya	Warna latar belakang sprite. Untuk informasi selengkapnya, lihat Pengaturan warna. Catatan Pengaturan warna menggunakan nilai RGB tidak didukung.
Columns	String	Ya	Jumlah kolom gambar kecil. Nilai yang valid: [1, 10000].
Lines	String	Ya	Jumlah baris gambar kecil. Nilai yang valid: [1, 10000].
KeepCellPic	String	Ya	Menentukan apakah gambar kecil disimpan. Nilai yang valid: keep: Pertahankan. delete: Hapus item.

SubOut

Parameter Name

Tipe

Diperlukan

Deskripsi

IsSptFrag

String

Nilai valid:

false: Simpan setiap snapshot sebagai gambar terpisah.
true: Gabungkan snapshot menjadi satu gambar besar mirip sprite sebelum disimpan.

Contoh templat snapshot

{
  "SnapshotConfig": {
    "Count": 10,
    "SpecifiedOffsetTime": 0,
    "Interval": 1
  },
  "SnapshotType": "NormalSnapshot"
}

Gambar animasi dari video

Pengaturan templat gambar animasi

DynamicImageTemplateConfig

Parameter Name	Tipe	Diperlukan	Deskripsi
Name	String	Ya	Nama templat gambar animasi.
Video	JSON	Ya	Pengaturan video untuk gambar animasi. Untuk informasi selengkapnya, lihat Video di bawah.
Container	JSON	Ya	Pengaturan format kontainer untuk gambar animasi. Untuk informasi selengkapnya, lihat Container di bawah.
Clip	JSON	Ya	Pengaturan pemotongan untuk gambar animasi. Untuk informasi selengkapnya, lihat Clip di bawah.
SetDefaultCover	String	Ya	Menentukan apakah gambar animasi yang dihasilkan diatur sebagai Gambar mini video secara default. Nilai yang valid: true: Atur sebagai Gambar mini default. false: Jangan atur sebagai Gambar mini default.

Video

Catatan

Jika Anda tidak mengatur Width dan Height, gambar animasi output memiliki dimensi yang sama dengan video sumber.
Jika Anda hanya mengatur Width, tinggi diskalakan secara proporsional berdasarkan rasio aspek video sumber.
Jika Anda hanya mengatur Height, lebar diskalakan secara proporsional berdasarkan rasio aspek video sumber.

Parameter Name	Tipe	Diperlukan	Deskripsi
Width	String	Tidak	Lebar gambar animasi output. Nilai yang valid: [128, 4096].
Height	String	Tidak	Tinggi gambar animasi output. Nilai yang valid: [128, 4096].
Fps	String	Ya	Laju frame. Nilai yang valid: (0, 60].

Container

Parameter name

Type

Diperlukan

Deskripsi

Format

String

Format gambar animasi output. Nilai yang valid:

webp
gif

Clip

Parameter name	Tipe	Diperlukan	Deskripsi
TimeSpan	JSON	Ya	Pengaturan timeline untuk pemotongan. Untuk informasi selengkapnya, lihat TimeSpan di bawah.

TimeSpan

Catatan

Untuk memotong video berdasarkan durasi, tentukan kedua parameter Seek dan Duration. Untuk memotong video dengan memangkas awal dan akhir, tentukan kedua parameter Seek dan End.
Jika Anda menentukan Seek, Duration, dan End secara bersamaan, parameter Seek dan End yang berlaku.

Parameter Name	Tipe	Diperlukan	Deskripsi
Seek	String	Ya	Waktu mulai klip untuk gambar animasi. Format 1: sssss[.SSS]. Nilai yang valid: [0.000, 86399.999]. Contoh: 0 Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000, 23:59:59.999]. Contoh: 00:00:05.003
Duration	String	Tidak	Durasi klip. Format 1: sssss[.SSS]. Nilai yang valid: [0.000, 86399.999]. Contoh: 15 Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000, 23:59:59.999]. Contoh: 00:00:10.003
End	String	Tidak	Durasi bagian akhir video yang akan dibuang. Jika Anda menentukan parameter ini, parameter Duration menjadi tidak berlaku. Format 1: sssss[.SSS]. Nilai yang valid: [0.000, 86399.999]. Contoh: 12000.55 Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000, 23:59:59.999]. Contoh: 00:00:15.003

Contoh templat gambar animasi

{
  "Video": {
    "Fps": 5,
    "Width": 1024
  },
  "Clip": {
    "TimeSpan": {
      "Seek": 0,
      "Duration": 15
    }
  },
  "Container": {
    "Format": "gif"
  },
  "SetDefaultCover": "false"
}