リアルタイムストリーミング (RTS) が有効になっているストリーミングドメインに、カスタムトランスコーディング設定を追加します。
操作説明
注意事項
この操作を呼び出して、カスタムのリアルタイムストリーミング (RTS) トランスコーディング設定を追加できます。この操作は、h264、h264-nbhd、h264-origin、audio のカスタムトランスコーディングテンプレートのみをサポートします。
QPS 制限
この操作の 1 秒あたりのクエリ数 (QPS) 制限は、ユーザーあたり 10 回/秒です。制限を超えると、API 呼び出しがスロットリングされます。これはビジネスに影響を与える可能性があります。それに応じて呼び出しを計画してください。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:AddRtsLiveStreamTranscode |
create |
*Domain
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| Domain |
string |
必須 |
ストリーミングドメイン。 |
example.com |
| App |
string |
必須 |
ライブストリームの AppName。要件は次のとおりです:
|
aliyun-test |
| Template |
string |
必須 |
カスタムトランスコーディングテンプレートの名前。要件は次のとおりです:
説明
名前は標準トランスコーディングテンプレートの名前と同じにすることはできません。 |
ld |
| TemplateType |
string |
必須 |
カスタムトランスコーディングテンプレートのタイプ。有効な値は次のとおりです:
説明
ビデオタイプの場合、Height、Width、FPS、VideoBitrate、DeleteBframe が必須です。 |
h264 |
| Height |
integer |
任意 |
出力ビデオの高さ (ピクセル単位)。 重要
TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。 要件は次のとおりです:
たとえば、1560 × 1560 (正方形ビデオ) の解像度は無効です。 説明
h264-origin テンプレートの場合、ソースストリームの情報を保持するために解像度は最大 4K まで可能です。 |
1280 |
| Width |
integer |
任意 |
出力ビデオの幅 (ピクセル単位)。 重要
TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。 要件は次のとおりです:
たとえば、1560 × 1560 (正方形ビデオ) の解像度は無効です。 説明
h264-origin テンプレートの場合、ソースストリームの情報を保持するために解像度は最大 4K まで可能です。 |
720 |
| FPS |
integer |
任意 |
出力ビデオのフレームレート。単位:フレーム/秒 (FPS)。有効な値:1~60。 重要
TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。 |
30 |
| VideoBitrate |
integer |
任意 |
出力ビデオのビットレート。単位:kbps。有効な値:1~6000。 重要
TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。 説明
システムは指定されたビットレートでビデオをトランスコードしようとしますが、特に指定された値が高すぎるか低すぎる場合、実際のビットレートは指定された値と同じにならないことがあります。 |
2000 |
| AudioBitrate |
integer |
任意 |
出力オーディオのビットレート。単位:kbps。有効な値:1~1000。 重要
TemplateType を audio に設定した場合は必須です。 |
128 |
| Gop |
string |
任意 |
キーフレーム間隔を指定する Group of Pictures (GOP) サイズ。単位:秒。有効な値:1~3。 |
2 |
| DeleteBframes |
boolean |
任意 |
トランスコードされた出力ビデオから B フレームを削除するかどうかを制御します。有効な値は次のとおりです: 重要
TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。
|
false |
| Opus |
boolean |
任意 |
オーディオのトランスコーディングに Opus コーデックを使用するかどうかを指定します。これは主にネイティブ WebRTC との互換性のためのものです。有効な値は次のとおりです:
|
true |
| Profile |
integer |
任意 |
ビデオコーデックプロファイル。値が大きいほど、ビデオ品質は向上しますが、エンコーディングとデコーディングのリソース消費量も高くなります。有効な値は次のとおりです:
|
2 |
| AudioProfile |
string |
任意 |
オーディオコーデックプロファイル。有効な値は次のとおりです:
|
aac_low |
| AudioCodec |
string |
任意 |
オーディオコーデック。有効な値は次のとおりです:
説明
Opus コーデックを使用するには、Opus パラメーターを true に設定します。 |
aac |
| AudioRate |
integer |
任意 |
オーディオサンプルレート。有効な値:22050~96000。推奨:44100。単位:Hz。 説明
AudioProfile が aac_ld に設定されている場合、サンプルレートは 44100 を超えることはできません。 |
44100 |
| AudioChannelNum |
integer |
任意 |
オーディオチャンネル数。有効な値は次のとおりです:
|
2 |
| Lazy |
string |
任意 |
オンデマンドトランスコーディングを有効にするかどうかを指定します。有効な値は次のとおりです:
|
no |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
例
成功レスポンス
JSONJSON
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
エラーコード
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。