プロダクションスタジオにレイアウトを追加します。
操作説明
この操作を呼び出す前に、プロダクションスタジオを作成し、ビデオソースを追加する必要があります。 プロダクションスタジオの作成方法の詳細については、「プロダクションスタジオの作成 (CreateCaster)」をご参照ください。
QPS 制限
この操作のクエリ/秒 (QPS) 制限は、ユーザーあたり 1 秒あたり 10 回の呼び出しです。 この制限を超える API 呼び出しはスロットルされ、ビジネスに影響を与える可能性があります。 この制限を超えないでください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:AddCasterLayout |
create |
*Caster
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| VideoLayer |
array<object> |
必須 |
ビデオレイアウト。 |
|
|
object |
任意 |
ビデオレイアウト。 |
||
| FillMode |
string |
任意 |
要素の塗りつぶしモード。有効な値:
|
fit |
| FixedDelayDuration |
integer |
任意 |
ビデオレイヤーの固定レイテンシ。このパラメータを使用して、ビデオと字幕を同期させます。単位:ミリ秒。デフォルト値:0。有効な値:0 ~ 5000。 |
5000 |
| HeightNormalized |
number |
任意 |
レイヤーの正規化された高さ。
|
1 |
| PositionNormalized |
array |
任意 |
ビデオレイヤーの位置。値は正規化された座標 注:x 座標と y 座標は正規化する必要があります。 |
0.3 |
|
number |
任意 |
値。 |
0 |
|
| PositionRefer |
string |
任意 |
レイヤーの位置の基準点。有効な値:
|
topLeft |
| WidthNormalized |
number |
任意 |
レイヤーの正規化された幅。
|
1 |
| AudioLayer |
array<object> |
必須 |
オーディオレイアウト。 |
|
|
object |
任意 |
オーディオレイアウト。 |
||
| FixedDelayDuration |
integer |
任意 |
オーディオレイヤーの固定レイテンシ。このパラメータを使用して、オーディオと字幕を同期させます。単位:ミリ秒。デフォルト値:0。有効な値:0 ~ 5000。 |
5000 |
| ValidChannel |
string |
任意 |
オーディオ入力に使用されるサウンドチャンネル。有効な値:
|
all |
| VolumeRate |
number |
任意 |
オーディオストリームの音量乗数係数。有効な値:0 ~ 10.0。
|
1.0 |
| BlendList |
array |
必須 |
ビデオソースのロケーション ID。ロケーション ID の順序は、VideoLayer パラメータで指定されたビデオレイヤーの順序に対応します。 ロケーション ID の詳細については、「ビデオソースの追加 (AddCasterVideoResource)」をご参照ください。 LocationId については、「ビデオソースを追加する」をご参照ください。 この ID は、VideoLayers 要素の順序に対応しています。 |
RV01 |
|
string |
任意 |
ロケーション ID。 |
RV01 |
|
| MixList |
array |
必須 |
オーディオソースのロケーション ID。ロケーション ID の順序は、AudioLayer パラメータで指定されたオーディオレイヤーの順序に対応します。 ロケーション ID の詳細については、「ビデオソースの追加 (AddCasterVideoResource)」をご参照ください。 `LocationId` については、「ビデオソースを追加する」をご参照ください。 `AudioLayers` 要素の順序に対応しています。 |
RV01 |
|
string |
任意 |
ロケーション ID。 |
RV01 |
|
| CasterId |
string |
必須 |
プロダクションスタジオの ID。
説明
クラウドプロダクションスタジオページのプロダクションスタジオの名前は、プロダクションスタジオの ID です。 |
LIVEPRODUCER_POST-cn-0pp1czt**** |
リクエストパラメータで、N は要素のシーケンス番号を表します。たとえば、VideoLayer.N.FillMode は N 番目のビデオレイヤーの塗りつぶしモードを指定します。 VideoLayer.1.FillMode は最初のビデオレイヤーの塗りつぶしモードを指定し、VideoLayer.2.FillMode は 2 番目のビデオレイヤーの塗りつぶしモードを指定します。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| LayoutId |
string |
レイアウトの ID。プロダクションスタジオまたは仮想スタジオのレイアウトを削除、変更、またはクエリする操作を呼び出すときに、この ID をリクエストパラメータとして使用できます。 |
21926b36-7dd2-4fde-ae25-51b5bc8e**** |
| RequestId |
string |
リクエスト ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F**** |
例
成功レスポンス
JSONJSON
{
"LayoutId": "21926b36-7dd2-4fde-ae25-51b5bc8e****",
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | MissingParameter | %s. | |
| 400 | InvalidParameter.Malformed | There are invalid parameters: %s. | |
| 400 | InvalidCasterId.Malformed | %s, please check and try again later. | |
| 400 | InvalidVideoLayersAndBlendListSize.Mismatch | %s, please check and try again later. | |
| 400 | InvalidAudioLayersAndMixListSize.Mismatch | %s, please check and try again later. | |
| 400 | InvalidUserId.Malformed | %s, please check userId. | |
| 400 | InvalidBlendList.ExceedNorm | %s, please check and try again later. | |
| 400 | InvalidPositionNormalized.Malformed | %s, please check and try again later. | |
| 400 | InvalidHeightOrWidthNormalized | %s, please check and try again later. | |
| 400 | InvalidMixList.ExceedNorm | %s, please check and try again later. | |
| 401 | IllegalOperation | %s, please check and try again later. | |
| 500 | InternalError | %s, please try again later. | |
| 404 | InvalidCaster.NotFound | %s, please check and try again later. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。