すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:UpdateCasterSceneAudio

    ドキュメントセンター

    ApsaraVideo Live:UpdateCasterSceneAudio

    最終更新日:Jan 06, 2026

    シーンの音声設定を変更します。この操作では、音声設定を追加したり、既存の音声設定を新しいシーンに適用したりすることもできます。

    操作説明

    最初に、CreateCaster 操作を呼び出してプロダクションスタジオを作成します。その後、この操作を呼び出して、シーンの音声設定を更新できます。この操作は、オーディオミキシングモードと AFV（Audio-Follows-Video）モードをサポートしています。

    QPS 制限

    Alibaba Cloud アカウントごとに、1 秒あたり最大 10 クエリ/秒（QPS）を実行できます。この制限を超える API 呼び出しはスロットルされ、ビジネスに影響を与える可能性があります。この制限を守ることをお勧めします。

    今すぐお試しください

    この 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:UpdateCasterSceneAudio

    update

    *Caster

    acs:live:*:{#accountId}:caster/{#CasterId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョンの ID です。

    cn-shanghai
    AudioLayer

    array<object>

    任意

    音声設定です。

    object

    任意

    音声設定です。

    Filter

    string

    任意

    3A オーディオアルゴリズムによって提供される機能を有効にするかどうかを指定します。このパラメーターは、次のフィールドで構成されます。

    • enableAgc：（オプション）3A アルゴリズムの自動ゲインコントロール（AGC）機能を有効にするかどうかを指定します。有効な値：0（無効、デフォルト）、1（有効）。

    • enableAns：（オプション）3A アルゴリズムのインテリジェントノイズリダクション機能を有効にするかどうかを指定します。有効な値：0（無効、デフォルト）、1（有効）。

    • ansMode：（オプション）インテリジェントノイズリダクション機能のモード。このフィールドは、enableAns が 1 に設定されている場合にのみアクティブになります。有効な値：0（音声ノイズリダクション、デフォルト）、1（音楽ノイズリダクション）。

    説明

    ノイズリダクションを向上させるには、ansMode を 1 に設定します。

    • enableBeautify：（オプション）音声美化を有効にするかどうかを指定します。有効な値：0（無効、デフォルト）、1（有効）。

    • voiceBeautifyMode：（オプション）音声美化モード。このフィールドは、enableBeautify が 1 に設定されている場合にのみアクティブになります。有効な値：0（磁気男性音声、デフォルト）、1（フレッシュ女性音声）。

    { "enableAgc":0, "enableAns":1 }
    FixedDelayDuration

    integer

    任意

    音声レイヤーの固定レイテンシです。このパラメーターは、音声を字幕と同期させるために使用されます。

    単位：ミリ秒。有効な値：0 ～ 5000。デフォルト値：0。

    0
    ValidChannel

    string

    任意

    音量入力に使用されるサウンドチャンネルです。有効な値：

    • leftChannel：左サウンドチャンネル。

    • rightChannel：右サウンドチャンネル。

    • all（デフォルト）：両方のサウンドチャンネル。

    all
    VolumeRate

    number

    任意

    オーディオストリームの音量乗数です。有効な値：0 ～ 10.0。デフォルト値：1.0。

    • 1.0：元の音量が使用されます。

    • 1 未満の値は音量を下げます。

    • 1 を超える値は音量を上げます。

    1
    MixList

    array

    任意

    関連付けられているロケーション ID のリストです。ロケーション ID の順序は、音声レイヤーの順序と同じでなければなりません。

    RV01

    string

    任意

    リソースのロケーション ID です。

    ロケーション ID の順序は、音声レイヤーの順序と一致している必要があります。チャンネルが有効になっている場合は、チャンネルのロケーション ID を使用します。それ以外の場合は、ビデオソースのロケーション ID を使用します。

    RV01
    CasterId

    string

    必須

    プロダクションスタジオの ID です。

    • CreateCaster 操作を呼び出してプロダクションスタジオを作成する場合、レスポンスの CasterId パラメーターから ID を取得できます。

    • LIVE コンソールでプロダクションスタジオを作成する場合は、LIVE コンソール > プロダクションスタジオ > クラウドプロダクションスタジオ ページに移動して ID を確認します。

    説明

    クラウドプロダクションスタジオページのリストにあるプロダクションスタジオの名前は、プロダクションスタジオの ID です。

    LIVEPRODUCER_POST-cn-0pp1czt****
    SceneId

    string

    必須

    シーンの ID です。DescribeCasterScenes 操作を呼び出してプロダクションスタジオ内のシーンのリストをクエリする場合、レスポンスの ComponentId パラメーターから ID を取得できます。

    a2b8e671-2fe5-4642-a2ec-bf93880e1****
    FollowEnable

    integer

    任意

    AFV モードを有効にするかどうかを指定します。このパラメーターを空のままにすると、最後の設定が保持されます。有効な値：

    • 0：オーディオミキシングモード。

    • 1：AFV（Audio-Follows-Video）モード。

    1

    リクエストパラメーターで、N はシーケンス番号を示します。例えば：

    • AudioLayer.N.VolumeRate は、N 番目の要素の音量乗数を指定します。

    • AudioLayer.1.VolumeRate は、最初の要素の音量乗数を指定します。

    • AudioLayer.2.VolumeRate は、2 番目の要素の音量乗数を指定します。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストの ID です。

    16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidCasterId.Malformed %s, please check and try again later.
    400 InvalidUserId.Malformed %s, please check userId.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 InvalidAudioLayersAndMixListSize.Mismatch %s, please check and try again later.
    400 IncorrectSceneStatus %s, please check and try again later.
    400 IncorrectSceneStatus.ConfigError %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.
    412 ResourceInChannel.PreConditionFailed %s, please try again later.
    412 ResourceInChannel.Invalid %s, please check and try again later.
    500 InternalError %s, please try again later.
    404 InvalidCaster.NotFound %s, please check and try again later.
    404 InvalidScene.NotFound %s, please check and try again later.
    404 ResourceInChannel.NotFound %s, please check and try again later.

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

    変更履歴

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