カスタムトランスコーディング設定情報を追加します。
リクエストパラメーター
パラメーター | タイプ | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | 操作インターフェイス名。システム必須パラメーター。値: AddCustomLiveStreamTranscode。 |
Domain | String | はい | ライブドメイン名。 |
App | String | はい | ライブストリームが属するアプリの名前。名前に使用可能な文字: 数字、英大文字・小文字、下線 (_ ) およびハイフン (- )。
|
Template | String | はい | カスタムトランスコーディングテンプレート名。名前に使用可能な文字: 数字、英大文字・小文字、下線 (_ ) およびハイフン (- )。
|
TemplateType | String | はい | カスタムトランスコードテンプレートタイプ。現在、h264-nbhd (カスタム H264 NarrowbandHD テンプレート) のみをサポートし、h264 (カスタム H264 標準テンプレート) はサポートしていません。 |
Height | Integer | はい | トランスコードするビデオの高さ。値の要件: Height ≥ 100、max(Height, Width) ≤ 1920、min(Height, Width) ≤ 1080。 |
Width | Integer | はい | トランスコードするビデオの幅。値の要件: Width ≥ 100、max(Height, Width) ≤ 1920、min(Height, Width) ≤ 1080。 |
FPS | Integer | はい | トランスコードする 1 秒あたりのビデオフレーム数。単位: fps。値の要件: 1 ≤ FPS ≤ 30。 |
VideoBitrate | Integer | はい | トランスコードするビデオのビットレート。単位: kbps。値の要件: 1 ≤ VideoBitrate ≤ 6000 (注意: トランスコードされたビデオは、できるだけ指定されたビットレートに近づけますが、特に指定されたビットレートが大きすぎるか小さすぎる場合、実際には同じになりません)。 |
リターンパラメーター
名前 | タイプ | 説明 |
---|---|---|
RequestId | String | タスクのリクエスト ID |
特別なエラーコード
エラーコード | 説明 | HTTP ステータスコード | 意味 |
---|---|---|---|
InvalidDomain.NotFound | 指定されたドメインは記録には存在しません。 | 404 | 現在のアカウントに対するドメイン名が見つかりません。 |
IllegalOperation | 不正なドメイン操作は許可されていません。 | 403 | 現在の操作はサポートされていません。たとえば、ドメイン名がライブビデオドメイン名ではありません。 |
InvalidParameters | 無効なパラメーター。 | 400 | パラメーターが無効です。たとえば、高さの値が大きすぎる、ビットレートの値が大きすぎるなど。 |
ConfigAlreadyExists | 設定はすでに存在します。 | 400 | 設定が追加されました。 |
InternalError | 不明なエラーのためにリクエスト処理に失敗しました。 | 500 | バックグラウンドに不明なエラーがあります。 |
例
リクエスト例
https://live.aliyuncs.com?Action=AddCustomLiveStreamTranscode&Domain=test101.cdnpe.com&App=xxx&Template=xxx&TemplateType=h264&Height=1280&Width=720&FPS=25&VideoBitrate=2400&<public request parameter>
リターン例
JSON 形式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
XML 形式
<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveStreamTranscodeResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveStreamTranscodeResponse>