概覽
如果在嘗試上傳文件時遇到傳輸錯誤,該錯誤將被捕獲,並且 Zencoder 服務器將用於其余文件。如果這發生在您的工作中,將在發佈到您的應用程序和 Zencoder 儀表板上的通知中提供詳細信息。
儀表板信息
在儀表板中查看作業時,上面的橫幅將出現在頁面頂部,類似於為測試作業顯示的橫幅。
使用備份服務器的特定輸出被標記在進度條下方,以及關於作業和通知的任何警告的類似通知:
當您查看輸出記錄時,將顯示阻止 Zencoder 將視頻上傳到您的服務器的錯誤。提供了完整的 錯誤列表 。
通知
API 版本 2 還包括豐富的通知,其中包含的信息比版本 1 中的基本通知多得多。如果使用了備份服務器,除了元數據和有關作業文件的詳細信息外,還包括幾個屬性。如果不使用備份服務器,則不會傳遞這些屬性。
backup_server_used
如果使用了任何備份伺服器,則會設定為 true。如果它為 false 或不存在,則您的文件已上傳到請求中指定的 URL 或默認的 S3 存儲桶。
primary_upload_error_link
將包含 Zencoder 上傳視頻時發生的錯誤的文檔鏈接。
primary_upload_error_message
將包含有關上傳視頻時發生的錯誤的人性化消息。
primary_thumbnail_upload_error_message 將包含指向 Zencoder 文檔的鏈接,以了解上傳縮略圖時發生的錯誤。
primary_thumbnail_upload_error_message
將包含有關上傳縮略圖時發生的錯誤的人性化消息。
範例
{
"output":{
"backup_server_used":true,
"primary_upload_error_link":"https://app.zencoder.com/docs/errors/UnableToResolveHostError",
"primary_upload_error_message":"There was a problem resolving the host at ftp://example.com. Please check that it is correct.",
"height":120,
"audio_sample_rate":8000,
"frame_rate":8.0,
"channels":"1",
"duration_in_ms":1920,
"video_bitrate_in_kbps":70,
"video_codec":"h264",
"format":"mpeg4",
"audio_codec":"aac",
"label":null,
"file_size_in_bytes":17938,
"width":160,
"audio_bitrate_in_kbps":9,
"id":235314,
"total_bitrate_in_kbps":79,
"state":"finished",
"url":"https://zencoder-live.s3.amazonaws.com/2Faf653e6b5e9b4440081827be2dcd962c.mp4?Signature=0DhjHh1X%2FQxSk%&Expires=1317237305&AWSAccessKeyId=AKIA"
},
"job":{
"created_at":"2011-09-27T04:20:10Z",
"pass_through":null,
"updated_at":"2011-09-27T04:21:18Z",
"submitted_at":"2011-09-27T04:20:10Z",
"id":172151,
"state":"finished"
},
"input":{
"height":120,
"audio_sample_rate":8000,
"frame_rate":8.0,
"channels":"1",
"duration_in_ms":1552,
"video_bitrate_in_kbps":32,
"video_codec":"mpeg4",
"format":"mpeg4",
"audio_codec":"aac",
"file_size_in_bytes":13960,
"width":160,
"audio_bitrate_in_kbps":9,
"id":172149,
"state":"finished",
"total_bitrate_in_kbps":41
}
}