概要
ファイルのアップロード中に転送エラーが発生すると、そのエラーがキャプチャされ、残りのファイルに 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
}
}