Basic data types of the ApsaraVideo VOD API - ApsaraVideo VOD

Temel Medya Varlığı Bilgileri

Video: ses ve video bilgileri

Ad	Tür	Açıklama
VideoId	String	Ses veya videonun kimliği.
Title	String	Ses veya videonun başlığı.
Description	String	Ses veya videonun açıklaması.
Duration	Float	Ses veya videonun süresi. Birim: saniye.
CoverURL	String	Ses veya videonun küçük resim URL'si.
Durum	String	Ses veya videonun durumu. Daha fazla bilgi için bkz. Durum: bir ses veya video dosyasının durumu.
CreationTime	String	Ses veya videonun oluşturulma zamanı. Zaman UTC cinsinden olmalıdır.
Size	Long	Kaynak dosyanın boyutu. Birim: bayt.
Snapshots	String[]	Video anlık görüntüsü URL'leri.
CateId	Long	Ses veya videonun kategori kimliği.
CateName	String	Ses veya videonun kategori adı.
Tags	String	Ses veya videonun etiketleri. Birden çok etiketi virgül (,) ile ayırın.
TemplateGroupId	String	Ses veya video dosyalarını kod dönüştürmek için kullanılan kod dönüştürme şablonu grubunun kimliği.
StorageLocation	String	Ses veya video dosyasının depolama adresi.
AppId	String	Uygulamanın kimliği.

Durum: Ses ve video durumu

Değer	Açıklama	Notlar
Uploading	Yükleniyor	Bu, bir ses veya video dosyasının ilk durumudur. Ses veya video dosyasının yüklendiğini gösterir. Ses veya video dosyalarınız bu durumda uzun süre kalırsa, Medya varlığı yükleme hakkında SSS bölümünde açıklanan olası nedenlere ve çözümlere bakın. Bu durumdaki ses veya video dosyaları için yalnızca silme işlemlerine izin verilir. Yüklenen ses veya video dosyaları üzerinde kod dönüştürme, video kırpma veya medya varlığı inceleme gibi diğer işlemleri gerçekleştiremezsiniz.
UploadFail	Yükleme başarısız oldu	Yüklemeler ağ sorunları veya kaynak dosya bozulması nedeniyle başarısız olabilir. Yüklemeyi yeniden deneyin veya farklı bir kaynak dosya kullanın. Kaldığı yerden devam eden yükleme kullanılırken, yüklemenin başarısız olup olmadığını belirlemek imkansız olduğundan bu durum görünmez. Bu durumdaki ses veya video dosyaları için yalnızca silme işlemlerine izin verilir. Yüklenemeyen ses veya video dosyaları üzerinde kod dönüştürme, video kırpma veya medya varlığı inceleme gibi diğer işlemleri gerçekleştiremezsiniz.
UploadSucc	Yükleme tamamlandı	İş tasarımı veya diğer nedenler nedeniyle yükleme sırasında varsayılan kod dönüştürme işlemi atlanır ve geçerli oynatma akışları oluşturulamazsa veya kod dönüştürme olmayan bir şablon grubu kullanılırsa ve kaynak dosya MP4, FLV, M3U8, MP3 veya WEBM formatında değilse, video Yükleme tamamlandı olarak işaretlenir. Sonraki kod dönüştürme işlemi geçerli oynatma akışları oluşturduğunda, video Normal durumuna geçer. Bu durumdaki ses veya video dosyaları üzerinde kod dönüştürme, video kırpma ve medya varlığı inceleme gibi işlemler gerçekleştirebilirsiniz.
Transcoding	Kod dönüştürülüyor	Bu durumdaki medya dosyaları kod dönüştürülüyor. Bir video ilk kod dönüştürme işleminden geçiyorsa, geçerli oynatma akışları mevcut değildir ve oynatma URL'lerini almak için API işlemlerini çağırmanız mümkün değildir. Kod dönüştürme durumunu Tek Tanımlı Kod Dönüştürme Tamamlandı veya Kod dönüştürme tamamlandı olay bildirimlerini kullanarak belirleyebilirsiniz.
TranscodeFail	Kod dönüştürme başarısız oldu	Kod dönüştürme hataları genellikle kaynak dosyadaki hatalardan kaynaklanır. Hata iletisini Tek Tanımlı Kod Dönüştürme Tamamlandı veya Kod dönüştürme tamamlandı olay bildiriminden alabilirsiniz. Kod dönüştürme hatalarını giderme hakkında daha fazla bilgi için bkz. Kod dönüştürme hakkında SSS.
Checking	İnceleniyor	ApsaraVideo VOD konsolu > İnceleme Yönetimi > İnceleme Ayarları içinde Yayınlamadan Önce İncele özelliğini etkinleştirirseniz, ses veya video dosyaları başarılı kod dönüştürmeden sonra otomatik olarak inceleme akışına girer. Ses veya video dosyası durumu daha sonra İnceleniyor olarak işaretlenir. Manuel bir inceleme başlatmanız gerekir; aksi takdirde ses veya video dosyası İnceleniyor durumunda kalır. Bu durumdaki ses ve video dosyalarını yalnızca ApsaraVideo VOD konsolunu veya inceleme güvenlik IP adreslerini kullanarak oynatabilirsiniz. Oynatma için bu durumdaki ses veya video dosyalarının oynatma URL'lerini almak amacıyla API işlemlerini çağırmanız veya SDK'ları kullanmanız mümkün değildir. Ancak, bu dosyaları genel olarak erişilebilir olan geçerli oynatma URL'lerini kullanarak yine de oynatabilirsiniz. Bu durumdaki ses veya video dosyaları üzerinde kod dönüştürme ve video kırpma gibi işlemleri gerçekleştirebilirsiniz. Not Buradaki İnceleniyor durumu, ses veya video dosyasının durumunu (ApsaraVideo VOD konsolu > Medya Varlıkları > Ses/Video altında Durum sütununda görüntülenebilir) açıklar. Bu, makine destekli moderasyon için İnceleniyor durumundan (ApsaraVideo VOD konsolu > İnceleme Yönetimi > Video İnceleme içinde görüntülenebilir) farklıdır. Makine destekli moderasyon İnceleniyor durumu yalnızca makine inceleme işi durumunu açıklarken, ses veya video dosyasının İnceleniyor durumu hem makine destekli hem de manuel inceleme işi durumlarını açıklar.
Blocked	Engellendi	Bu durumdaki ses veya video yalnızca ApsaraVideo VOD konsolunda veya inceleme için beyaz listeye alınan IP adreslerinden oynatılabilir. Ses veya video için oynatma URL'sini almak üzere bir API veya SDK kullanmanız mümkün değildir. Ancak, zaten açıkta olan geçerli oynatma URL'leri normal şekilde oynatılabilir. Bu durumdaki ses veya video dosyaları için yalnızca silme işlemlerine izin verilir. Engellenen ses veya video dosyaları üzerinde kod dönüştürme, video kırpma veya medya varlığı inceleme gibi diğer işlemleri gerçekleştiremezsiniz.
Normal	Normal	Ses veya video dosyası için en az bir geçerli oynatma akışı mevcutsa, dosya Normal durumundadır. Bu durumdaki ses veya video dosyaları üzerinde kod dönüştürme, video kırpma, medya varlığı inceleme ve oynatma gibi tüm işlemleri gerçekleştirebilirsiniz.
ProduceFail	Birleştirme başarısız oldu	Bu, video kırpma üretiminin başarısız olduğunu gösterir. Video kırpma üretimi için ApsaraVideo VOD'un çevrimiçi düzenlemesini kullanırken, kullanılan tüm medya varlıklarının Normal durumda olduğundan emin olun. Aksi takdirde video üretimi başarısız olabilir.

ImageInfo: Görüntü bilgileri

Ad	Tür	Açıklama
ImageId	String	Görüntünün kimliği.
URL	String	Görüntünün URL'si. Hızlandırılmış bir etki alanı adı yapılandırıldıysa bir CDN URL'si döndürülür. Aksi takdirde Object Storage Service (OSS) URL'si döndürülür.
Title	String	Görüntünün başlığı.
Tags	String	Görüntünün etiketleri.
ImageType	String	Görüntünün türü.
CateId	Long	Kategorinin kimliği.
CateName	String	Kategorinin adı.
Description	String	Açıklama.
StorageLocation	String	Depolama adresi.
Mezzanine	Mezzanine	Görüntü hakkındaki kaynak bilgileri.
CreationTime	String	Görüntünün oluşturulma zamanı. Zaman UTC cinsindendir.
Durum	String	Görüntünün durumu. Daha fazla bilgi için bkz. Durum: bir görüntünün durumu.
AppId	String	Uygulamanın kimliği.

Durum: bir görüntünün durumu

Değer	Açıklama	Notlar
Uploading	Yükleniyor	Bu, görüntünün ilk durumudur ve yüklenmekte olduğunu gösterir. Görüntüleriniz bu durumda uzun süre kalırsa, bkz. Yüklenen Dosyalarım Neden Her Zaman Yükleniyor Durumunda?.
UploadFail	Görüntü yüklenemedi.	Yüklemeler ağ sorunları veya kaynak dosya bozulması nedeniyle başarısız olabilir. Yeniden deneyin veya farklı bir kaynak dosya yükleyin.
Normal	Normal	Görüntü yükleme başarılı oldu.

AttachedMediaInfo: yardımcı bir medya varlığı hakkındaki bilgiler

Ad	Tür	Açıklama
MediaId	String	Yardımcı medya varlığının kimliği.
URL	String	Yardımcı medya varlığının URL'si. CDN için bir etki alanı adı belirtilirse bir CDN URL'si döndürülür. Aksi takdirde bir OSS URL'si döndürülür.
Title	String	Başlık.
Tags	String	Etiket.
Type	String	Yardımcı medya varlığının türü.
Categories	Kategori[]	Kategoriler.
Description	String	Açıklama
StorageLocation	String	Depolama adresi.
CreationTime	String	Yardımcı medya varlığının oluşturulma zamanı. Zaman UTC cinsinden olmalıdır.
ModificationTime	String	Yardımcı medya varlığının en son değiştirilme zamanı. Zaman UTC cinsinden olmalıdır.
Durum	String	Yardımcı medya varlığının durumu. Daha fazla bilgi için bkz. Durum: Yardımcı Medya Varlığı Durumu.
AppId	String	Uygulamanın kimliği.

Durum: bir yardımcı medya varlığının durumu

Değer	Açıklama	Açıklama
Uploading	Yükleniyor	İlk durum. Yardımcı medya varlığı yükleniyor.
Normal	Normal	Yardımcı medya varlığı başarıyla yüklendi.
UploadFail	Başarısız	Yardımcı medya varlığı yüklenemedi.

Medya Kaynağı Dosyası Bilgileri

Mezzanine: Ses ve video kaynak dosyası bilgileri

Ad	Tür	Açıklama
VideoId	String	Videonun kimliği.
FileName	String	Dosyanın adı.
Duration	String	Dosyanın saniye cinsinden süresi.
Status	String	Kaynak dosyanın durumu. Daha fazla bilgi için bkz. Durum: Bir ses veya video kaynak dosyasının durumu.
CreationTime	String	Dosyanın oluşturulma zamanı. Zaman UTC cinsindendir.
Height	Long	Dosyanın piksel (px) cinsinden yüksekliği.
Width	Long	Dosyanın piksel (px) cinsinden genişliği.
Fps	String	Dosyanın saniyedeki kare (fps) cinsinden kare hızı.
FileURL	String	Dosyanın URL'si.
Bitrate	String	Dosyanın Kbps cinsinden bit hızı.
Size	Long	Dosyanın bayt cinsinden boyutu.
OutputType	String	Çıktı dosyasının türü. Geçerli değerler: oss: kaynak sunucunun URL'si. cdn: hızlandırılmış URL.
VideoStreamList	VideoStream[]	Video akışı bilgilerinin listesi.
AudioStreamList	AudioStream[]	Ses akışı bilgilerinin listesi.

VideoStream: Video akışı bilgileri

Ad	Tür	Açıklama
Index	String	Video akışının sıra numarası. Bu, medya akışındaki video akışının konumunu tanımlar.
CodecName	String	Kodlama formatının kısa adı.
CodecLongName	String	Kodlama formatının uzun adı.
Profile	String	Kodek profili.
CodecTimeBase	String	Kodek zaman tabanı.
CodecTagString	String	Kodlama formatının etiket metni.
CodecTag	String	Kodlama formatının etiketi.
Width	Long	Video çözünürlüğünün genişliği.
Height	Long	Video çözünürlüğü yüksektir.
HasBFrames	String	Akışın B çerçevelerine sahip olup olmadığını gösterir.
Sar	String	Kodlanmış sinyalin çözünürlük oranı.
Dar	String	Görüntü en boy oranı (DAR).
PixFmt	String	Piksel formatı.
Level	String	Kodlama düzeyi.
Fps	String	Hedef kare hızı.
AvgFPS	String	Ortalama kare hızı.
Timebase	String	Zaman tabanı.
StartTime	String	Başlangıç zamanı.
Duration	String	Süre.
NumFrames	String	Toplam kare sayısı.
Lang	String	Dil.
Rotate	String	Videonun döndürme açısı. Değer [0, 360) aralığında olmalıdır.

AudioStream: Ses akışı bilgileri

Ad	Tür	Açıklama
Index	String	Ses akışının sıra numarası. Bu, medya akışındaki ses akışının konumunu tanımlar.
CodecName	String	Kodlama formatının kısa adı.
CodecLongName	String	Kodlama formatının uzun adı.
CodecTimeBase	String	Kodek zaman tabanı.
CodecTagString	String	Kodlama formatının etiket metni.
CodecTag	String	Kodlama formatının etiketi.
SampleFmt	String	Örnekleme formatı.
SampleRate	String	Örnekleme hızı.
Channels	String	Ses kanalı sayısı.
ChannelLayout	String	Ses kanallarının düzeni.
Timebase	String	Zaman tabanı.
StartTime	String	Başlangıç zamanı.
Duration	String	Süre.
Bitrate	String	Bit hızı.
NumFrames	String	Toplam kare sayısı.
Lang	String	Dil.

Durum: Bir ses veya video kaynak dosyasının durumu

Değer	Açıklama	Notlar
Uploading	Yükleniyor	Dosyanın ilk durumu. Bu, dosyanın yüklendiğini gösterir.
Normal	Normal	Dosya başarıyla yüklendi.
UploadFail	Başarısız	Dosya yüklenemedi.
Deleted	Silindi	Dosya silindi.

Mezzanine: Görüntü kaynak dosyası bilgileri

Ad	Tür	Açıklama
FileURL	String	Görüntünün OSS URL'si.
OriginalFileName	String	Yüklenen dosyanın adı.
FileSize	Long	Dosya boyutu bayt cinsinden.
Width	Integer	Görüntünün piksel (px) cinsinden genişliği.
Height	Integer	Görüntünün piksel (px) cinsinden yüksekliği.

URL'lere dayalı olarak birden çok medya dosyasını toplu iş halinde yükleme

URLUploadInfo: URL tabanlı bir yükleme işi hakkındaki bilgiler

Ad	Tür	Açıklama
JobId	String	Yükleme işinin kimliği.
UploadURL	String	Yüklenecek dosyanın URL'si.
MediaId	String	Yüklenecek dosyanın kimliği.
FileSize	String	Yüklenecek dosyanın boyutu. Birim: bayt.
Durum	String	URL tabanlı yükleme işinin durumu. Bu parametre hakkında daha fazla bilgi için bkz. Durum: URL tabanlı bir yükleme işinin durumu.
CreationTime	String	İşin oluşturulma zamanı.
CompleteTime	Long	İşin tamamlanma zamanı.
UserData	String	Kullanıcı tanımlı bir alan.
ErrorCode	String	Hata kodu
ErrorMessage	String	Hata iletisi.

Durum: URL tabanlı bir yükleme işinin durumu

Değer	Açıklama
PENDING	Yükleme işi gönderildi ve işlenmeyi bekliyor.
PROCESSING	Görevi işlemeye başlayabilirsiniz.
DOWNLOADING	Dosya indiriliyor.
DOWNLOAD_SUCCESS	Dosya indirildi.
DOWNLOAD_FAIL	Dosya indirilemedi.
UPLOADING	Dosya yükleniyor.
UPLOAD_SUCCESS	Dosya yüklendi.
UPLOAD_FAIL	Dosya yüklenemedi.
SUCCESS	Yükleme işi başarılı oldu ve geri arama tamamlandı.

Video ve ses oynatma

VideoBase: Temel video bilgileri

Name	Type	Description
VideoId	String	Video ID'si
Title	String	Video başlığı
Duration	String	Saniye cinsinden video süresi.
CoverURL	String	Video küçük resmi.
Status	String	Video veya ses dosyasının durumu.
CreationTime	String	Video veya ses dosyasının oluşturulma zamanı. Zaman UTC formatındadır.
MediaType	MediaType	Medya dosyasının türü. Geçerli değerler: Video. audio: Yalnızca ses içeren bir dosya.

Not

Varsayılan olarak, oynatma API işlemi CDN hızlandırmalı bir URL döndürür. Bir alan adı yapılandırılmamışsa, API işlemi OSS kaynak URL'sini döndürür. Bu durumda, yalnızca MP4 dosyalarının URL'leri oynatma için kullanılabilir.

PlayInfo: Medya akışı için oynatma bilgileri

Name	Type	Description
Bitrate	String	Kbps cinsinden medya akışının bit hızı.
Definition	String	Medya akışının çözünürlük tanımı. Geçerli değerler: FD: Düşük çözünürlük LD: Standart çözünürlük SD: Yüksek çözünürlük HD (Yüksek Çözünürlük). OD: Orijinal kalite 2K: 2K 4K: 4K
Specification	String	Video ve ses kod dönüştürme için çıkış teknik özellikleri. Daha fazla bilgi için bkz. Çıkış teknik özellikleri.
Duration	String	Saniye cinsinden medya akışının süresi.
Encrypt	Long	Medya akışının şifrelenip şifrelenmediğini belirtir. Geçerli değerler: 0: Hayır. 1: Evet.
EncryptType	String	Medya akışının şifreleme türü. Geçerli değerler: AliyunVoDEncryption: Alibaba Cloud Video Şifreleme (özel şifreleme). HLSEncryption: HLS şifreleme.
PlayURL	String	Medya akışının oynatma URL'si.
Format	String	Medya akışının biçimi. Medya dosyası bir videoysa geçerli değerler şunlardır: mp4 m3u8 Medya dosyası yalnızca ses içeriyorsa geçerli değer mp3'tür.
Fps	String	Saniyedeki kare sayısı (fps) cinsinden medya akışının kare hızı.
Size	Long	Bayt cinsinden medya akışının boyutu.
Width	Long	Piksel (px) cinsinden medya akışının genişliği.
Height	Long	Piksel (px) cinsinden medya akışının yüksekliği.
StreamType	String	Medya akışının türü. Medya akışı bir videoysa değer video'dur. Medya akışı yalnızca ses içeriyorsa değer audio'dur.
JobId	String	Medya akışı için kod dönüştürme işinin ID'si. Bu ID, medya akışının benzersiz tanımlayıcısıdır.
WatermarkId	String	Medya akışıyla ilişkili filigranın ID'si.
Status	String	Medya akışının durumu. Geçerli değerler: Normal: Her bir çözünürlük tanımı ve biçim için tamamlanan en son kod dönüştürme akışının durumu. Invisible: Yedekli akışlar için durum. Aynı çözünürlük tanımı ve biçim için birden çok akış kod dönüştürüldüğünde, en son akış Normal olarak işaretlenir ve diğerleri Invisible olarak işaretlenir.
NarrowBandType	String	Dar Bant HD türü. Geçerli değerler: 0: normal 1.0: Dar Bant HD 1.0 2.0: Dar Bant HD 2.0 Bu parametre, yalnızca yerleşik Dar Bant HD 1.0 kod dönüştürme şablonundan bir çözünürlük tanımı yapılandırıldığında etkili olur. Daha fazla bilgi için bkz. TranscodeTemplate: Kod dönüştürme şablonu yapılandırmaları.
CreationTime	String	Akışın oluşturulma zamanı. Zaman UTC formatındadır.
ModificationTime	String	Akışın en son güncellenme zamanı. Zaman UTC formatındadır.

VideoMeta: Video meta verileri

Name	Type	Description
VideoId	String	Videonun ID'si.
Title	String	Videonun başlığı.
Duration	Float	Saniye cinsinden videonun süresi.
CoverURL	String	Video küçük resmi.
Status	String	Videonun durumu.

Medya varlıklarını sorgulama

Media: Medya varlığı hakkında bilgiler

Name	Type	Description
MediaId	String	Medya varlığının ID'si.
CreationTime	String	Medya varlığının oluşturulma zamanı. Zaman UTC formatında olmalıdır.
MediaType	String	Medya varlığının türü. Geçerli değerler: video: video audio: ses Image: Resim. attached: yardımcı medya varlığı
Video	Video	Video hakkında bilgiler.
Audio	Audio	Ses hakkında bilgiler.
Image	Image	Görüntü hakkında bilgiler.
AttachedMedia	AttachedMedia	Yardımcı medya varlığı hakkında bilgiler.

Medya varlığı kategorileri

Category: Medya varlığı sınıflandırması

Name	Type	Description
CateId	Long	Kategorinin ID'si.
CateName	String	Kategorinin adı. Değer en fazla 64 bayt uzunluğunda olabilir ve UTF-8 formatında kodlanmış olmalıdır.
ParentId	Long	Üst kategorinin ID'si. Seviye 1 kategorinin üst kategori ID'si -1'dir.
Level	Long	Kategori seviyesi. 0 değeri seviye 1 kategoriyi gösterir.

Canlıdan VOD'ya

LiveRecordVideo: Canlıdan VOD'ya kayıt hakkında bilgiler

Name	Type	Description
StreamName	String	Canlı akışın adı.
DomainName	String	Alan adı.
AppName	String	Uygulamanın adı.
PlaylistId	String	Oynatma listesinin ID'si.
RecordStartTime	String	Kaydın başlangıç zamanı.
RecordEndTime	String	Kaydın bitiş zamanı.
Video	Video	Video bilgileri.

Çevrimiçi düzenleme

EditingProject: Çevrimiçi düzenleme projesi

Name	Type	Description
ProjectId	String	Çevrimiçi düzenleme projesinin ID'si.
Title	String	Çevrimiçi düzenleme projesinin başlığı.
CreationTime	String	Çevrimiçi düzenleme projesinin oluşturulma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder. Zaman UTC olarak görüntülenir. Örneğin, 2017-01-11T12:00:00Z değeri Pekin saatiyle (UTC+8) 11 Ocak 2017 saat 20:00:00'ı gösterir.
ModifiedTime	String	Çevrimiçi düzenleme projesinin en son değiştirilme zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında UTC'dir. Örneğin, 2017-01-11T12:00:00Z (yani 11 Ocak 2017 saat 20:00:00, UTC+8).
Status	String	Çevrimiçi düzenleme projesinin durumu.
Description	String	Çevrimiçi düzenleme projesinin açıklaması.
Timeline	String	Çevrimiçi düzenleme projesinin zaman çizelgesi. Değer bir JSON dizesidir.
Duration	String	Çevrimiçi düzenleme projesinin toplam süresi. Zaman çizelgesinin toplam süresiyle aynı olmalıdır.
CoverURL	String	Çevrimiçi düzenleme projesinin küçük resim URL'si.

ProjectStatus: Çevrimiçi düzenleme projesi durumu

Value	Description	Remarks
Normal	Taslak	Bu, çevrimiçi düzenleme projesinin ilk durumudur.
Producing	Oluşturuluyor	Yok.
Produced	Video üretimi başarılı.	Yok.
ProduceFailed	Birleştirme başarısız oldu.	Yok.

Material: Çevrimiçi düzenleme projesi için materyal bilgileri

Not

Bu tür, Materyal Yönetimi modülündeki materyaller ve Medya Kitaplığı'ndaki videolar dahil olmak üzere materyalleri genel olarak ifade eder.

Name	Type	Description
MaterialId	String	Materyalin ID'si.
Title	String	Materyalin başlığı.
Description	String	Materyal açıklaması.
Duration	Float	Saniye cinsinden materyalin süresi. Değer dört ondalık basamağa kadar hassastır.
CoverURL	String	Materyalin küçük resim URL'si.
Status	String	Materyal durumu.
CreationTime	String	Materyalin oluşturulma zamanı. Zaman UTC olarak görüntülenir.
Size	Long	Kaynak dosyanın bayt cinsinden boyutu.
CateId	Long	Materyal kategori ID'si.
CateName	String	Materyal kategori adı.
Tags	String	Materyal için etiketler. Birden çok etiketi virgülle (,) ayırın.
Snapshots	String[]	Materyal anlık görüntü URL'lerinden oluşan bir dizi.
Sprites	String[]	Materyal sprite URL'lerinden oluşan bir dizi.

ProduceConfig: Video üretim yapılandırması

Name	Type	Description
TemplateGroupId	String	Üretilen video dosyalarını kod dönüştürmek için kullanılan kod dönüştürme şablon grubunun ID'si. Üretilen videolar, kod dönüştürme için kaynak dosyalar olarak hizmet verir. Bu süreç, dosya yükleme tamamlandıktan sonra çalışan kod dönüştürmeye benzer. Bu alan isteğe bağlıdır. Boş bırakılırsa, kod dönüştürme ayarlarından varsayılan şablon grubu kullanılır. Belirtilirse, verilen şablon grubu kullanılır. Şablon grubu ID'sini görüntülemek için ApsaraVideo VOD konsolunda Kod Dönüştürme Ayarları'na gidin.
TemplateId	String	Medya kaynakları için kaynak dosyalar oluşturmak amacıyla video birleştirmede kullanılan bileşim şablonunun ID'si. Bu alan isteğe bağlıdır. Değer boşsa, bileştirme için yerleşik çevrimiçi düzenleme şablonu kullanılır. Bileştirme hedefi bir video dosyasıysa, yerleşik şablonun kodlama biçimi H.264 ve kapsayıcı biçimi MP4'tür. Bileştirme parametrelerini (animasyonlu görüntü bileştirme, akıllı altyazılama, M3U8 hızlı düzenleme veya özel bileştirme parametresi desteği gibi) belirtmek için başka gereksinimleriniz varsa, başvurmak için bir destek talebi gönderin.
Width	Integer	Çıktı videosunun piksel cinsinden genişliği. Bu parametre isteğe bağlıdır. Varsayılan olarak, çıktı video çözünürlüğü zaman çizelgesindeki tüm kaynak dosyalardaki maksimum genişlik ve maksimum yükseklik kullanılarak ayarlanır. Örneğin, bir zaman çizelgesi çözünürlükleri 1280 × 720 piksel, 1920 × 1080 piksel ve 720 × 1280 piksel olan üç kaynak dosya içeriyorsa, çıktı video çözünürlüğü 1920 × 1280 piksel olur.
Height	Integer	Çıktı videosunun piksel cinsinden yüksekliği. Bu parametre isteğe bağlıdır. Varsayılan olarak, çıktı çözünürlüğü zaman çizelgesindeki tüm kaynak dosyalardaki maksimum genişlik ve maksimum yükseklik kullanılarak ayarlanır. Örneğin, bir zaman çizelgesi çözünürlükleri 1280×720, 1920×1080 ve 720×1280 olan üç kaynak dosya kullanıyorsa, çıktı video çözünürlüğü 1920×1280 olur.
Bitrate	Integer	Üretilen videonun bit hızı. Birim: Kbit/s. Bu parametre isteğe bağlıdır. Varsayılan değer, Timeline'da belirttiğiniz kaynak dosyaların maksimum bit hızıdır. Örneğin, Timeline için üç materyal belirtirsiniz ve kaynak dosyaların bit hızları 400, 600 ve 800 Kbit/s'dir. Bu durumda, üretilen videonun varsayılan bit hızı 800 Kbit/s'dir.
StorageLocation	String	Dosyanın depolama adresi. Bu parametre Çin (Şanghay) dışındaki bölgeler için gereklidir.

MediaMetadata: Üretilen videonun meta verileri

Name	Type	Description
Title	String	Üretilen videonun başlığı. Değer en fazla 128 bayt uzunluğunda olabilir ve UTF-8 ile kodlanmış olmalıdır.
Description	String	Üretilen videonun açıklaması. Değer en fazla 1.024 bayt uzunluğunda olabilir ve UTF-8 ile kodlanmış olmalıdır.
CoverURL	String	Üretilen video için özel küçük resmin URL'si.
CateId	String	Üretilen videonun kategori ID'si. ApsaraVideo VOD konsolu üzerinde oturum açın. Sol gezinme bölmesinde Configuration Management > Media Management > Categories seçeneklerini belirleyin.
Tags	String	Üretilen videonun etiketleri. Her etiket adı en fazla 32 bayt uzunluğunda olabilir. En fazla 16 etiket belirtebilirsiniz. Birden çok etiketi virgülle (,) ayırın. Dize UTF-8 formatında kodlanmış olmalıdır.

Çevrimiçi düzenleme - Zaman çizelgesi (yeni düzenleyici için)

Not

Çevrimiçi düzenleme yetenekleri bölgeye göre değişiklik gösterir. Bu özelliği kullanmadan önce hizmet bölgenizin bu özelliği desteklediğinden emin olun. Daha fazla bilgi için bkz. Hizmet bölgeleri. Eski düzenleyicideki çevrimiçi düzenleme veri türleriyle ilgili parametre açıklamaları için bkz. Çevrimiçi düzenleme veri türleri (eski düzenleyici için).

Zaman çizelgesi: zaman çizelgesi bilgileri

Zaman çizelgesi, videoya ilişkin yaratıcı vizyonunuz doğrultusunda medya paketlerinin düzenlenmesi ve efektlerin uygulanması sonucunda oluşur. Başlıca üç nesne türü içerir: parçalar, medya paketleri ve efektler.

Ad	Tür	Gerekli	Açıklama
VideoTracks	VideoTrack[]	Hayır. VideoTracks boşsa AudioTracks boş olmamalıdır.	Video parçalarının listesi. Birden fazla parçanın yığılma sırası, dizi elemanlarının sırasını takip eder. Örneğin, ilk dizi elemanının katmanı en altta, ikinci elemanın katmanı onun üzerinde görünür ve bu şekilde devam eder.
AudioTracks	AudioTrack[]	Hayır. AudioTracks boşsa VideoTracks boş olmamalıdır.	Ses parçalarının listesi.
SubtitleTracks	SubtitleTrack[]	Hayır	Altyazı parçalarının listesi.
EffectTracks	EffectTrack[]	Hayır	Efekt parçalarının listesi.

VideoTrack: video parçası bilgileri

VideoTrack, video ve görüntü materyalleri dahil olmak üzere görüntü tabanlı medya paketlerini düzenler.

Ad	Tür	Gerekli	Açıklama
Type	Dize	Hayır	Varsayılan olarak standart bir video parçasıdır. Type=Effect olduğunda, mevcut parça bir efekt parçası olarak işlev görür. Bu durumda VideoTrackClips, EffectTrackItem içerebilir.
MainTrack	Boolean	Hayır	Mevcut parçanın ana parça olup olmadığını belirtir. Varsayılan değer False'tur.
VideoTrackClips	VideoTrackClip[]	Evet	Video parçası medya kliplerinin listesi.

AudioTrack: ses parçası bilgileri

AudioTrack, yalnızca ses içeren dosyalar ve ses akışları olan videolar dahil olmak üzere ses tabanlı medya paketlerini düzenler.

Ad	Tür	Gerekli	Açıklama
MainTrack	Boolean	Hayır	Mevcut parçanın ana parça olup olmadığını belirtir. Varsayılan değer False'tur.
AudioTrackClips	AudioTrackClip[]	Evet	Ses parçası medya kliplerinin listesi.

SubtitleTrack: altyazı parçası bilgileri

SubtitleTrack, banner metinleri ve harici altyazı dosyaları dahil olmak üzere altyazıları düzenler.

Ad	Tür	Gerekli	Açıklama
SubtitleTrackClips	SubtitleTrackClip[]	Evet	Altyazı parçası medya kliplerinin listesi.

EffectTrack: efekt parçası bilgileri

EffectTrack, tüm videoya genel efektler ekler ve filtreler ile görsel efektleri (VFX) destekler.

Ad	Tür	Gerekli	Açıklama
EffectTrackItems	EffectTrackItem[]	Evet	Efekt parçası öğelerinin listesi.

VideoTrackClip: video parçası medya bilgileri

VideoTrackClip, hem video hem de görüntü medya paketlerini içerir.

In, Out, TimelineIn ve TimelineOut parametreleri, kaynak klibin başlangıç ve bitiş noktalarını ile zaman çizelgesindeki konumunu işaretler. Örneğin, bir videonun 5-10 saniye arasındaki segmentini zaman çizelgesinde 15-20 saniye konumuna yerleştirmek için In=5, Out=10, TimelineIn=15 ve TimelineOut=20 olarak ayarlayabilirsiniz.

Ad	Tür	Gerekli	Açıklama
MediaId	Dize	Hayır	Video parçası klibinin medya ID'si. Bazı bağlamlarda bu, VideoId (video/ses için) veya ImageId (görüntüler için) olarak da adlandırılır.
Type	Dize	Hayır	Medya klip türü. Varsayılan değer Video'dur. Geçerli değerler: Video Image GlobalImage (genel görüntü; süre varsayılan olarak en uzun video parçası süresine eşittir.) Örnek: Video parçasında GlobalImage kullanma
X	Float	Hayır	Görüntünün veya videonun sol üst köşesinden çıktı videosunun sol üst köşesine olan yatay mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu genişliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Y	Float	Hayır	Görüntünün veya videonun sol üst köşesinden çıktı videosunun sol üst köşesine olan dikey mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu yüksekliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Width	Float	Hayır	Çıktı videosundaki görüntünün genişliği. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu genişliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Height	Float	Hayır	Çıktı videosundaki görüntünün yüksekliği. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu yüksekliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
AdaptMode	Dize	Hayır	Video ölçeklendirme modu. Varsayılan değer Fill'dir. Bu mod yalnızca video parçası için hem Width hem de Height ayarlandığında geçerli olur. Bu durumda Width ve Height hedef alan boyutlarını tanımlar ve video bu alan içinde uyarlamalı olarak ölçeklendirilir. Contain: İçeriği en-boy oranını koruyarak hedef alana sığacak şekilde ölçeklendirir. Cover: En-boy oranını koruyarak tüm hedef alanı doldurur. En-boy oranları eşleşmezse içerik kırpılabilir. Fill: İçeriği tam olarak hedef alanı dolduracak şekilde gerer. En-boy oranı korunmaz.
In	Float	Hayır	Klibin kaynak medyaya göre başlangıç zamanı. Yalnızca ses/video kaynakları için geçerlidir. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak 0'dır.
Out	Float	Hayır	Klibin kaynak medyaya göre bitiş zamanı. Yalnızca ses/video kaynakları için geçerlidir. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak tam kaynak süresidir.
MaxOut	Float	Hayır	Klibin kaynak medyaya göre maksimum bitiş zamanı. Ayarlanırsa gerçek Out noktası, kaynak süresi veya MaxOut değerlerinden küçük olanı olur. Yalnızca ses/video kaynakları için geçerlidir. Birim: saniye, dört ondalık basamağa kadar hassas. Out belirtilirse MaxOut yok sayılır. Örnek: Video parçasında MaxOut ayarlama
Duration	Float	Hayır	Klibin süresi. Genellikle görüntü kaynakları için kullanılır. Birim: saniye, dört ondalık basamağa kadar hassas.
DyncFrames	Int	Hayır	Animasyonlu görüntüler için kare hızı. Yalnızca kaynak animasyonlu bir görüntü olduğunda geçerlidir. Örnek: GIF çıkartmaları kullanma
TimelineIn	Float	Hayır	Klibin zaman çizelgesindeki başlangıç zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineIn, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
TimelineOut	Float	Hayır	Klibin zaman çizelgesindeki bitiş zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineOut, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
Speed	Float	Hayır	Video klibinin oynatma hızı. Geçerli aralık: 0,1–100. Örneğin, Speed=2 klibi çift hızda oynatır ve nihai çıktıda Duration değerini yarıya indirir. Örnek: Ses/video hızını ayarlama
MaskVideoUrl	Dize	Hayır	Maske videosunun URL'si. Genellikle orijinal videoya şeffaflık efektleri eklemek için kullanılan alfa kanalına sahip bir videodur. Yalnızca genel OSS URL'leri desteklenir.
Effects	Effect[]	Hayır	Klibe uygulanan efektlerin listesi.

AudioTrackClip: ses parçası medya bilgileri

AudioTrackClip, yalnızca ses içeren dosyaları ve ses akışları barındıran videoları içerir.

In, Out, TimelineIn ve TimelineOut parametreleri, kaynak klibin başlangıç ve bitiş noktalarını ile zaman çizelgesindeki konumunu işaretler. Örneğin, bir videonun 5-10 saniye arasındaki segmentini zaman çizelgesinde 15-20 saniye konumuna yerleştirmek için In=5, Out=10, TimelineIn=15 ve TimelineOut=20 olarak ayarlayabilirsiniz.

Ad	Tür	Gerekli	Açıklama
MediaId	Dize	Hayır	Ses parçası klibinin medya ID'si.
In	Float	Hayır	Klibin kaynak medyaya göre başlangıç zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak 0'dır.
Out	Float	Hayır	Klibin kaynak medyaya göre bitiş zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak tam kaynak süresidir.
TimelineIn	Float	Hayır	Klibin zaman çizelgesindeki başlangıç zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineIn, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
TimelineOut	Float	Hayır	Klibin zaman çizelgesindeki bitiş zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineOut, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
Speed	Float	Hayır	Ses klibinin oynatma hızı. Geçerli aralık: 0,1–100. Örneğin, Speed=2 klibi çift hızda oynatır ve nihai çıktıda Duration değerini yarıya indirir. Örnek: Ses/video hızını ayarlama
Effects	Effect[]	Hayır	Klibe uygulanan efektlerin listesi.
LoopMode	Boolean	Hayır	Klibin zaman çizelgesindeki döngüsel oynatma davranışı. True döngüsel oynatmayı etkinleştirir. False (varsayılan) döngüyü devre dışı bırakır. Örnek: Ses döngüsel oynatma

SubtitleTrackClip: altyazı parçası medya bilgileri

SubtitleTrackClip, altyazı medya paketlerini içerir.

Ad	Tür	Gerekli	Açıklama
Type	Dize	Evet	Altyazı medya türü. Geçerli değerler: Subtitle: harici altyazı dosyası Text: banner metni
SubType	Dize	Hayır	Altyazı medya alt türü. Geçerli değerler: srt: harici SRT altyazısı ass: harici ASS altyazısı Type Text olduğunda bu alanı yok sayın.
FileURL	Dize	Hayır	Altyazı dosyasının OSS URL'si. Type Subtitle olduğunda zorunludur. Format: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt Örnek: Altyazı dosyası kullanarak doğrudan düzenleme Not FileURL yalnızca genel OSS URL'lerini destekler. Hızlandırılmış OSS URL'leri, CDN URL'leri ve diğer HTTP URL'leri desteklenmez.
X	Float	Hayır	Type Text olduğunda, metnin sol üst köşesinden çıktı videosunun sol üst köşesine olan yatay mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu genişliğinin yüzdesini temsil eder. >=2 olan bir tamsayı mutlak piksel değerini temsil eder.
Y	Float	Hayır	Type Text olduğunda, metnin sol üst köşesinden çıktı videosunun sol üst köşesine olan dikey mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu yüksekliğinin yüzdesini temsil eder. >=2 olan bir tamsayı mutlak piksel değerini temsil eder.
TimelineIn	Float	Hayır	Type Text olduğunda, metnin zaman çizelgesindeki başlangıç zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineIn, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
TimelineOut	Float	Hayır	Type Text olduğunda, metnin zaman çizelgesindeki bitiş zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse TimelineOut, ardışık yerleştirmeye göre otomatik olarak hesaplanır.
Content	Dize	Hayır	Type Text olduğunda zorunludur. Metin içeriğini belirtir.
Font	Dize	Hayır	Type Text olduğunda yazı tipini belirtir. Varsayılan SimSun'dur. Desteklenen yazı tiplerinin tam listesi için bkz. Yazı tipi listesi.
FontSize	Int	Hayır	Altyazı türü banner metni olduğunda yazı tipi boyutunu belirtir.
FontColor	Dize	Hayır	Type Text olduğunda yazı tipi rengini onaltılık formatta (# işaretini takip eden onaltılık rakamlar) belirtir. Örnek: #ffffff.
FontColorOpacity	Dize	Hayır	Type Text olduğunda yazı tipi şeffaflığını belirtir. Geçerli aralık: 0–1. Varsayılan 1'dir (opak). 0 tamamen şeffaf anlamına gelir.
FontFace	FontFace	Hayır	Type Text olduğunda yazı tipi stilini belirtir.
Spacing	Int	Hayır	Type Text olduğunda karakter aralığını belirtir. Birim: piksel. Varsayılan 0'dır.
Angle	Float	Hayır	Type Text olduğunda saat yönünün tersine dönüş açısını belirtir. Birim: derece. Varsayılan 0'dır.
BorderStyle	Int	Hayır	Banner metni için kenarlık ve gölge stilini belirtir. Geçerli değerler: 1 veya 3. 1 = kenarlık + gölge. 3 = opak arka plan kutusu. Varsayılan 1'dir.
Outline	Int	Hayır	Type Text olduğunda kontur kalınlığını belirtir. Birim: piksel. Varsayılan 0'dır.
OutlineColour	Dize	Hayır	Type Text olduğunda kontur rengini onaltılık formatta (# işaretini takip eden onaltılık rakamlar) belirtir. Örnek: #ffffff.
Shadow	Int	Hayır	Type Text olduğunda gölge derinliğini belirtir. Birim: piksel. Varsayılan 0'dır.
BackColour	Dize	Hayır	Type Text olduğunda gölge rengini onaltılık formatta (# işaretini takip eden onaltılık rakamlar) belirtir. Örnek: #ffffff.
Alignment	Dize	Hayır	Type Text olduğunda metin hizalamasını belirtir. Varsayılan TopLeft'tir. Geçerli değerler: TopLeft: videonun sol üst köşesi TopCenter: dikey eksen boyunca üst orta TopRight: videonun sağ üst köşesi CenterLeft: videonun yatay merkez ekseninin sol tarafı CenterCenter: videonun merkezi CenterRight: yatay eksen boyunca sağ orta BottomLeft: videonun sol alt köşesi BottomCenter: dikey eksen boyunca alt orta BottomRight: videonun sağ alt köşesi
AdaptMode	Dize	Hayır	Banner metni video genişliğini veya belirtilen TextWidth değerini aştığında nasıl uyarlanacağını belirtir. Geçerli değerler: AutoWrap: satırları otomatik olarak kaydırır AutoScale: Auto Scaling AutoWrapAtSpaces: yalnızca boşluk karakterlerinde satır kaydırır (yalnızca İngilizce altyazılar için idealdir)
TextWidth	Tamsayı	Hayır	Altyazı metin kutusunun genişliği. Yalnızca AdaptMode ayarlandığında etkili olur. Otomatik satır kaydırma veya ölçeklendirme bu genişliği kullanır. Belirtilmezse video genişliği kullanılır. Birim: piksel.
FontUrl	Dize	Hayır	Type Text olduğunda OSS paketinizdeki özel yazı tipi dosyalarını destekler. Desteklenen formatlar: ttf, otf, woff. Örnek: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf
EffectColorStyle	Dize	Hayır	Type Text olduğunda kelime sanatı stilini belirtir. Kelime sanatı stilleri ve efektleri için bkz. Kelime sanatı efekti örnekleri.
AaiMotionInEffect	Dize	Hayır	Type Text olduğunda giriş animasyonu efektini belirtir. Giriş efekti türleri ve örnekleri için bkz. Giriş efektleri.
AaiMotionIn	Float	Hayır	Type Text olduğunda giriş efektinin süresini belirtir. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak 0,5 saniyedir. Toplam metin süresi 0,5 saniyeden azsa giriş süresi, toplam süreden çıkış süresi çıkarılarak hesaplanır.
AaiMotionOutEffect	Dize	Hayır	Altyazı türü banner olduğunda banner metni için giriş efektini belirtir. Altyazı girişlerinin türleri ve efektleri için bkz. Giriş efektleri.
AaiMotionOut	Float	Hayır	Type Text olduğunda çıkış efektinin süresini belirtir. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak 0,5 saniyedir. Toplam metin süresi 0,5 saniyeden azsa çıkış süresi toplam metin süresine eşit olur.
AaiMotionLoopEffect	Dize	Hayır	Type Text olduğunda döngü animasyonu efektini belirtir. Giriş veya çıkış efektleriyle birlikte kullanılamaz. Döngü efekti türleri ve örnekleri için bkz. Döngü efektleri.
Ratio	Float	Hayır	Type Text olduğunda döngü efektinin oynatma hızını belirtir. Dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan 1'dir. 1'den büyük değerler döngüyü hızlandırır. 1'den küçük değerler yavaşlatır.

EffectTrackItem: efekt parçası öğesi bilgileri

EffectTrackItem, görsel efektleri (VFX) ve filtre efektlerini içerir.

Ad	Tür	Gerekli	Açıklama
Type	Dize	Evet	Efekt parçası öğesi türü. Geçerli değerler: VFX, Filter.
SubType	Dize	Evet	Efekt parçası öğesi alt türü. Desteklenen efekt türleri ve örnekler için bkz. Özel efekt örnekleri ve Filtre efekti örnekleri.
TimelineIn	Float	Hayır	Efektin zaman çizelgesindeki başlangıç zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak 0'dır.
TimelineOut	Float	Hayır	Efektin zaman çizelgesindeki bitiş zamanı. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak video bitiş zamanıdır.
Duration	Float	Hayır	Efektin zaman çizelgesindeki süresi. Birim: saniye, dört ondalık basamağa kadar hassas. Belirtilmezse varsayılan olarak video süresidir. Not Yalnızca Duration veya TimelineOut etkili olur.
X	Float	Hayır	Yalnızca SubType mosaic_rect veya blur olduğunda geçerlidir. Efekt alanının sol üst köşesinden çıktı videosunun sol üst köşesine olan yatay mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu genişliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Y	Float	Hayır	Yalnızca SubType mosaic_rect veya blur olduğunda geçerlidir. Efekt alanının sol üst köşesinden çıktı videosunun sol üst köşesine olan dikey mesafe. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu yüksekliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Width	Float	Hayır	Yalnızca SubType mosaic_rect veya blur olduğunda geçerlidir. Çıktı videosundaki efekt alanının genişliği. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu genişliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.
Height	Float	Hayır	Yalnızca SubType mosaic_rect veya blur olduğunda geçerlidir. Çıktı videosundaki efekt alanının yüksekliği. Yüzde veya piksel değerlerini destekler. [0–0,9999] aralığında bir değer, çıktı videosu yüksekliğinin yüzdesini temsil eder. ≥2 olan bir tamsayı mutlak piksel değerini temsil eder.

FontFace: yazı tipi stili

Ad	Tür	Gerekli	Açıklama
Bold	Boolean	Hayır	Kalın.
Italic	Boolean	Hayır	Eğik.
Underline	Boolean	Hayır	Altı çizili.

Effect: efekt bilgileri

Farklı efekt türlerinin benzersiz özellikleri vardır ancak ortak nitelikleri de paylaşır.

Tek tek Effect özelliklerinin ayrıntılı açıklamaları için bkz. Efekt yapılandırma referansı.

Ortak Effect nitelikleri aşağıdaki gibidir:

Ad

Tür

Gerekli

Açıklama

Type

Dize

Evet

Efekt türü. Geçerli değerler:

Text: video parçası klipleri için banner metni.
DeWatermark: video parçası klipleri için filigran kaldırma.
Crop: video parçası klipleri için kırpma.
Scale: video parçası klipleri için ölçeklendirme.
Pad: Video parçası kliplerini yapıştırma
Background: video parçası klipleri için arka plan ayarları.
Transition: video parçası klipleri için geçiş efektleri.
VFX: video parçası klipleri için görsel efektler.
Filter: video parçası klipleri için filtreler.
Volume: ses parçası klipleri için ses düzeyi ayarı.
AFade: ses parçası klipleri için ses solup gelme ve solup gitme.
Rotate: video parçası klipleri için döndürme.
Clip: rastgele kırpma.
Flip: çevirme.
KenBurns: Ken Burns efekti (panoramalama ve yakınlaştırma).
Zoom: yakınlaştırma.

SubType

Dize

Hayır

Efekt alt türü.

Type Transition olduğunda bu, geçiş alt türünü belirtir. Geçerli değerler için bkz. Geçiş efekti örnekleri.
Type VFX olduğunda bu, görsel efekt alt türünü belirtir. Geçerli değerler için bkz. Özel efekt örnekleri.
Type Filter olduğunda bu, filtre alt türünü belirtir. Geçerli değerler için bkz. Filtre efekti örnekleri.

Video anlık görüntüleri ve dinamik görüntüler

SnapshotJob: Anlık görüntü işi bilgileri

Name	Type	Description
JobId	String	İşin kimliği.

VodTemplateInfo: Anlık görüntü şablonu bilgileri

Name	Type	Description
Name	String	Şablonun adı.
VodTemplateId	String	Şablonun kimliği.
TemplateType	String	Şablon türü. Geçerli değerler: Snapshot: Anlık görüntü. DynamicImage: Dinamik görüntü.
IsDefault	String	Bu filigranın varsayılan olup olmadığını belirtir. Geçerli değerler: Default: Filigran varsayılandır. NotDefault: Filigran varsayılan değildir.
TemplateConfig	JSON	Şablonun ayrıntılı yapılandırması. Değer bir JSON dizesidir. Anlık görüntü yapılandırması hakkında daha fazla bilgi için bkz. SnapshotTemplateConfig. Dinamik görüntü yapılandırması için bkz. DynamicImageTemplateConfig.
CreationTime	String	Şablonun oluşturulma zamanı. Zaman UTC biçimindedir.
ModifyTime	String	Şablonun en son değiştirilme zamanı. Zaman UTC biçimindedir.

MediaSnapshot: Medya anlık görüntüsü verileri

Name	Type	Description
JobId	String	Anlık görüntü işinin kimliği.
CreationTime	String	Anlık görüntü işinin oluşturulma zamanı. Zaman UTC cinsindendir.
Total	Long	Toplam anlık görüntü sayısı.
Regular	String	Anlık görüntü URL'lerini oluşturma kuralı.
Snapshots	Anlık görüntü[]	Anlık görüntü verileri.

Snapshot: Anlık görüntü bilgileri

Name	Type	Description
Index	String	Anlık görüntünün dizin değeri.
Url	String	Anlık görüntünün URL'si.

DynamicImage: Dinamik görüntü bilgileri

Name	Type	Description
VideoId	String	Videonun kimliği.
DynamicImageId	String	Dinamik görüntünün kimliği.
FileURL	String	Dinamik görüntü dosyasının URL'si.
Width	String	Dinamik görüntünün genişliği.
Height	String	Dinamik görüntünün yüksekliği.
Duration	String	Dinamik görüntünün süresi.
Format	String	Dinamik görüntünün biçimi. Geçerli değerler `gif` veya `webp` şeklindedir.
FileSize	String	Dinamik görüntü dosyasının boyutu.
Fps	String	Dinamik görüntünün kare hızı.

Filigranlar

WatermarkInfo: Filigran hakkındaki bilgiler

Name	Type	Required	Description
CreationTime	String	Yes	Filigranın eklenme zamanı.
Name	String	Yes	Filigranın adı.
IsDefault	String	Yes	Filigranın varsayılan olup olmadığını belirtir. Geçerli değerler: Default: Varsayılan filigran. NotDefault: Varsayılan olmayan filigran.
Type	String	Yes	Filigranın türü. Geçerli değerler: Image: Resim. Text: Metin.
WatermarkId	String	Yes	Filigranın kimliği.
FileUrl	String	No	Filigran dosyasının OSS URL'si veya CDN URL'si. Bu parametre metin filigranları için geçerli değildir.
WatermarkConfig	WatermarkConfig	Yes	Metin veya resim filigranının konumu ve etkisi için yapılandırmalar. Değer bir JSON dizesi olmalıdır.

Ses ve video kod dönüştürme

TranscodeJob: kod dönüştürme işi bilgileri

Name	Type	Description
JobId	String	Kod dönüştürme işinin ID'si.

TranscodeTemplateGroup: kod dönüştürme şablon grubu bilgileri

Name	Type	Required	Description
Name	String	Yes	Şablon grubunun adı.
TranscodeTemplateGroupId	String	Yes	Kod dönüştürme şablon grubunun ID'si.
IsDefault	String	Yes	Bu şablon grubunun varsayılan olup olmadığını belirtir. Geçerli değerler: Default: varsayılan şablon grubu. NotDefault: varsayılan olmayan şablon grubu.
CreationTime	String	Yes	Şablon grubunun oluşturulduğu zaman.
ModifyTime	String	Yes	Şablon grubunun en son değiştirildiği zaman.
TranscodeTemplateList	TranscodeTemplate[]	Yes	Kod dönüştürme şablonu yapılandırmalarının listesi.

TranscodeTemplate: kod dönüştürme şablonu yapılandırması

Name	Type	Required	Description
Type	String	No	Şablon türü. Geçerli değerler: Normal: standart bir kod dönüştürme şablonu. Bu şablon türü için PackageSetting parametresini ayarlayamazsınız. VideoPackage: video akışı paketleme şablonu. Bu şablon önce videoyu kod dönüştürür, ardından uyarlanabilir bit hızı akışı oluşturur. PackageSetting parametresini yapılandırmanız gerekir. SubtitlePackage: altyazı paketleme şablonu. Bu şablon türü kod dönüştürme işlemi gerçekleştirmez. Bunun yerine, ilgili altyazı bilgilerini uyarlanabilir bit hızı çıkış dosyalarına gömer. PackageSetting parametresini yapılandırmanız gerekir. Ancak bu şablon türü bir şablon grubunda bağımsız olarak bulunamaz. Bir VideoPackage şablonuyla birlikte yapılandırılmalıdır ve bir şablon grubunda yalnızca bir tane bu tür şablon yapılandırabilirsiniz. Varsayılan değer: Normal.
Video	Video	Yes	Video akışı için kod dönüştürme yapılandırması. Değer bir JSON dizesi olmalıdır.
Audio	Audio	Yes	Ses akışı için kod dönüştürme yapılandırması. Değer bir JSON dizesi olmalıdır.
Definition	String	Yes	Standart bir kod dönüştürme şablonunun çözünürlük tanımı. Geçerli değerler: LD: düşük çözünürlük. SD: standart çözünürlük. HD: yüksek çözünürlük. FHD: ultra yüksek çözünürlük. OD: orijinal kalite. Bu değer konteyner formatı dönüştürme için kullanılır. 2K 4K SQ: standart ses kalitesi. HQ: yüksek ses kalitesi. Not Bu tanım yalnızca kod dönüştürme şablonundaki bir etikettir. Çıkış videosunun gerçek çözünürlük aralığını temsil etmez. Şablon tanımlarının çıkış video çözünürlükleriyle nasıl eşleştiği hakkında daha fazla bilgi için bkz. Teknik özellikler. Bu tanımın kod dönüştürme ücretleri üzerinde hiçbir etkisi yoktur. Kod dönüştürme ücretleri hakkında daha fazla bilgi için bkz. ApsaraVideo VOD kod dönüştürme planları. Narrowband HD 1.0 kod dönüştürme şablonunun çözünürlük tanımı. Geçerli değerler: LD-NBV1: düşük çözünürlük. SD-NBV1: standart çözünürlük. HD-NBV1: yüksek çözünürlük. FHD-NBV1: ultra yüksek çözünürlük. 2K-NBV1 4K-NBV Not Herhangi bir kod dönüştürme şablonunun çözünürlük tanımını değiştiremezsiniz. Narrowband HD™ 1.0 kod dönüştürme şablonları, video çözünürlüğü, ses çözünürlüğü ve bit hızı gibi sistem tarafından tanımlanan parametreleri kullanır. Bu parametreleri değiştiremezsiniz. Daha fazla bilgi için bkz. Narrowband HD™ 1.0. Narrowband HD 1.0 kod dönüştürme şablonlarını yalnızca FLV, M3U8 (HLS) ve MP4 çıkış formatları için oluşturabilirsiniz.
Container	Container	Yes	Ses ve video akışlarını kapsüllemek için kullanılan konteyner formatı. Değer bir JSON dizesi olmalıdır.
MuxConfig	MuxConfig	No	Kod dönüştürme için segment yapılandırması. Konteyner formatı HLS ise bu parametreyi belirtmeniz gerekir. Değer bir JSON dizesi olmalıdır.
TransConfig	TransConfig	No	Koşullu kod dönüştürme yapılandırması. Kodu dönüştürülmüş videoyu oluşturmadan önce kaynak videonun bit hızına ve çözünürlüğüne göre temel mantığı uygulamak için bu parametreyi kullanın. Değer bir JSON dizesi olmalıdır.
TranscodeFileRegular	String	No	Çıkış dosyalarını depolamak için özel yol. Not Desteklenen joker karakterler: {MediaId} (video ID), {JobId} (kod dönüştürme işi ID'si) ve {PlayDefinition} (GetPlayInfo işlemi tarafından döndürülen tanım). Yalnızca rakamlar, İngilizce harfler, süslü parantezler {}, eğik çizgiler (/), tireler (-) ve alt çizgiler (_) kullanılabilir. Maksimum uzunluk 128 karakterdir. Yol {MediaId} ile başlamalıdır. Yapılandırma örneği {MediaId}/watermark-{PlayDefinition}: Kod dönüştürme sırasında ApsaraVideo VOD, {MediaId} ifadesini video ID'siyle (örneğin, 8ff5cc93f6da4079a47a77bf71d) ve {PlayDefinition} ifadesini tanım değeriyle (örneğin, fd) değiştirir. Çıkış örneği 8ff5cc93f6da4079a47a77bf71d/watermark-fd.mp4 (ApsaraVideo VOD, .mp4, .m3u8 veya .flv gibi dosya uzantısını otomatik olarak ekler).
Clip	Clip	No	Video kırpma yapılandırması. Değer bir JSON dizesi olmalıdır. Örneğin, yeni bir video oluşturmak üzere bir videodan 5 saniyelik içerik çıkarmak için bu parametreyi ayarlayın.
Rotate	String	No	Videonun döndürme açısı. Geçerli değerler: [0,360]. Örneğin, bu parametreyi 180 olarak ayarlamak video görüntüsünü ters çevirir.
EncryptSetting	EncryptSetting	No	Kod dönüştürme için şifreleme yapılandırması.
PackageSetting	PackageSetting	No	Paketleme yapılandırması. Yalnızca HLS uyarlanabilir bit hızı paketleme ve DASH paketleme desteklenir. Değer bir JSON dizesi olmalıdır.
SubtitleList	SubtitleConfig	No	Altyazı yapılandırması. Değer bir JSON dizesi olmalıdır.
WatermarkIds	String[]	No	İlişkili filigranların ID'leri. En fazla dört filigran ID'si ilişkilendirebilirsiniz. USER_DEFAULT_WATERMARK, varsayılan filigranın ID'sini temsil eder.
TranscodeTemplateId	String	No	Kod dönüştürme şablonunun ID'si. Bir şablonu değiştirirken bu parametreyi belirtmeniz gerekir.
TemplateName	String	No	Kod dönüştürme şablonunun adı. Bir şablon oluştururken bu parametreyi belirtmeniz gerekir.

TranscodeTemplate parametresi örneği

{
        "Type":"VideoPackage",
        "Video":{
                "Codec":"H.264",
                "Bitrate":"900",
                "Width":"960",
                "Remove":"false",
                "Fps":"30"
        },
        "Audio":{
                "Codec":"AAC",
                "Bitrate":"128",
                "Samplerate":"44100"
        },
        "Container":{
                "Format":"m3u8"
        },
        "MuxConfig":{
                "Segment":{
                        "Duration":"6"
                }
        },
        "EncryptSetting":{
                "EncryptType":"AliyunVoDEncryption"
        },
        "PackageSetting":{
                "PackageType":"HLSPackage"
                "PackageConfig":{
                        "BandWidth":"900000"
                }
        },
       "SubtitleUrl": "http://outin-40564284ef058b2163e1****.oss-cn-shanghai.aliyuncs.com/subtitles/c737f-14f1-4364-b107-d5f7f8ed****-cn.ass",
        "CharEncode": "UTF-8",
        "WatermarkIds":["USER_DEFAULT_WATERMARK","ddddddddd"],
        "Definition":"SD",
        "TemplateName":"test"
}

Video: video akışı kod dönüştürme yapılandırması

Not

Özel gereksinimleriniz yoksa yalnızca Codec, Bitrate, Height, Width ve Remove=false parametrelerini ayarlayabilirsiniz.
Çıkış videosu için Width veya Height parametrelerinden yalnızca birini ayarlamanızı öneririz. Bu, en boy oranının kaynak videoyla eşleşmesini sağlar.

Name	Type	Required	Description
Codec	String	Yes	Video kodlama formatı: H.264 veya H.265.
Remove	String	Yes	Video akışının kaldırılıp kaldırılmayacağını belirtir. Geçerli değerler: true: video akışını çıkış dosyasından kaldırır. false: video akışını çıkış dosyasında korur. Varsayılan değer: false.
Bitrate	String	No	Çıkış videosu için hedef bit hızı. Bu parametreyi belirtmezseniz bit hızı Crf parametresi kullanılarak hesaplanır. Birim: Kbps. Geçerli değerler: [10,50000].
Height	String	No	Çıkış videosunun yüksekliği. Değer 2'nin katı olmalıdır. Bu parametreyi belirtmezseniz kaynak dosyanın yüksekliği kullanılır. Birim: piksel. Geçerli değerler: [128,4096].
Width	String	No	Çıkış videosunun genişliği. Değer 2'nin katı olmalıdır. Bu parametreyi belirtmezseniz kaynak dosyanın genişliği kullanılır. Birim: piksel. Geçerli değerler: [128,4096].
Fps	String	No	Çıkış videosunun kare hızı. Bu parametreyi belirtmezseniz kaynak dosyanın kare hızı kullanılır. Birim: FPS. Geçerli değerler: (0,60].
Gop	String	No	Bitişik anahtar kareler arasındaki mesafe. Birim: kare. Geçerli değerler: [1,100000].
LongShortMode	String	No	Otomatik döndürme ekranını etkinleştirir. Çıkış videosunun genişliği kaynağın uzun kenarına (dikey modda yükseklik) karşılık gelir. Çıkış videosunun yüksekliği kaynağın kısa kenarına (dikey modda genişlik) karşılık gelir. Geçerli değerler: true: Etkin. false: Özellik devre dışı. Varsayılan değer: true. Bu özellik dikey videolar için en iyi sonucu verir. Etkinleştirmenizi öneririz.
Crf	String	No	Bit hızı kalite kontrol faktörü. Bu parametreyi belirtirseniz Bitrate parametresi yoksayılır. Daha yüksek bir değer daha düşük video kalitesi ve daha küçük dosya boyutu sağlar. Daha düşük bir değer daha yüksek video kalitesi, daha büyük dosya boyutu ve daha uzun kod dönüştürme süresi sağlar. Geçerli değerler: [0,51]. Varsayılan değer: 26. Bu değeri değiştirmenizi önermiyoruz.
Profile	String	No	Kodlama profili. Geçerli değerler: baseline: mobil cihazlar için uygundur. main: standart çözünürlüklü cihazlar için uygundur. high: yüksek çözünürlüklü cihazlar için uygundur. Varsayılan değer: high. Bu parametre yalnızca H.264 kodlaması için geçerlidir. En iyi uygulamalar Birden çok çözünürlük tanımını destekliyorsanız, düşük uçlu cihazlarda oynatmayı sağlamak için en düşük çözünürlük tanımını baseline olarak ayarlayın. Diğer tanımları main veya high olarak ayarlayın.
Preset	String	No	Ön ayarlı video algoritması. Geçerli değerler: veryfast, fast, medium, slow, slower. Varsayılan değer: medium. Bu parametre yalnızca H.264 kodlaması için geçerlidir. Bu değeri değiştirmenizi önermiyoruz.
ScanMode	String	No	Tarama modu. Geçerli değerler: interlaced: taralı tarama. progressive: ardışık tarama.
Bufsize	String	No	Arabellek boyutu. Birim: KB. Geçerli değerler: [1000,128000]. Varsayılan değer: 6000.
Maxrate	String	No	Maksimum video bit hızı. Birim: Kbps. Geçerli değerler: [1000,50000].
PixFmt	String	No	Videonun piksel formatı. yuv420p ve yuvj420p gibi standart formatlar desteklenir. Varsayılan değer: yuv420p veya orijinal piksel formatı.

Video parametresi örneği

{
        "Codec":"H.264",
        "Bitrate":"128",
        "Remove":"false",
        "Width":"640",
        "Fps":"30"
}

Audio: ses akışı kod dönüştürme yapılandırması

Not

Özel gereksinimleriniz yoksa yalnızca Codec, Bitrate ve Remove=false parametrelerini ayarlayabilirsiniz.

Name	Type	Required	Description
Codec	String	Yes	Ses kodlama formatı: AAC veya MP3.
Bitrate	String	Yes	Çıkış sesi için hedef bit hızı. Birim: Kbps. Geçerli değerler: [8,1000].
Remove	String	Yes	Ses akışının kaldırılıp kaldırılmayacağını belirtir. Geçerli değerler: true: ses akışını çıkış dosyasından kaldırır. false: ses akışını çıkış dosyasında korur. Varsayılan değer: false.
Samplerate	String	Yes	Örnekleme hızı. Birim: Hz. Geçerli değerler: 22050, 32000, 44100, 48000, 96000. Varsayılan değer: 44100. Konteyner formatı FLV ve ses kodeği MP3 ise örnekleme hızı 32000, 48000 veya 96000 olamaz. Ses kodeği MP3 ise örnekleme hızı 96000 olamaz.
Channels	String	No	Ses kanallarının sayısı. Varsayılan değer: 2. Codec MP3 olarak ayarlanırsa geçerli değerler 1 veya 2'dir. Codec AAC olarak ayarlanırsa geçerli değerler 1, 2, 4, 5, 6 veya 8'dir.
Profile	String	No	Ses kodeği profili. Codec AAC olarak ayarlanırsa geçerli değerler arasında aac_low, aac_he, aac_he_v2, aac_ld ve aac_eld bulunur.
Volume	Volume	No	Ses düzeyi yapılandırması.

Audio parametresi örneği

{
        "Codec":"AAC",
        "Bitrate":"128",
        "Remove":"false",
        "Samplerate":"44100"
}

Container: konteyner formatı

Name

Type

Required

Description

Format

String

Yes

Konteyner formatı.

Video kod dönüştürme FLV, MP4 ve HLS (M3U8+TS) formatlarını destekler.
Ses kod dönüştürme MP3 ve MP4 formatlarını destekler.
Konteyner formatı FLV ise video kodeği H.265 olarak ayarlanamaz.

Container parametresi örneği

{
        "Format":"mp4"
}

MuxConfig: HLS segment yapılandırması

Not

Konteyner formatı m3u8 olarak ayarlanırsa bu parametreyi belirtmeniz gerekir.

Name	Type	Required	Description
Segment	Segment	Yes	Segment yapılandırma alanlarını içeren bir JSON nesnesi.

Segment: segment yapılandırma ayrıntıları

Name

Type

Required

Description

Duration

String

Yes

Her bir TS segmentinin süresi. Değer bir tamsayı olmalıdır. Geçerli değerler: [1,60]. Birim: saniye.

Örnek: {"Duration":"10"}.

MuxConfig parametresi örneği

{
        "Segment":{
                "Duration":"10"
        }
}

TransConfig: koşullu kod dönüştürme yapılandırması

Ad	Tür	Gerekli	Açıklama
TransMode	String	Hayır	Kodlama modu. Geçerli değerler: onepass: Ortalama bit hızı (ABR) modu. Kodlama, twopass moduna göre daha hızlıdır. Alibaba Cloud varsayılan olarak onepass kullanır. twopass: Değişken bit hızı (VBR) modu. Kodlayıcı bit hızını hassas bir şekilde dağıtmak için iki kez çalışır; bu sayede daha küçük dosya boyutlarıyla daha yüksek kalite elde edilir. Twopass, onepass'e kıyasla daha uzun sürer ve canlı yayın veya gerçek zamanlı iletişim gibi gecikme süresine duyarlı senaryolar için uygun değildir. Giriş videosu yoğun şekilde sıkıştırılmışsa twopass bloklaşma hatalarına neden olabilir. CBR: Sabit bit hızı modu. Dosya boyunca aynı bit hızı kullanılır. CBR dosyaları VBR veya ABR dosyalarından daha büyüktür ve önemli bir kalite iyileştirmesi sağlamaz. Varsayılan değer: onepass.
IsCheckReso	String	Hayır	Kaynak video çözünürlüğünü kontrol ederek kodlama için kaynak çözünürlüğünün kullanılıp kullanılmayacağını belirler. Geçerli değerler: true: Çözünürlüğü kontrol eder. Çıkış çözünürlüğü kaynak çözünürlüğünü (genişlik veya yüksekliğe göre) aşarsa çıkış çözünürlüğü kaynak çözünürlüğüne ayarlanır. false: Kontrolü atlar. Varsayılan değer: false.
IsCheckResoFail	String	Hayır	Kaynak video çözünürlüğünü kontrol ederek kodlamanın başarısız olup olmayacağını belirler. Geçerli değerler: true: Çözünürlüğü kontrol eder. Çıkış çözünürlüğü kaynak çözünürlüğünü (genişlik veya yüksekliğe göre) aşarsa kodlama başarısız olur. false: Kontrolü atlar. Varsayılan değer: false.
IsCheckVideoBitrate	String	Hayır	Kaynak video bit hızını kontrol ederek kodlama için kaynak bit hızının kullanılıp kullanılmayacağını belirler. Geçerli değerler: true: Bit hızını kontrol eder. Çıkış bit hızı kaynak bit hızını aşarsa çıkış bit hızı kaynak bit hızına ayarlanır. false: Kontrolü atlar. Varsayılan değer: false.
IsCheckVideoBitrateFail	String	Hayır	Kaynak video bit hızını kontrol ederek kodlamanın başarısız olup olmayacağını belirler. Geçerli değerler: true: Bit hızını kontrol eder. Çıkış bit hızı kaynak bit hızını aşarsa kodlama gerçekleşmez. false: Kontrolü atlar. Varsayılan değer: false. Bu değer IsCheckVideoBitrate parametresinden önceliklidir.
IsCheckAudioBitrate	String	Hayır	Kaynak ses bit hızını kontrol ederek kodlama için kaynak bit hızının kullanılıp kullanılmayacağını belirler. Geçerli değerler: true: Bit hızını kontrol eder. Çıkış bit hızı kaynak bit hızını aşarsa çıkış bit hızı kaynak bit hızına ayarlanır. false: Kontrolü atlar. Varsayılan değer: false.
IsCheckAudioBitrateFail	String	Hayır	Kaynak ses bit hızını kontrol ederek kodlamanın başarısız olup olmayacağını belirler. Geçerli değerler: true: Bit hızını kontrol eder. Çıkış bit hızı kaynak bit hızını aşarsa kodlama gerçekleşmez. false: Kontrolü atlar. Varsayılan değer: false. Bu değer IsCheckAudioBitrate parametresinden önceliklidir.

TransConfig parametresi örneği

{
        "IsCheckReso":"true",
        "IsCheckResoFail":"false",
        "IsCheckVideoBitrate":"false",
        "IsCheckVideoBitrateFail":"false",
        "IsCheckAudioBitrate":"false",
        "IsCheckAudioBitrateFail":"false"
}

Clip: video kırpma yapılandırması

Ad	Tür	Gerekli	Açıklama
TimeSpan	TimeSpan	Evet	Video kırpma için zamanla ilgili yapılandırma.

TimeSpan: video kırpma yapılandırması

Ad	Tür	Gerekli	Açıklama
Seek	String	Evet	Video klibinin başlangıç zamanı. Format 1: sssss[.SSS]. Geçerli değerler: [0.000,86399.999]. Örnek: 12000.55. Format 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000,23:59:59.999]. Örnek: 00:00:05.003. Format 1'i kullanmanızı öneririz.
Duration	String	Hayır	Video kırpma süresi. Format 1: sssss[.SSS]. Geçerli değerler: [0.000,86399.999]. Örnek: 12000.55. Format 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000,23:59:59.999]. Örnek: 00:00:05.003. Format 1'i kullanmanızı öneririz. Not Duration veya End parametrelerinden birini belirtmeniz gerekir. Her ikisini de belirtirseniz End parametresi geçerli olur.
End	String	Hayır	Video kırpma sırasında atılacak son segmentin süresi. Format 1: sssss[.SSS]. Geçerli değerler: [0.000,86399.999]. Örnek: 12000.55. Format 2: hh:mm:ss[.SSS]. Geçerli değerler: [00:00:00.000,23:59:59.999]. Örnek: 00:00:05.003. Format 1'i kullanmanızı öneririz. Not Duration veya End parametrelerinden birini belirtmeniz gerekir. Her ikisini de belirtirseniz End parametresi geçerli olur. Başlangıç ve bitiş zamanları arasındaki süre toplam video süresini aşmamalıdır.

EncryptSetting: kodlama şifreleme yapılandırması

Not

HLS standart şifrelemeyi kullanmak için önce kodlama şablonundaki EncryptType parametresini AliyunVoDEncryption olarak ayarlayın. Ardından Medya kodlama işlerini gönderin işlemi çağrılabilir ve EncryptConfig parametresi yapılandırılabilir.

Ad

Tür

Gerekli

Açıklama

EncryptType

String

Evet

Şifreleme türü. Geçerli değerler:

AliyunVoDEncryption: M3U8 (HLS) videoları için özel şifreleme veya HLS standart şifreleme.
AliyunVoDLicenseEncryption: MP4 videoları için özel şifreleme.

EncryptSetting parametresi örneği

{
        "EncryptType":"AliyunVoDEncryption"
}

PackageSetting: kodlama paketleme yapılandırması

Not

Çıkarılan ses ve video akışlarını paketleyemezsiniz.
Şu anda yalnızca HLS uyarlanabilir bit hızı paketleme desteklenmektedir.

Ad	Tür	Gerekli	Açıklama
PackageType	String	Evet	Paketleme türü. Geçerli değer: HLSPackage (HLS uyarlanabilir bit hızı paketleme).
PackageConfig	PackageConfig	Hayır	Paketleme yapılandırması. VideoPackage şablonu için bu parametreyi belirtmeniz gerekir.
SubtitleExtractConfigList	SubtitleExtractConfig[]	Hayır	Altyazı paketleme yapılandırması. SubtitlePackage şablonu için bu parametreyi belirtmeniz gerekir. Diğer şablon türleri için belirtmeyin.

PackageConfig: video paketleme yapılandırması

Not

Bu parametreyi yalnızca HLS uyarlanabilir bit hızı akışı paketleme için ayarlamanız gerekir.

Ad

Tür

Gerekli

Açıklama

BandWidth

String

Evet

Maksimum bant genişliği. HLS paketleme için bu parametreyi belirtmeniz gerekir. Birim: bps.

Bu parametreyi yalnızca VideoPackage şablonları için belirtmeniz gerekir.

PackageSetting parametresi örneği

VideoPackage template configuration:
{
        "PackageType":"HLSPackage",
        "PackageConfig":{
                "BandWidth":"400000"
        }
}

SubtitleExtractConfig: altyazı paketleme yapılandırması

Ad	Tür	Gerekli	Açıklama
SubtitleUrlList	String[]	Evet	Altyazı dosyasının URL'si. Yalnızca HTTP OSS URL'leri desteklenir. HTTP CDN URL'leri ve HTTPS URL'leri desteklenmez. Not Yalnızca bir HTTP URL'si desteklenir. Altyazı dosyaları ApsaraVideo VOD tarafından tahsis edilen paketlerde depolanmalıdır.
Language	String	Evet	Altyazının dili. Örneğin, en-US. Daha fazla bilgi için RFC 5646'ya bakın.
Format	String	Evet	Altyazı dosyası formatı. Yalnızca .vtt dosyaları desteklenir. Örneğin: subtitle.vtt.
Name	String	Evet	Oynatıcıdaki altyazı parçasının görünen adı. Örneğin: Chinese veya English.

SubtitlePackage parametresi örneği

SubtitlePackage template configuration:
 {
      "PackageType": "HLSPackage",
      "SubtitleExtractConfigList": [
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/4bff3675-79a5-40fa-8c86-1f98169d****-eng.vtt"
          ],
          "Language": "en-US",
          "Format": "vtt",
          "Name": "English"
        },
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/a3f50b08-11c3-4511-94cf-7fd4f7a5****-jpn.vtt"
          ],
          "Language": "ja",
          "Format": "vtt",
          "Name": "Japanese"
        },
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/4dba87c2-a787-42cd-8328-2369aeb8****-cn.vtt"
          ],
          "Language": "cn",
          "Format": "vtt",
          "Name": "Chinese"
        }
      ]
    }

SubtitleConfig: altyazı yapılandırması

Ad

Tür

Gerekli

Açıklama

SubtitleUrl

String

Evet

Altyazı dosyasının OSS URL'si. HTTPS URL'leri ve salt CDN alan adları desteklenmez. Desteklenen altyazı formatları: srt ve ass.

Not

Altyazı dosyası ve kaynak video dosyası aynı bölgede (örneğin China East 1) ve aynı pakette bulunmalıdır.

CharEncode

String

Evet

Karakter kodlama formatı. Geçerli değerler:

auto: Otomatik algılama.
UTF-8
GBK
BIG5

Varsayılan değer: UTF-8.

Not

Altyazı dosyalarını yükleme hakkında daha fazla bilgi için bkz. CreateUploadAttachedMedia ve OSS dosyasını kullanarak dosya yükleyin.

SubtitleConfig parametresi örneği

{
        "SubtitleUrl": "http://outin-40564284ef058b2d300163e1****.oss-cn-shanghai.aliyuncs.com/subtitles/c737f-14f1-4364-b107-d5f7f8ed****.ass",
        "CharEncode": "UTF-8"
}

Volume: ses düzeyi yapılandırması

Ad	Tür	Gerekli	Açıklama
Method	String	Hayır	Ses düzeyi ayarlama yöntemi. Geçerli değerler: auto, dynamic, linear.
IntegratedLoudnessTarget	String	Hayır	Hedef ses düzeyi. Geçerli değerler: [-70,-5]. Method parametresi dynamic olarak ayarlandığında gereklidir. Varsayılan değer: -6.
TruePeak	String	Hayır	Maksimum tepe düzeyi. Geçerli değerler: [-9,0]. Method parametresi dynamic olarak ayarlandığında gereklidir. Varsayılan değer: -1.
LoudnessRangeTarget	String	Hayır	Ses düzeyi aralığı. Geçerli değerler: [1,20]. Method parametresi dynamic olarak ayarlandığında gereklidir. Varsayılan değer: 8.

Volume parametresi örneği

{
        "Method":"dynamic",
        "IntegratedLoudnessTarget":"-6",
        "TruePeak":"-1",
        "LoudnessRangeTarget":"8"
}

Desteklenen kapsayıcı formatları ve ses codec bileşeni kombinasyonları

Kapsayıcı	Ses Codec Bileşenleri
mp3	MP3
mp4	AAC
ogg	VORBIS, FLAC
flac	FLAC

Desteklenen kapsayıcı formatları, ses codec bileşenleri ve video codec bileşeni kombinasyonları

Kapsayıcı	Video Codec Bileşenleri	Ses Codec Bileşenleri
flv	H.264	AAC, MP3
mp4	H.264, H.265	AAC, MP3
ts	H.264, H.265	AAC, MP3
m3u8	H.264, H.265	AAC, MP3
gif	GIF	Desteklenmiyor

Desteklenen video codec bileşenleri ve video akışı yapılandırma parametreleri kombinasyonları

Video Codec Bileşenleri	H.264	H.265	GIF
Profile	Destekleniyor	×	×
Bitrate	Destekleniyor	Destekleniyor	×
Crf	Destekleniyor	Destekleniyor	×
Width	Destekleniyor	Destekleniyor	Destekleniyor
Height	Destekleniyor	Destekleniyor	√
Fps	Destekleniyor	Destekleniyor	Destekleniyor
Gop	Destekleniyor	Destekleniyor	×
Preset	√	×	×
ScanMode	Destekleniyor	Destekleniyor	Destekleniyor
Bufsize	Destekleniyor	Destekleniyor	×
Maxrate	√	✓	×
PixFmt	Destekleniyor	√	bgr8

TranscodeSummary: kodlama özeti

Ad	Tür	Açıklama
VideoId	String	Video kimliği.
TranscodeTemplateGroupId	String	Kodlama için kullanılan kodlama şablon grubunun kimliği.
TranscodeStatus	String	Kodlama durumu. Geçerli değerler: Processing: Devam ediyor. Partial: Bazı kodlama işleri tamamlandı. CompleteAllSucc: Tüm kodlama işleri başarılı oldu. CompleteAllFail: Tüm kodlama işleri başarısız oldu. Kaynak videoda sorun varsa hiçbir kodlama işi başlamaz ve görevin tamamı başarısız olur. CompletePartialSucc: Tüm kodlama işleri tamamlandı ancak yalnızca bazıları başarılı oldu.
TranscodeJobInfoSummaryList	TranscodeJobInfoSummary[]	Kodlama işi özetlerinin listesi.
CreationTime	String	Kodlama görevinin oluşturulduğu zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak görüntülenir.
CompleteTime	String	Kodlama görevinin tamamlandığı zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak görüntülenir.

TranscodeJobInfoSummary: bir kodlama işinin özeti

Ad	Tür	Açıklama
TranscodeTemplateId	String	Kullanılan kod dönüştürme şablonunun ID değeri.
Width	String	Çıktı videosunun genişliği. Birim: piksel.
Height	String	Çıktı videosunun yüksekliği. Birim: piksel.
Duration	String	Çıktı videosunun süresi. Birim: saniye.
Filesize	String	Çıktı video dosyasının boyutu. Birim: bayt.
Bitrate	String	Çıktı videosunun ortalama bit hızı. Birim: Kbps.
Fps	String	Çıktı videosunun kare hızı. Birim: saniye başına kare (fps).
Format	String	Çıktı videosunun kapsayıcı formatı.
WatermarkIdList	String[]	Çıktı videosuna uygulanan filigran ID değerlerinin listesi.
TranscodeProgress	Long	Kod dönüştürme ilerlemesi. Geçerli değerler: [0,100].
TranscodeJobStatus	String	Kod dönüştürme işinin durumu. Geçerli değerler: Transcoding: İş çalışıyor. TranscodeSuccess: İş başarıyla tamamlandı. TranscodeFail: Kod dönüştürme başarısız oldu.
CreationTime	String	Kod dönüştürme işinin oluşturulma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
CompleteTime	String	Kod dönüştürme işinin tamamlanma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
ErrorCode	String	Kod dönüştürme işi başarısız olursa döndürülen hata kodu.
ErrorMessage	String	Kod dönüştürme işi başarısız olursa döndürülen hata mesajı.

TranscodeTask: kod dönüştürme görevi hakkında bilgiler

Ad	Tür	Açıklama
TranscodeTaskId	String	Kod dönüştürme görevinin ID değeri.
TranscodeTemplateGroupId	String	Kod dönüştürme için kullanılan kod dönüştürme şablonu grubunun ID değeri.
VideoId	String	Videonun ID değeri.
TaskStatus	String	Kod dönüştürme görevinin durumu. Geçerli değerler: Processing: Devam ediyor. Partial: Bazı kod dönüştürme işleri tamamlandı. CompleteAllSucc: Tüm kod dönüştürme görevleri başarıyla tamamlandı. CompleteAllFail: Tüm kod dönüştürme işleri başarısız oldu. Kaynak videoda sorun varsa hiçbir kod dönüştürme işi başlamaz ve tüm görev başarısız olur. CompletePartialSucc: Tüm kod dönüştürme işleri tamamlandı ancak yalnızca bazıları başarılı oldu.
CreationTime	String	Kod dönüştürme görevinin oluşturulma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
CompleteTime	String	Kod dönüştürme görevinin tamamlanma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
Trigger	String	Tetikleyici türü. Geçerli değerler: Auto: Video yüklendikten sonra kod dönüştürme otomatik olarak tetiklenir. Manual: Kod dönüştürme, SubmitTranscodeJobs işlemi çağrılarak tetiklenir.
TranscodeJobInfoList	TranscodeJobInfo	Kod dönüştürme işleri hakkındaki bilgiler.

TranscodeJobInfo: kod dönüştürme işi hakkında bilgiler

Ad	Tür	Açıklama
TranscodeTaskId	String	Kod dönüştürme görevinin ID değeri.
TranscodeJobId	String	Kod dönüştürme işinin ID değeri.
VideoId	String	Videonun ID değeri.
TranscodeProgress	Long	Kod dönüştürme işinin ilerlemesi. Geçerli değerler: [0,100].
TranscodeJobStatus	String	Kod dönüştürme işinin durumu. Geçerli değerler: Transcoding: İş çalışıyor. TranscodeSuccess: İş başarıyla tamamlandı. TranscodeFail: İş başarısız oldu.
Priority	String	Kod dönüştürme görevinin önceliği.
Definition	String	Tanım. Not Bu değer, kod dönüştürme şablonunda yapılandırılan tanım etiketidir. Çıktı videosunun gerçek çözünürlük aralığını temsil etmez.
TranscodeTemplateId	String	Kod dönüştürme için kullanılan kod dönüştürme şablonunun ID değeri.
CreationTime	String	Kod dönüştürme işinin oluşturulma zamanı.
CompleteTime	String	Kod dönüştürme işinin tamamlanma zamanı.
InputFileUrl	String	Kaynak dosyanın OSS URL adresi.
OutputFile	OutputFile	Çıktı dosyası hakkındaki bilgiler.
ErrorCode	String	Kod dönüştürme işi başarısız olursa döndürülen hata kodu.
ErrorMessage	String	Kod dönüştürme işi başarısız olursa döndürülen hata mesajı.

OutputFile: kod dönüştürmeden sonraki çıktı dosyası

Ad	Tür	Açıklama
OutputFileUrl	String	Çıktı dosyasının OSS URL adresi.
Format	String	Çıktı dosyasının kapsayıcı formatı.
Width	String	Çıktı dosyasındaki videonun genişliği. Birim: piksel.
Height	String	Çıktı dosyasındaki videonun yüksekliği. Birim: piksel.
Duration	String	Çıktı dosyasının süresi. Birim: saniye.
Bitrate	String	Çıktı dosyasının ortalama bit hızı. Birim: Kbps.
Fps	String	Çıktı dosyasının kare hızı. Birim: saniye başına kare (fps).
Filesize	Long	Çıktı dosyasının boyutu. Birim: bayt.
EncryptType	String	Çıktı dosyası için kullanılan şifreleme türü. Değer bir JSON dizgesidir.
WatermarkIdList	String	Çıktı dosyasına uygulanan filigran ID değerlerinin listesi.
VideoStreamList	String	Video akışlarının listesi. Daha fazla bilgi için bkz. VideoStream: video akışı bilgileri.
AudioStreamList	String	Ses akışlarının listesi. Daha fazla bilgi için bkz. AudioStream: ses akışı bilgileri.

Veri istatistikleri

TopPlayVideoStatis: Günlük en çok izlenen video oynatma istatistikleri

Ad	Tür	Açıklama
VideoId	Dize (String)	Video kimliği.
PlayDuration	Dize (String)	Oynatma süresi (milisaniye cinsinden).
Title	Dize (String)	Video başlığı.
VV	Dize (String)	Video görüntüleme sayısı.
UV	Dize (String)	İçerik oynatan kullanıcı sayısı.

VideoPlayStatisDetail: Belirli bir video için günlük oynatma istatistikleri

Ad	Tür	Açıklama
Date	Dize (String)	Tarih (yyyyMMdd biçiminde). Örnek: 20170120.
PlayDuration	Dize (String)	Oynatma süresi (milisaniye cinsinden).
Title	Dize (String)	Video başlığı.
VV	Dize (String)	Video görüntüleme sayısı.
UV	Dize (String)	Oynatma yapan kullanıcı sayısı.
PlayRange	Dize (String)	Oynatma süresi dağılımı.

UserPlayStatisTotals: Günlük toplam kullanıcı oynatma istatistikleri

Ad	Tür	Açıklama
Date	Dize (String)	Tarih (yyyyMMdd biçiminde). Örnek: 20170120.
PlayDuration	Dize (String)	Toplam oynatma süresi (milisaniye cinsinden).
PlayRange	Dize (String)	Oynatma süresi dağılımı.
VV	VV	Toplam video görüntüleme sayısı.
UV	UV	İçerik oynatan toplam kullanıcı sayısı.

UserPlayStatisAvgs: Günlük ortalama kullanıcı oynatma istatistikleri

Ad	Tür	Açıklama
Date	Dize (String)	Tarih (yyyyMMdd biçiminde). Örnek: 20170120.
AvgPlayDuration	Dize (String)	Ortalama oynatma süresi (milisaniye cinsinden).
AvgPlayCount	Dize (String)	Ortalama video görüntüleme sayısı.

VV dağılımı

İstatistikler yalnızca Alibaba Cloud Video on Demand Player SDK'larını kullanan oynatmalar için toplanır.

Ad	Tür	Açıklama
Android	Dize (String)	Android oynatıcıdan gelen toplam video görüntüleme sayısı.
iOS	Dize (String)	iOS oynatıcıdan gelen toplam video görüntüleme sayısı.
Flash	Dize (String)	Flash oynatıcı tarafından gerçekleştirilen toplam oynatma oturumu sayısı.
HTML5	Dize (String)	HTML5 oynatıcıdan gelen toplam video görüntüleme sayısı.

Oynatma Sayısı UV Dağılımı

İstatistikler yalnızca Alibaba Cloud Video on Demand Player SDK'larını kullanan oynatmalar için toplanır.

Ad	Tür	Açıklama
Android	Dize (String)	Android oynatıcıdan gelen toplam benzersiz ziyaretçi sayısı.
iOS	Dize (String)	iOS oynatıcıda oynatma gerçekleştiren toplam kullanıcı sayısı.
Flash	Dize (String)	Flash Player'daki toplam oynatma kullanıcı sayısı
HTML5	Dize (String)	HTML5 oynatma için toplam kullanıcı sayısı.

Olay bildirimleri

MessageCallback: Olay bildirimi yapılandırmaları

Ad	Tür	Açıklama
CallbackType	Dize (String)	Geri arama yöntemi. Geçerli değerler: HTTP ve MNS.
CallbackURL	Dize (String)	HTTP geri aramaları için Webhook adresi.
MnsEndpoint	Dize (String)	MNS geri aramaları için MNS kuyruğunun genel uç noktası.
MnsQueueName	Dize (String)	MNS geri aramaları için MNS kuyruğunun adı.
EventTypeList	Dize (String)	Geri arama olay türü.
AuthSwitch	Dize (String)	HTTP geri aramaları için kimlik doğrulama anahtarı. Geçerli değerler: On: Etkin. off: Devre dışı.
AuthKey	Dize (String)	HTTP geri aramaları için kimlik doğrulama anahtarı.

Çoklu uygulama sistemi

AppInfo: Uygulama bilgileri

Ad	Tür	Açıklama
AppId	Dize (String)	Uygulama kimliği.
AppName	Dize (String)	Uygulama adı.
Description	Dize (String)	Uygulama açıklaması.
Type	Dize (String)	Uygulama türü. Geçerli değerler: Sistem varsayılan olarak ayarlanır. Custom: Kullanıcı tarafından oluşturuldu.
Status	Dize (String)	Uygulama durumu. Geçerli değerler: Normal: Normal. Disable: Uygulama devre dışı bırakıldı.
CreationTime	Dize (String)	UTC oluşturma zamanı.
ModificationTime	Dize (String)	UTC güncelleme zamanı.

AppPolicy: Uygulama yetkilendirme ilkesi bilgileri

Ad	Tür	Açıklama
AppId	Dize (String)	Uygulama kimliği.
PolicyType	Dize (String)	İlke türü. Geçerli değerler: System: Sistem ilkesi. Custom: Kullanıcı tanımlı ilke.
PolicyName	Dize (String)	İlke adı.
CreationTime	Dize (String)	UTC oluşturma zamanı.
Description	Dize (String)	İlke açıklaması.