Bu konuda VideoAnalysisComplete olayı, bildirim içeriği ve geri arama örnekleri açıklanmaktadır.
Olay türü
VideoAnalysisComplete
Olay açıklaması
ApsaraVideo VOD, ses ve video kaynak dosyalarını yüklendikten sonra analiz eder. Analiz tamamlandığında bu olay oluşturulur.
Varsayılan olarak ApsaraVideo VOD yüklenen tüm ses ve video dosyalarını analiz eder. Analiz ücretsizdir.
Analiz işlemi, kaynak dosyalardan süre, çözünürlük (genişlik ve yükseklik), bit hızı ve kare hızı gibi temel meta verileri çıkarır.
Analiz tamamlandıktan sonra meta veriler medya varlığı kitaplığına eklenir. Kaynak dosya hakkında daha fazla meta veri almak için GetMezzanineInfo işlemini çağırabilirsiniz.
Olay bildirimi içeriği
Parametre Adı | Tür | Gerekli | Açıklama |
EventTime | String | Evet | Olayın oluşturulduğu saat. Saat UTC cinsindendir ve yyyy-MM-ddTHH:mm:ssZ biçimini izler. |
EventType | String | Evet | Olay türü. Bu zorunlu bir parametredir. Değer sabit olarak VideoAnalysisComplete şeklindedir. |
VideoId | String | Evet | Ses veya video dosyasının ID değeri. |
Status | String | Evet | Kaynak dosyanın analiz durumu.
|
Width | Long | Hayır | Kaynak dosyanın genişliği. Bu alan yalnızca ses içeren dosyalar için döndürülmez. |
Height | Long | Hayır | Kaynak dosyanın yüksekliği. Bu alan yalnızca ses içeren dosyalar için döndürülmez. |
Duration | Float | Hayır | Kaynak dosyanın süresi (saniye cinsinden). |
Bitrate | String | Hayır | Kaynak dosyanın bit hızı (Kbps cinsinden). |
Fps | String | Hayır | Kaynak dosyanın kare hızı (saniye başına kare cinsinden). Bu alan yalnızca ses içeren dosyalar için döndürülmez. |
Size | Long | Hayır | Kaynak dosyanın boyutu (bayt cinsinden). |
ErrorCode | String | Hayır | İşin hata kodu. Bu alan, kaynak dosya analizi sırasında bir hata oluştuğunda döndürülür. |
ErrorMessage | String | Hayır | İşin hata mesajı. Bu alan, kaynak dosya analizi sırasında bir hata oluştuğunda döndürülür. |
Status değeri fail olarak ayarlanırsa analiz başarısız olmuştur ve kaynak dosyanın temel bilgileri döndürülmez. Başarısızlık genellikle kaynak dosyanın anormal kapsüllenmesinden kaynaklanır.
Geri arama örnekleri
Geri arama örnekleriyle ilgili aşağıdaki hususlara dikkat edin:
HTTP geri araması için aşağıdaki içerik HTTP POST gövdesidir.
MNS geri araması için aşağıdaki içerik mesaj gövdesidir.
Başarılı analiz geri arama örneği:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"Duration":"12",
"Height":"360",
"Width":"630",
"Fps":"30",
"Bitrate":"499",
"Size":"1234568",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"success"
}Başarısız analiz geri arama örneği:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"fail",
"ErrorCode":"InvalidParameter.ResourceContentBad",
"ErrorMessage":"The resource operated InputFile is bad"
}