シーンのオーディオ設定を照会します。

使用状況ノート

この操作は、特定のシーンのオーディオ構成をそのシーンIDで照会することをサポートします。

QPS制限

1人のユーザーが1秒あたり最大15クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeCasterSceneAudio

実行したい操作。 値をDescribeCasterSceneAudioに設定します。

CasterId String 必須 97df6b7f-3490-47d2-ac50-88338765 ****

制作スタジオのID。

CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。

ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。

制作スタジオ > 制作スタジオ管理

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
SceneId String 必須 97df6b7f-3490-47d2-ac50-88339087 ****

シーンのID。 シーンの詳細については、「プロダクションスタジオのシーンの照会」をご参照ください。

RegionId String 任意 cn-shanghai

リージョンの ID

レスポンスパラメーター

パラメーター データ型 例 説明
AudioLayers AudioLayerの配列

オーディオレイヤーの設定。
AudioLayer
FixedDelayDuration Integer 2,000

オーディオレイヤーの固定遅延。 単位：ミリ秒。
ValidChannel String all

オーディオレイヤの有効な音声チャネル。 設定可能な値は以下のとおりです。

  • left: 左チャンネル。
  • right: 右チャンネル。
VolumeRate Float 1

オーディオレイヤーの音量。
CasterId String 97df6b7f-3490-47d2-ac50-88338765 ****

制作スタジオのID。
FollowEnable Integer 1

オーディオフォロービデオ (AFV) が有効かどうかを示します。 デフォルトでは、AFVは有効です。 設定可能な値は以下のとおりです。

  • 0: オーディオミキシングモード。
  • 1: AFVモード。
MixList List RV01

プロダクションスタジオのオーディオレイヤーの位置ID。 このパラメーターで指定されたオーディオレイヤーは、AudioLayersパラメーターで指定されたものと同じ順序です。

RequestId String 98745637-3490-47d2-ac50-883387567098

リクエストの ID です。

例

リクエストの例

https://live.aliyuncs.com/?Action=DescribeCasterSceneAudio
&CasterId=97df6b7f-3490-47d2-ac50-88338765 ****
&SceneId=97df6b7f-3490-47d2-ac50-88339087 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<DescribeCasterSceneAudioResponse>
      <RequestId>97df6b7f-3490-47d2-ac50-8833e1b64597</RequestId>
      <MixList>RV01</MixList>
      <FollowEnable>1</FollowEnable>
      <CasterId>97df6b7f-3490-47d2-ac50-88338765 ****</CasterId>
      <AudioLayers>
            <ValidChannel> すべて </ValidChannel>
            <VolumeRate>1</VolumeRate>
            <FixedDelayDuration>2000</FixedDelayDuration>
      </AudioLayers>
</DescribeCasterSceneAudioResponse>

JSON 形式 

{
    "RequestId": "97df6b7f-3490-47d2-ac50-883387654365" 、
    "FollowEnable": 1、
    "CasterId":"97df6b7f-3490-47d2-ac50-88338765 ****" 、
    "MixList": [
            "RV01"
        ],
    
    "VideoFormat": [
        {                
            "VolumnRate": 1、
            "FixedDelayDuration": 2000、
            "ValidChannel": "すべて"    
        }
    ]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。