混合ストリームリレータスクを更新します。
操作説明
この操作を呼び出す前に、混合ストリームリレータスクが作成されていることを確認してください。混合ストリームリレータスクを作成するには、StartLiveMPUTask 操作を呼び出します。
QPS 制限
1 アカウントあたり毎秒最大 500 回までこの操作を呼び出すことができます。この制限を超えたリクエストはドロップされ、サービスが中断される可能性があります。この操作を呼び出す際は、この制限に注意することを推奨します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:UpdateLiveMPUTask |
update |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| AppId |
string |
必須 |
アプリケーション ID。指定できるアプリケーション ID は 1 つだけです。ID は最大 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。 |
yourAppId |
| ChannelId |
string |
必須 |
チャネル ID。指定できるチャネル ID は 1 つだけです。ID は最大 64 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。 |
yourChannelId |
| TaskId |
string |
必須 |
タスク ID。指定できるタスク ID は 1 つだけです。ID は最大 55 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。ID は一意である必要があります。 |
yourTaskId |
| MixMode |
string |
任意 |
ストリームミキシングモード。有効な値:
|
0 |
| StreamURL |
string |
任意 |
アップストリーミング URL。リアルタイムメッセージングプロトコル (RTMP) 形式のアップストリーミング URL を 1 つだけ指定できます。URL は最大 2,048 文字です。アップストリーミング URL の生成ルールについては、「アップストリーミング URL とストリーミング URL」をご参照ください。 説明
|
rtmp://example.com/live/stream |
| MultiStreamURL |
array<object> |
任意 |
リレーする複数のアップストリーミング URL。このパラメーターを使用すると、複数のアップストリーミング URL を指定できます。 |
|
|
object |
任意 |
|||
| URL |
string |
任意 |
アップストリーミング URL。RTMP 形式のみがサポートされています。URL は最大 2,048 文字です。アップストリーミング URL の生成ルールについては、「アップストリーミング URL とストリーミング URL」をご参照ください。 |
rtmp://example.com/live/stream**** |
| IsAliCdn |
boolean |
任意 |
Alibaba Cloud CDN を使用してストリームリレーを実行するかどうかを指定します。有効な値:
説明
このパラメーターのデフォルト値は false です。 |
false |
| SingleSubParams |
object |
任意 |
シングルストリームリレーパラメーター。MixMode を 0 に設定した場合、これらのパラメーターは必須です。 |
|
| SourceType |
string |
任意 |
ビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:
|
camera |
| StreamType |
string |
任意 |
リレーするストリームのタイプ。有効な値:
|
0 |
| UserId |
string |
必須 |
ユーザー ID。シングルストリームリレーモードでは、1 つのリクエストで 1 つのストリームのみをリレーできます。 |
yourSubUserId |
| TranscodeParams |
object |
任意 |
混合ストリームリレーパラメーター。MixMode を 1 に設定した場合、これらのパラメーターは必須です。 |
|
| Background |
object |
任意 |
グローバル背景画像。 |
|
| RenderMode |
string |
任意 |
グローバル背景画像の表示モード。
|
1 |
| URL |
string |
任意 |
グローバル背景画像の URL。 |
yourImageUrl |
| EncodeParams |
object |
任意 |
出力ストリームのエンコーディングパラメーター。 |
|
| AudioOnly |
string |
任意 |
出力ストリームがオーディオのみのストリームであるかどうかを指定します。有効な値:
|
false |
| AudioBitrate |
string |
任意 |
オーディオのビットレート。有効な値の範囲:[8,500]。単位:Kbit/s。 |
128 |
| AudioChannels |
string |
任意 |
サウンドチャンネルの数。有効な値:1 および 2。 |
2 |
| AudioSampleRate |
string |
任意 |
音声サンプリングレート。有効な値:8000、16000、32000、44100、48000。単位:Hz。 |
44100 |
| VideoCodec |
string |
任意 |
ビデオコーデック。有効な値:
|
H.264 |
| VideoBitrate |
string |
任意 |
ビデオのビットレート。有効な値の範囲:[1,10000]。単位:Kbit/s。 |
3500 |
| VideoFramerate |
string |
任意 |
ビデオのフレームレート。有効な値の範囲:[1,60]。単位:1 秒あたりのフレーム数 (FPS)。 |
25 |
| VideoGop |
string |
任意 |
ビデオの Group of Pictures (GOP) サイズ。有効な値の範囲:[1,60]。 |
20 |
| VideoHeight |
string |
任意 |
ビデオの高さ。有効な値の範囲:[0,1920]。単位:ピクセル。 |
1000 |
| VideoWidth |
string |
任意 |
ビデオの幅。有効な値の範囲:[0,1920]。単位:ピクセル。 |
1920 |
| EnhancedParam |
string |
任意 |
エンコーディング拡張に使用されるパラメーターで、JSON 文字列です。このパラメーターには、オプションの profile フィールドと preset フィールドが含まれます。
説明
preset フィールドの値 superfast は、リアルタイムコミュニケーションのシナリオに適しています。エンコーディングの専門家でない場合は、このフィールドを設定しないことを推奨します。 |
{"profile": "high", "preset": "veryfast"} |
| Layout |
object |
任意 |
ビデオレイアウト情報。 説明
ビデオのトランスコーディングが必要な場合は、x 座標と y 座標、幅と高さ、レイヤーなどのビデオレイアウト情報を指定する必要があります。オーディオのみのトランスコーディングの場合、ビデオレイアウト情報は空のままにします。 |
|
| UserPanes |
array<object> |
任意 |
ペインに関する情報。 |
|
|
array<object> |
任意 |
ペインに関する情報。 |
||
| UserInfo |
object |
任意 |
ストリームがペインで再生されるユーザーに関する情報。このパラメーターを空のままにすると、システムはストリーマーがチャンネルに参加する順序に基づいてこのパラメーターを自動的に設定します。 説明
|
|
| SourceType |
string |
任意 |
ビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:
|
camera |
| ChannelId |
string |
任意 |
ユーザーがいるチャンネルの ID。ユーザーが同じチャンネルにいる場合は、このパラメーターを空のままにすることができます。チャンネル間のストリームミキシングを実行する場合は、このパラメーターを指定することを推奨します。 |
yourChannelId |
| UserId |
string |
任意 |
ユーザー ID。 |
yourSubUserId |
| Height |
string |
任意 |
ペインの高さ。値は正規化されます。 |
0.2632 |
| Width |
string |
任意 |
ペインの幅。値は正規化されます。 |
0.3564 |
| X |
string |
任意 |
ペインの x 座標。値は正規化されます。 |
0.2456 |
| Y |
string |
任意 |
ペインの y 座標。値は正規化されます。 |
0.3789 |
| ZOrder |
string |
任意 |
ペインが存在するレイヤー。値 0 は最下層を示します。値が 1 増えるごとに、次の上位レイヤーを示します。 |
0 |
| BackgroundImageUrl |
string |
任意 |
ペインの背景画像の URL。この画像は、ユーザーがカメラをオフにした場合、またはチャンネルにいない場合に表示されます。 |
yourImageUrl |
| RenderMode |
string |
任意 |
ペインの表示モード。有効な値:
|
1 |
| UserInfos |
array<object> |
任意 |
ストリームがサブスクライブされているユーザーに関する情報。このパラメーターを空のままにすると、すべてのユーザーからのストリームが混合されます。 |
|
|
object |
任意 |
ユーザーに関する情報。 |
||
| SourceType |
string |
任意 |
サブスクライブされているビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:
|
camera |
| StreamType |
string |
任意 |
サブスクライブされているリレーされたストリームのタイプ。有効な値:
|
0 |
| ChannelId |
string |
任意 |
サブスクライブされているユーザーがいるチャンネルの ID。ユーザーが同じチャンネルにいる場合は、このパラメーターを空のままにすることができます。チャンネル間のストリームミキシングを実行する場合は、このパラメーターを指定することを推奨します。 |
yourChannelId |
| UserId |
string |
必須 |
サブスクライブされているユーザーの ID。 |
yourSubUserId |
| SeiParams |
object |
任意 |
補足的な拡張情報 (SEI) パラメーター。 |
|
| LayoutVolume |
object |
任意 |
レイアウトとボリュームの SEI。このパラメーターを空のままにすると、デフォルトのレイアウトとボリュームの SEI が使用されます。 |
|
| FollowIdr |
string |
任意 |
Instantaneous Decoder Refresh (IDR) フレームに SEI を含めるかどうかを指定します。有効な値:
|
0 |
| Interval |
string |
任意 |
SEI が送信される間隔。有効な値の範囲:[1000,5000]。単位:ミリ秒。 |
1000 |
| PassThrough |
object |
任意 |
SEI をパススルーするかどうかを指定します。 |
|
| FollowIdr |
string |
任意 |
IDR フレームに SEI を含めるかどうかを指定します。有効な値:
|
0 |
| Interval |
string |
任意 |
SEI が送信される間隔。有効な値の範囲:[1000,5000]。単位:ミリ秒。 |
1000 |
| PayloadContent |
string |
任意 |
SEI のペイロードコンテンツ。 |
yourPayloadContent |
| PayloadContentKey |
string |
任意 |
SEI のペイロードコンテンツのキー。このパラメーターを指定しない場合、デフォルト値 udd が使用されます。 |
yourPayloadContentKey |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
0F72851F-5DC1-1979-9B2C-450040316C3E |
例
成功レスポンス
JSONJSON
{
"RequestId": "0F72851F-5DC1-1979-9B2C-450040316C3E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParam | %s | |
| 400 | InvalidAppId | %s | |
| 500 | InternalError | InternalError | |
| 403 | OperationDenied | Your account has not enabled the Live service | |
| 403 | Forbidden | %s | |
| 404 | MissingParam | %s |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。