Bu konuda ApsaraVideo VOD API işlemlerinin aşağıdaki istek parametreleri açıklanmaktadır: PlayConfig, ReAuthInfo, UserData, SpriteSnapshotConfig ve EncryptConfig. Ayrıca bu parametrelerin nasıl yapılandırılacağına ilişkin örnekler sunulmaktadır.
PlayConfig: Medya oynatma için özel yapılandırmaları belirtir
Açıklama
Bu parametre, medya oynatma için özel yapılandırmaları belirtir. Değer bir JSON dizesidir. Belirli bir akış alan adı için oynatma ayarlarını yapılandırabilirsiniz. Aşağıdaki tabloda PlayConfig içindeki alanlar açıklanmaktadır.
Alan | Tür | Gerekli | Açıklama |
PlayDomain | String | Hayır | Akış alan adı. Birden fazla kaynak alan adı yapılandırdıysanız videoyu oynatmak için bir alan adı belirtebilirsiniz. Belirtilen akış alan adı mevcut değilse akış URL'sinde videonun depolama adresi için yapılandırılan varsayılan akış alan adı döndürülür. Örnek: |
XForwardedFor | String | Hayır | İsteği başlatan istemcinin kaynak IP adresi. Bu alan, isteğin inceleme güvenlik grubuna eklenen bir IP adresinden başlatılıp başlatılmadığını kontrol etmek için kullanılır. Daha fazla bilgi için bkz. Güvenlik IP adresi ön izlemesi. ApsaraVideo VOD, istek birden çok proxy sunucusundan geçtikten sonra bu alana göre istemci IP adresini alabilir. Veri güvenliğini artırmak amacıyla istemci IP adresi Örnek: yqCD7Fp1uqChoVj/sl/p5Q==. |
PreviewTime | String | Hayır | Ön izleme süresi. Birim: saniye. Minimum değer 1'dir. Maksimum değer videonun toplam süresidir. Bu alanı boş bırakırsanız videonun tamamı ön izlenir. Ön izleme özelliğinin nasıl etkinleştirileceği hakkında daha fazla bilgi için bkz. Ön izleme özelliğini yapılandırın. |
MtsHlsUriToken | String | Hayır | Bir belirteç verme hizmeti tarafından oluşturulan MtsHlsUriToken. HTTP Live Streaming (HLS) şifrelemesi kullanılarak şifrelenen videoların şifresini çözmek ve oynatmak için bu alanı belirtebilirsiniz. Bu işlem şifre çözme anahtarlarının çalınmasını önler. Daha fazla bilgi için bkz. HLS şifreleme. |
EncryptType | String | Hayır | Şifreleme türü. Şifrelenmemiş veya belirli bir türde şifrelenmiş videoları oynatmak için bu alanı belirtebilirsiniz. Geçerli değerler:
Not Şifrelenmiş akışların oynatma URL'leri hakkında daha fazla bilgi için bkz. Oynatma URL'si alma. |
StorageClass | String | Hayır | Medya varlığının depolama sınıfı. Belirli bir depolama sınıfına ait oynatma akışlarını filtrelemek için bu alanı kullanabilirsiniz. Geçerli değerler:
|
Örnek kod
PlayConfig={
"PlayDomain": "vod.test_domain",
"XForwardedFor": "yqCD7Fp1uqChoVj/sl/p5Q==",
"PreviewTime": "20",
"MtsHlsUriToken": "yqCD7Fp1uqChoVjslp5Q",
"StorageClass": "Standard"
} ReAuthInfo: CDN yeniden kimlik doğrulamasının yapılandırmalarını belirtir
Açıklama
Bu alan, medya oynatma için CDN yeniden kimlik doğrulamasının yapılandırmalarını belirtir. Değer bir JSON dizesidir. CDN yeniden kimlik doğrulama özelliğini etkinleştirdikten sonra URL imzalama için uid ve rand alanlarını belirtmek üzere bu alanı kullanabilirsiniz. Aşağıdaki tabloda ReAuthInfo içindeki alanlar açıklanmaktadır.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Örnek kod
ReAuthInfo={
"uid": "12345",
"rand": "abckljd"
}UserData: Medya yükleme için özel yapılandırmaları belirtir
Açıklama
Bu alan, olay bildirimleri için geri arama yapılandırmaları gibi medya yükleme için özel yapılandırmaları belirtir. Değer bir JSON dizesidir.
Aşağıdaki tabloda UserData içindeki alanlar açıklanmaktadır.
Alan | Tür | Gerekli | Açıklama |
MessageCallback | String | Hayır | Olay bildirimleri için geri arama yapılandırmaları. Değer bir JSON nesnesidir. Bu alanı belirtirseniz belirtilen geri arama yapılandırmaları geçerli olur. Aksi takdirde varsayılan geri arama yapılandırmaları geçerli olur. Daha fazla bilgi için bkz. Birden çok geri arama URL'si belirtin. Aşağıdaki içerik parametreleri açıklamaktadır:
Örnekler:
|
Extend | String | Hayır | Olay geri aramaları sırasında şeffaf bir şekilde iletilen özel genişletilmiş alan. Değer en fazla 512 bayt uzunluğunda olabilir. Değer bir JSON nesnesidir. Not Dolar işareti ($), eğik çizgi (/) veya ters eğik çizgi (\) gibi özel karakterler içeren bir değeri Base64 kodlu bir dizeye dönüştürmenizi öneririz. |
AccelerateConfig | String | Hayır | Yükleme hızlandırma yapılandırmaları. Değer bir JSON nesnesidir. Örnek: {"Type":"oss","Domain":"https://oss-accelerate.aliyuncs.com"}. Type hızlandırma yöntemini belirtir ve değeri yalnızca oss olabilir. Domain hızlandırılmış alan adını belirtir. Hızlandırılmış alan adını Bölgeler ve uç noktalar konusundan alabilirsiniz. Varsayılan olarak HTTPS kullanılır. Not Yükleme hızlandırma özelliğini yalnızca özelliği etkinleştirmek için bir başvuru gönderdikten sonra kullanabilirsiniz. Yükleme hızlandırma özelliğinin nasıl etkinleştirileceği ve özelliğin faturalama kuralları hakkında daha fazla bilgi için bkz. Yükleme hızlandırma. |
Örnek kod
UserData={
"MessageCallback": {
"MNSEndpoint":"http://174809843091****.mns.cn-beijing.aliyuncs.com",
"MNSQueueName":"vod-callback-bj",
"CallbackType": "mns"
},
"Extend": {
"localId": "xxx",
"test": "www"
},
"AccelerateConfig": {
"Type": "oss",
"Domain": "https://oss-accelerate.aliyuncs.com"
}
}
EncryptConfig: HLS şifreleme yapılandırmalarını belirtir
Bu alan, HLS şifreleme yapılandırmalarını belirtir.
Alan | Tür | Gerekli | Açıklama |
CipherText | String | Evet | Düz metin anahtarını almak için kullanılan şifreli metin anahtarı. Bu parametreyi GenerateKMSDataKey işlemine verilen yanıtta yer alan |
DecryptKeyUri | String | Evet | Şifreli metin anahtarına göre alınan anahtar URI'si. URI, şifre çözme hizmetinin IP adresinden ve Kurduğunuz şifre çözme hizmeti. Örneğin şifre çözme hizmetinizin IP adresi
|
KeyServiceType | String | Evet | Anahtar hizmeti türü. Varsayılan değer: KMS (Alibaba Cloud Key Management Service). |
SpriteSnapshotConfig: Görüntü sprite'larını yakalama yapılandırmalarını belirtir
Alan | Tür | Gerekli | Açıklama |
CellWidth | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin genişliği. Varsayılan değer: normal bir anlık görüntünün genişliği. Birim: piksel. |
CellHeight | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin yüksekliği. Varsayılan değer: normal bir anlık görüntünün yüksekliği. Birim: piksel. |
Padding | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin dolgusu. Varsayılan değer: 0. Birim: piksel. |
Margin | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin kenar boşluğu. Varsayılan değer: 0. Birim: piksel. |
Color | String | Hayır | Görüntü sprite'ının arka plan rengi. Varsayılan değer: Siyah. |
Columns | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin sütun sayısı. Geçerli değerler: [1,10000]. Varsayılan değer: 10. |
Lines | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin satır sayısı. Geçerli değerler: [1,10000]. Varsayılan değer: 10. |
KeepCellPic | String | Hayır | Görüntü sprite'ını oluşturan orijinal anlık görüntülerin saklanıp saklanmayacağını belirtir. Geçerli değerler:
Varsayılan değer: keep. |
SpriteSnapshotConfig içindeki tüm alanları ilgili varsayılan değerlerine ayarlamak istiyorsanız SpriteSnapshotConfig için boş bir JSON dizesi belirtin.