カスタムトランスコーディング設定を追加します。
操作説明
この操作は、次のタイプのカスタムトランスコーディングテンプレートをサポートしています:
-
h264:カスタム H.264 標準テンプレート。
-
h264-nbhd:カスタム H.264 狭帯域 HD™ テンプレート。
-
h265:カスタム H.265 標準テンプレート。
-
h265-nbhd:カスタム H.265 ナローバンド HD テンプレート。
-
audio:音声のみのテンプレート。
QPS 制限
この操作には、ユーザーごとに毎分 6,000 回の呼び出しという 1 秒あたりのクエリ数 (QPS) 制限があります。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:AddCustomLiveStreamTranscode |
create |
*Domain
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| Domain |
string |
必須 |
ストリーミングドメイン。 |
example.com |
| App |
string |
必須 |
ライブストリームの AppName。 |
liveApp**** |
| KmsKeyID |
string |
任意 |
Key Management Service (KMS) のカスタマーマスターキー (CMK) の ID。 |
afce5722-81d2-43c3-9930-7601da11**** |
| KmsUID |
string |
任意 |
KMS アカウントの ID。 |
25346073170691**** |
| KmsKeyExpireInterval |
string |
任意 |
キーのローテーション期間。単位:秒。有効値:60~3600。 |
3600 |
| Template |
string |
必須 |
トランスコーディングテンプレートのカスタム名。 説明
名前には、数字、文字、ハイフン (-) を使用できます。数字または文字で始まる必要があります。標準のトランスコーディングテンプレートの名前と同じにすることはできません。 |
LiveCusTranscode**** |
| TemplateType |
string |
必須 |
カスタムトランスコーディングテンプレートのタイプ。有効値:
説明
ビデオタイプの場合、Height、Width、FPS、および VideoBitrate は必須です。 |
h264 |
| Height |
integer |
任意 |
出力ビデオの高さ (ピクセル単位)。要件:
説明
h265-nbhd の場合、720 を超えることはできません。 |
720 |
| Width |
integer |
任意 |
出力ビデオの幅 (ピクセル単位)。 要件:
説明
h265-nbhd の場合、1280 を超えることはできません。 |
576 |
| FPS |
integer |
任意 |
出力ビデオのフレームレート。単位:1 秒あたりのフレーム数 (FPS)。有効値:1~60。 |
30 |
| VideoBitrate |
integer |
任意 |
出力ビデオのビットレート。単位:kbps。有効値:1~6000。 説明
システムは指定されたビットレートでビデオをトランスコードしようとしますが、実際のビットレートは、特に指定された値が高すぎるか低すぎる場合、指定された値と同じにならないことがあります。 |
720 |
| AudioBitrate |
integer |
任意 |
出力オーディオのビットレート。単位:kbps。有効値:1~1000。 |
512 |
| Gop |
string |
任意 |
Group of Pictures (GOP) サイズ。単位はフレームまたは秒です。有効値:
|
1 |
| Profile |
integer |
任意 |
ビデオコーデックプロファイル。値が大きいほど、ビデオ品質は向上しますが、エンコーディングとデコーディングのリソース消費量も高くなります。有効値:
|
2 |
| AudioProfile |
string |
任意 |
オーディオプロファイル。有効値:
|
aac_low |
| AudioCodec |
string |
任意 |
オーディオコーデック。有効値:
|
AAC |
| AudioRate |
integer |
任意 |
オーディオサンプルレート。有効値:22050~96000。 重要
AudioProfile を aac_ld に設定した場合、サンプルレートは 44100 を超えることはできません。 |
96000 |
| AudioChannelNum |
integer |
任意 |
オーディオチャンネル数。有効値:
|
2 |
| Lazy |
string |
任意 |
オンデマンドトランスコーディングを有効にするかどうかを指定します。有効値:
|
yes |
| EncryptParameters |
string |
任意 |
暗号化設定。JSON 文字列形式で指定します。
説明
設定した場合、その内部フィールドを空にすることはできません。 |
{"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"} |
| ResWithSource |
string |
任意 |
アダプティブ解像度設定。指定した場合、Height および Width パラメーターをオーバーライドします。フィールド:
|
{"Type":"short","Value":"1080"} |
| FpsWithSource |
string |
任意 |
ソースのフレームレートに基づいて出力フレームレートを適応させ、指定された範囲内に保ちます。指定した場合、FPS パラメーターをオーバーライドします。フィールド:
|
{"UpLimit":60,"LowerLimit":1} |
| BitrateWithSource |
string |
任意 |
アダプティブビットレート設定。指定した場合、VideoBitrate パラメーターをオーバーライドします。フィールド:
|
{"UpLimit":2500,"LowerLimit":800,"Factor":1} |
| ExtWithSource |
string |
任意 |
トランスコードされたストリームをソースストリームに合わせるその他のアダプティブ設定。フィールド:
|
{"KeyFrameOpen":"yes","Copyts":"yes","SeiMode":1} |
| DeInterlaced |
boolean |
任意 |
トランスコーディング中にインターレースを自動的に検出して削除するかどうかを指定します。インターレース解除は、インターレースビデオをプログレッシブビデオに変換します。
|
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParameters | %s Please check and try again later. | |
| 400 | ConfigAlreadyExists | %s Please check and try again later. | |
| 400 | TemplateLimit | %s Please check and try again later. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。