media processing parameter description for vod api - ApsaraVideo VOD

EncryptConfig: HLS şifreleme ayarları

Alan Adı	Tür	Zorunlu	Açıklama
CipherText	String	Evet	Anahtarın şifreli metni. Düz metin anahtarı elde etmek için bu parametreyi kullanın.
DecryptKeyUri	String	Evet	Anahtarın şifreli metnine dayanarak şifre çözme anahtarını almak için kullanılan URI. Örnek: `http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk****`.
KeyServiceType	String	Evet	Anahtar hizmetinin türü. Varsayılan değer: `KMS`. KMS, Alibaba Cloud Key Management Service'in kısaltmasıdır.

EncryptConfig parametre örneği

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

OverrideParams: Kod dönüştürme işi parametre geçersiz kılma ayarları

Alan Adı	Tür	Zorunlu	Açıklama
Watermarks	Watermark[]	Hayır	Filigranların değiştirilmesi için gereklidir.
SubtitleSetting	SubtitleSetting	Hayır	Altyazıların değiştirilmesi için gereklidir. Not Kullandığınız kod dönüştürme şablonunda altyazı parametreleri önceden yapılandırılmış olmalıdır. Aksi takdirde altyazı parametrelerinin üzerine yazılmaz. Altyazı ayarları hakkında daha fazla bilgi için bkz. SubtitleConfig. Değiştirilecek altyazı dosyasının URL'si bir HTTP (HTTPS değil) OSS URL'si olmalıdır. CDN hızlandırmalı alan adlarının URL'leri desteklenmez. Örnek: `http://out-dda****.cn-shanghai.aliyuncs.com/subtitle/subtitle.ass`
PackageSubtitleSetting	PackageSubtitleSetting[]	Hayır	Uyarlanabilir bit hızı akışı paketleme sırasında altyazı URL'sinin üzerine yazılması için gereklidir.
TranscodeTemplateList	TranscodeTemplate[]	Hayır	Şablon parametrelerinin değiştirilmesi için gereklidir. Kod dönüştürme şablonundaki Video, Audio, Clip, Rotate ve TranscodeFileRegular parametrelerinin üzerine yazılmasını destekler. Orijinal kalite şablonlarının parametrelerinin üzerine yazılamaz. Parametrelerin üzerine yazmak için TranscodeTemplateId parametresi gereklidir.

Not

Şu anda yalnızca bir filigranın görüntü dosyasını veya metin içeriğini değiştirebilirsiniz.

TranscodeTemplateList örneği

        [
                {
                  "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: Filigran parametre geçersiz kılma ayarları

Alan adı	Tür	Zorunlu	Açıklama
WatermarkId	String	Evet	Kod dönüştürme şablonuyla ilişkili filigranın ID'si. Bu kimliği ApsaraVideo VOD konsolunda bulabilirsiniz. Daha fazla bilgi için bkz. Watermark management.
FileUrl	String	Hayır	Filigran dosyasının OSS URL'si. Bu parametre görüntü filigranları için gereklidir. Bir dosyanın OSS URL'sini nasıl alacağınız hakkında daha fazla bilgi için bkz. CreateUploadAttachedMedia.
Content	String	Hayır	Metin filigranının içeriği. Bu parametre metin filigranları için gereklidir.

Önemli

FileUrl değeri, video kaynağının depolama konumuyla eşleşmelidir.

SubtitleSetting: Altyazı parametre geçersiz kılma ayarları

Alan Adı	Tür	Zorunlu	Açıklama
SubtitleList	Subtitle	Evet	Değiştirilecek altyazıların listesi.

Subtitle Configuration

Alan Adı

Tür

Zorunlu

Açıklama

SubtitleUrl

String

Evet

Altyazı dosyasının OSS URL'si. HTTPS URL'leri desteklenmez.

CharEncode

String

Evet

Altyazı içeriğinin kodlama biçimi. Geçerli değerler:

auto (otomatik algılama)
UTF-8
GBK
BIG5

Not

CharEncode değerini belirli bir kodlama biçimine ayarlayın. Bu parametreyi auto olarak ayarlarsanız kodlama biçimi yanlış algılanabilir.

PackageSubtitleSetting: Paketlenmiş altyazı değiştirme parametreleri

Alan adı	Tür	Zorunlu	Açıklama
PackageSubtitleList	PackageSubtitle[]	Evet	Altyazıların değiştirilmesi için gereklidir.

PackageSubtitle: Paketlenmiş altyazı değiştirme parametreleri

Alan adı	Tür	Zorunlu	Açıklama
SubtitlePackageTemplateId	String	Evet	Altyazı paketleme şablonunun ID'si.
Language	String	Evet	Dil. Daha fazla bilgi için RFC 5646'ya bakın. Örnek: en-US. Not Language parametresi yalnızca değiştirilecek altyazı dosyasını almak için kullanılır. Dilin kendisi değiştirilmez.
SubtitleUrl	String	Evet	Altyazı URL'si. Yalnızca HTTP OSS URL'leri desteklenir. HTTP CDN URL'leri ve HTTPS URL'leri desteklenmez. Not Şu anda yalnızca bir HTTP URL'si desteklenmektedir. Altyazı dosyaları yalnızca ApsaraVideo VOD tarafından tahsis edilen sistem paketlerinde depolanabilir.

Not

SubtitlePackageTemplateId ve Language parametreleri, değiştirilecek altyazının URL'sini almak için kullanılır. Dilin kendisi değiştirilemez.

OverrideParams parametre örneği

{
  "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: Filigran ayarları

Filigran türü Image ise

Parametre adı	Parametre türü	Zorunlu	Açıklama
Dx	String	Evet	Yatay ofset iki biçimde belirtilebilir. Piksel değeri: [8,4096] Ekran yüzdesi: (0,1). 0 değeri %0'ı, 1 değeri %100'ü ve 0,5 değeri %50'yi temsil eder. Diğer değerler orantılı olarak yorumlanır.
Dy	String	Evet	Dikey ofset iki biçimde belirtilebilir. Piksel değeri: [8,4096] Ekran oranı: (0,1). 0 değeri ekranın %0'ını, 1 değeri %100'ünü ve 0,5 değeri %50'sini temsil eder. Diğer değerler aynı şekilde yorumlanır.
Width	String	Evet	Filigran genişliğini iki biçimde belirtebilirsiniz. Piksel değeri: [8,4096] Ekran oranı: (0,1). 0 değeri ekranın %0'ını, 1 değeri %100'ünü ve 0,5 değeri %50'sini temsil eder. Diğer değerler aynı şekilde yorumlanır.
Height	String	Evet	Yükseklik iki değer biçimini destekler. Piksel değeri: [8,4096] Görüntü oranı: (0,1). 0 değeri görüntü alanının %0'ını, 1 değeri %100'ünü ve 0,5 değeri %50'sini temsil eder. Diğer değerler orantılı olarak yorumlanır.
ReferPos	String	Evet	Filigran konumu: BottomRight (sağ alt) BottomLeft (sol alt) TopRight (sağ üst) TopLeft (sol üst)
Timeline	Timeline	Hayır	Filigranın zaman çizelgesi. Bu parametre, filigran görüntüsünün başlangıç ve bitiş zamanlarını belirtir. Değer bir JSON dizesidir.

Önemli

Timeline parametresi yalnızca görüntü filigranları için geçerlidir.

Filigran türü Text ise

Parametre adı	Parametre türü	Zorunlu	Açıklama
Content	String	Evet	Metin filigranının içeriği. Örnek: "Text watermark".
FontName	String	Hayır	Font name
FontColor	String	Hayır	Font color
FontAlpha	String	Hayır	Yazı tipi saydamlığı. Geçerli değerler: (0, 1]. Varsayılan değer: 1,0.
BorderColor	String	Hayır	Outline color
Top	Integer	Hayır	Metnin üst kenar boşluğu. Yalnızca tamsayı değerleri desteklenir. Birim: px. Varsayılan değer: 0. Geçerli değerler: [0, 4096].
Left	Integer	Hayır	Metnin sol kenar boşluğu. Yalnızca tamsayı değerleri desteklenir. Birim: px. Varsayılan değer: 0. Geçerli değerler: [0, 4096].
FontSize	Integer	Hayır	Yazı tipi boyutu. Yalnızca tamsayı değerleri desteklenir. Varsayılan değer: 16. Geçerli değerler: (4, 120).
BorderWidth	Integer	Hayır	Ana hat genişliği. Yalnızca tamsayı değerleri desteklenir. Birim: px. Varsayılan değer: 0. Geçerli değerler: (0, 4096].

Filigran Zaman Çizelgesi

Parametre adı	Tür	Zorunlu	Açıklama
Start	String	Evet	Filigranın görünmeye başladığı zaman. Birim: saniye. Değer bir sayı olmalıdır. Varsayılan değer: 0.
Duration	String	Evet	Filigranın görüntülendiği süre. Birim: saniye. Geçerli değerler: bir sayı veya `ToEND`. Varsayılan değer: `ToEND`, bu da videonun sonunu gösterir.

Önemli

Timeline parametresi yalnızca görüntü filigranları için geçerlidir.

Yazı tipi adı

Yazı tipi adı	Açıklama
SimSun	Song yazı tipi
WenQuanYi Zen Hei	WenQuanYi Zen Hei
WenQuanYi Zen Hei Mono	WenQuanYi Zen Hei Monospace
WenQuanYi Zen Hei Sharp	WenQuanYi Zen Hei Bitmap
Yuanti SC	Basitleştirilmiş Yuvarlak, Normal

Video anlık görüntüleri

Anlık görüntü şablonu ayarları

SnapshotTemplateConfig

Ad

Tür

Zorunlu

Açıklama

SnapshotType

String

Evet

Anlık görüntü türü. Geçerli değerler:

NormalSnapshot: normal bir anlık görüntü.
SpriteSnapshot: sprite.
WebVttSnapshot: WebVTT anlık görüntüsü.

SnapshotConfig

JSON

Evet

Anlık görüntü şablonu ayarları. Ayarlar SnapshotType değerine göre değişir. Daha fazla bilgi için aşağıdaki SnapshotConfig bölümüne bakın.

SnapshotConfig

Not

Bir sprite, normal anlık görüntüler alınarak ve bunlar birleştirilerek oluşturulur. Bu nedenle, SnapshotConfig parametresi hem normal anlık görüntüler hem de spritelar için gereklidir.

Parametre Adı	Tür	Zorunlu	Açıklama
FrameType	String	Evet	Anlık görüntüler için çerçeve türü. Geçerli değerler: intra: anahtar kare. normal: normal kare.
Count	Long	Evet	Yakalanacak anlık görüntü sayısı.
Interval	Long	Evet	Anlık görüntülerin yakalanma aralığı. Değer 0'dan büyük veya 0'a eşit olmalıdır. Birim: saniye. 0 değeri, anlık görüntülerin video süresine ve Count değerine göre eşit aralıklarla yakalandığını gösterir.
SpecifiedOffsetTime	Long	Evet	Anlık görüntü yakalamaya başlama zamanı. Birim: milisaniye.
Width	Integer	Hayır	Anlık görüntünün genişliği. Geçerli değerler: [8, 4096]. Varsayılan değer: kaynak videonun genişliği. Birim: px.
Height	Integer	Hayır	Anlık görüntünün yüksekliği. Geçerli değerler: [8, 4096]. Varsayılan değer: kaynak videonun yüksekliği. Birim: px.
SpriteSnapshotConfig	JSON	Hayır	Sprite ayarları. SnapshotType değeri SpriteSnapshot olarak ayarlanırsa bu parametre gereklidir. Daha fazla bilgi için aşağıdaki SpriteSnapshotConfig bölümüne bakın.
Format	String	Hayır	Çıktı anlık görüntü dosyasının biçimi. Değeri `vtt` olarak ayarlayın. Bu parametre yalnızca SnapshotType değeri `WebVttSnapshot` olarak ayarlandığında geçerlidir.
SubOut	JSON	Hayır	SnapshotType değeri WebVttSnapshot olarak ayarlandığında anlık görüntülerin nasıl görüntüleneceğini kontrol eder. Daha fazla bilgi için aşağıdaki SubOut bölümüne bakın.

SpriteSnapshotConfig

Parametre adı	Tür	Zorunlu	Açıklama
CellWidth	String	Hayır	Sprite'deki her küçük görüntünün genişliği. Varsayılan değer: normal bir anlık görüntünün genişliği. Birim: px.
CellHeight	String	Hayır	Sprite'deki her küçük görüntünün yüksekliği. Varsayılan değer: normal bir anlık görüntünün yüksekliği. Birim: px.
Padding	String	Evet	Her küçük görüntünün dolgusu. Birim: px.
Margin	String	Evet	Her küçük görüntünün kenar boşluğu. Birim: px.
Color	String	Evet	Sprite'ın arka plan rengi. Daha fazla bilgi için bkz. Renk ayarları. Not RGB değerleri kullanılarak renk ayarlama desteklenmez.
Columns	String	Evet	Küçük görüntülerin sütun sayısı. Geçerli değerler: [1, 10000].
Lines	String	Evet	Küçük görüntülerin satır sayısı. Geçerli değerler: [1, 10000].
KeepCellPic	String	Evet	Küçük görüntülerin saklanıp saklanmayacağını belirtir. Geçerli değerler: keep: Sakla. delete: Ögeyi kaldırır.

SubOut

Parametre Adı

Tür

Zorunlu

Açıklama

IsSptFrag

String

Evet

Geçerli değerler:

false: Her anlık görüntüyü ayrı bir görüntü olarak depolar.
true: Depolamadan önce anlık görüntüleri bir sprite'a benzer büyük bir görüntüde birleştirir.

Anlık görüntü şablonu örneği

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

Videolardan hareketli görüntüler

Hareketli görüntü şablonu ayarları

DynamicImageTemplateConfig

Parametre Adı	Tür	Zorunlu	Açıklama
Name	String	Evet	Hareketli görüntü şablonunun adı.
Video	JSON	Evet	Hareketli görüntü için video ayarları. Daha fazla bilgi için aşağıdaki Video bölümüne bakın.
Container	JSON	Evet	Hareketli görüntü için kapsayıcı biçimi ayarları. Daha fazla bilgi için aşağıdaki Container bölümüne bakın.
Clip	JSON	Evet	Hareketli görüntü için kırpma ayarları. Daha fazla bilgi için aşağıdaki Clip bölümüne bakın.
SetDefaultCover	String	Evet	Oluşturulan hareketli görüntünün varsayılan olarak video küçük resmi olarak ayarlanıp ayarlanmayacağını belirtir. Geçerli değerler: true: Varsayılan küçük resim olarak ayarla. Varsayılan küçük resim olarak ayarlama.

Video

Not

Width ve Height ayarlanmazsa çıktı hareketli görüntü, kaynak video ile aynı boyutlara sahip olur.
Yalnızca Width ayarlanırsa yükseklik, kaynak videonun en boy oranına göre orantılı olarak ölçeklendirilir.
Yalnızca Height ayarlanırsa genişlik, kaynak videonun en boy oranına göre orantılı olarak ölçeklendirilir.

Parametre Adı	Tür	Zorunlu	Açıklama
Width	String	Hayır	Çıktı hareketli görüntüsünün genişliği. Geçerli değerler: [128, 4096].
Height	String	Hayır	Çıktı hareketli görüntüsünün yüksekliği. Geçerli değerler: [128, 4096].
Fps	String	Evet	Kare hızı. Geçerli değerler: (0, 60].

Container

Parametre adı

Tür

Zorunlu

Açıklama

Format

String

Evet

Çıktı hareketli görüntüsünün biçimi. Geçerli değerler:

webp
gif

Clip

Parametre adı	Tür	Zorunlu	Açıklama
TimeSpan	JSON	Evet	Kırpma için zaman çizelgesi ayarları. Daha fazla bilgi için aşağıdaki TimeSpan bölümüne bakın.

TimeSpan

Not

Videoyu bir süreye göre kırpmak için hem Seek hem de Duration parametrelerini belirtin. Videoyu baştan ve sondan keserek kırpmak için hem Seek hem de End parametrelerini belirtin.
Seek, Duration ve End parametrelerini aynı anda belirtirseniz Seek ve End parametreleri etkili olur.

Parametre Adı	Tür	Zorunlu	Açıklama
Seek	String	Evet	Hareketli görüntü için kırpmanın başlangıç zamanı. Biçim 1: sssss[.SSS]. Geçerli değerler: [0.000, 86399.999]. Örnek: 0 Biçim 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000, 23:59:59.999]. Örnek: 00:00:05.003
Duration	String	Hayır	Kırpmanın süresi. Biçim 1: sssss[.SSS]. Geçerli değerler: [0.000, 86399.999]. Örnek: 15 Biçim 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000, 23:59:59.999]. Örnek: 00:00:10.003
End	String	Hayır	Atılacak videonun kuyruk kısmının süresi. Bu parametreyi belirtirseniz Duration parametresi geçersiz hale gelir. Biçim 1: sssss[.SSS]. Geçerli değerler: [0.000, 86399.999]. Örnek: 12000.55 Biçim 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000, 23:59:59.999]. Örnek: 00:00:15.003

Hareketli görüntü şablonu örneği

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