Zencoder 如何在上傳失敗時儲存檔案

Zencoder 將恢復所有無法上傳到您的服務器的文件,並通過 Amazon S3 提供給您。

概覽

如果在嘗試上傳文件時遇到傳輸錯誤,該錯誤將被捕獲,並且 Zencoder 服務器將用於其余文件。如果這發生在您的工作中,將在發佈到您的應用程序和 Zencoder 儀表板上的通知中提供詳細信息。

儀表板信息

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
  }
}