すべてのプロダクト
Search
ドキュメントセンター

:UpdateLiveMPUTask

最終更新日:Dec 13, 2025

混合ストリームリレータスクを更新します。

操作説明

この操作を呼び出す前に、混合ストリームリレータスクが作成されていることを確認してください。混合ストリームリレータスクを作成するには、StartLiveMPUTask 操作を呼び出します。

QPS 制限

1 アカウントあたり毎秒最大 500 回までこの操作を呼び出すことができます。この制限を超えたリクエストはドロップされ、サービスが中断される可能性があります。この操作を呼び出す際は、この制限に注意することを推奨します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは 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:シングルストリームリレーモード。このモードでは、サービスは元のシングルストリームをリレーするだけで、混合ストリームのトランスコーディングは行いません。混合ストリームのトランスコーディングに関するパラメーターを設定する必要はありません。

  • 1 (デフォルト):混合ストリームリレーモード。

0

StreamURL

string

任意

アップストリーミング URL。リアルタイムメッセージングプロトコル (RTMP) 形式のアップストリーミング URL を 1 つだけ指定できます。URL は最大 2,048 文字です。アップストリーミング URL の生成ルールについては、「アップストリーミング URL とストリーミング URL」をご参照ください。

説明
  • ホットリンク保護が有効になっているドメイン名配下のアップストリーミング URL の場合、URL にアクセストークンを含める必要があります。

  • 異なるタスクで同じアップストリーミング URL を使用することはできません。

  • タスクが停止してから 10 秒以内は、同じアップストリーミング 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:Alibaba Cloud CDN ではない CDN サービスを使用してストリームリレーを実行します。

  • true:Alibaba Cloud CDN を使用してストリームリレーを実行します。

説明

このパラメーターのデフォルト値は false です。

false

SingleSubParams

object

任意

シングルストリームリレーパラメーター。MixMode を 0 に設定した場合、これらのパラメーターは必須です。

SourceType

string

任意

ビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:

  • camera (デフォルト)

  • shareScreen

camera

StreamType

string

任意

リレーするストリームのタイプ。有効な値:

  • 0 (デフォルト):オリジナルストリーム

  • 1:オーディオトラックのみ

  • 2:ビデオトラックのみ

0

UserId

string

必須

ユーザー ID。シングルストリームリレーモードでは、1 つのリクエストで 1 つのストリームのみをリレーできます。

yourSubUserId

TranscodeParams

object

任意

混合ストリームリレーパラメーター。MixMode を 1 に設定した場合、これらのパラメーターは必須です。

Background

object

任意

グローバル背景画像。

RenderMode

string

任意

グローバル背景画像の表示モード。

  • 0:黒枠を表示して、ビューに合わせて背景画像を比例的に拡大/縮小します。

  • 1 (デフォルト):ビューに合わせて背景画像をトリミングします。

1

URL

string

任意

グローバル背景画像の URL。

yourImageUrl

EncodeParams

object

任意

出力ストリームのエンコーディングパラメーター。

AudioOnly

string

任意

出力ストリームがオーディオのみのストリームであるかどうかを指定します。有効な値:

  • true:出力ストリームはオーディオのみのストリームです。このパラメーターを true に設定した場合、EncodeParams 配下でオーディオ関連のパラメーターのみを設定する必要があります。

  • false (デフォルト):出力ストリームはオーディオのみのストリームではありません。このパラメーターを false に設定した場合、VideoCodec および EnhancedParam パラメーターを除く、EncodeParams 配下のすべてのパラメーターを設定する必要があります。

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 (デフォルト)

  • H.265

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 フィールドが含まれます。

  • profile:エンコーディングレベル。ビデオコーデックが H.264 の場合、このフィールドの有効な値は baseline、main、high です。ビデオコーデックが H.265 の場合、このフィールドの有効な値は main です。

  • preset:エンコーディング速度とビデオ品質のトレードオフを調整します。このフィールドの有効な値は ultrafast、superfast、veryfast、faster、fast、medium、slow、slower、veryslow、placebo です。各値は、エンコーディング速度とビデオ品質のトレードオフのレベルを指定します。たとえば、ultrafast プリセットはエンコーディング速度が最も速いですがビデオ品質は最も低く、placebo プリセットは最高のビデオ品質のためにエンコーディング速度を犠牲にします。

説明

preset フィールドの値 superfast は、リアルタイムコミュニケーションのシナリオに適しています。エンコーディングの専門家でない場合は、このフィールドを設定しないことを推奨します。

{"profile": "high", "preset": "veryfast"}

Layout

object

任意

ビデオレイアウト情報。

説明

ビデオのトランスコーディングが必要な場合は、x 座標と y 座標、幅と高さ、レイヤーなどのビデオレイアウト情報を指定する必要があります。オーディオのみのトランスコーディングの場合、ビデオレイアウト情報は空のままにします。

UserPanes

array<object>

任意

ペインに関する情報。

array<object>

任意

ペインに関する情報。

UserInfo

object

任意

ストリームがペインで再生されるユーザーに関する情報。このパラメーターを空のままにすると、システムはストリーマーがチャンネルに参加する順序に基づいてこのパラメーターを自動的に設定します。

説明
  • このパラメーターを使用してユーザーの情報を指定する場合、そのユーザーの情報は TranscodeParams.UserInfos パラメーターでも指定する必要があります。

  • このパラメーターは、StreamType を 0 または 2 に設定した場合にのみ有効です。

SourceType

string

任意

ビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:

  • camera (デフォルト)

  • shareScreen

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

任意

ペインの表示モード。有効な値:

  • 0:黒枠を表示して、ビューに合わせてビデオを比例的に拡大/縮小します。

  • 1 (デフォルト):ビューに合わせてビデオをトリミングします。

1

UserInfos

array<object>

任意

ストリームがサブスクライブされているユーザーに関する情報。このパラメーターを空のままにすると、すべてのユーザーからのストリームが混合されます。

object

任意

ユーザーに関する情報。

SourceType

string

任意

サブスクライブされているビデオソースのタイプ。このパラメーターは、StreamType を 2 に設定した場合にのみ有効です。有効な値:

  • camera (デフォルト)

  • shareScreen

camera

StreamType

string

任意

サブスクライブされているリレーされたストリームのタイプ。有効な値:

  • 0 (デフォルト):オリジナルストリーム

  • 1:オーディオトラックのみ

  • 2:ビデオトラックのみ

0

ChannelId

string

任意

サブスクライブされているユーザーがいるチャンネルの ID。ユーザーが同じチャンネルにいる場合は、このパラメーターを空のままにすることができます。チャンネル間のストリームミキシングを実行する場合は、このパラメーターを指定することを推奨します。

yourChannelId

UserId

string

必須

サブスクライブされているユーザーの ID。

yourSubUserId

SeiParams

object

任意

補足的な拡張情報 (SEI) パラメーター。

LayoutVolume

object

任意

レイアウトとボリュームの SEI。このパラメーターを空のままにすると、デフォルトのレイアウトとボリュームの SEI が使用されます。

FollowIdr

string

任意

Instantaneous Decoder Refresh (IDR) フレームに SEI を含めるかどうかを指定します。有効な値:

  • 0:SEI を含めません。

  • 1:SEI を含めます。

0

Interval

string

任意

SEI が送信される間隔。有効な値の範囲:[1000,5000]。単位:ミリ秒。

1000

PassThrough

object

任意

SEI をパススルーするかどうかを指定します。

FollowIdr

string

任意

IDR フレームに SEI を含めるかどうかを指定します。有効な値:

  • 0:SEI を含めません。

  • 1: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

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。