Queries the frame rates and bitrates of all the live streams under an ingest domain.

Note
  • Use this operation instead of the DescribeLiveStreamsFrameRateAndBitRateData operation that is provided in earlier versions.
  • A latency exists in data collection and statistics. We recommend that you query the data that is generated 5 minutes ago. This operation can be called up to 100 times per second.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates a sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeLiveDomainFrameRateAndBitRateData

The operation that you want to perform. Set the value to DescribeLiveDomainFrameRateAndBitRateData.

DomainName String Yes example.com

The ingest domain.

QueryTime String Yes 2019-02-21T08:00:00Z

The time to implement the query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

Response parameters

Parameter Type Example Description
FrameRateAndBitRateInfos Array of FrameRateAndBitRateInfo

The frame rates and bitrates of the live streams that were queried.

FrameRateAndBitRateInfo
AudioFrameRate Float 42.9

The audio frame rate of the live stream. Unit: FPS.

BitRate Float 30693.96

The bitrate of the live stream. Unit: Bps

StreamUrl String rtmp://example.com/test/livestream_3_4

The URL of the live stream.

VideoFrameRate Float 24.9

The video frame rate of the live stream. Unit: FPS.

RequestId String C3F2C2C4-59BB-4B62-81FF-345BE557E3E3

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainFrameRateAndBitRateData
&DomainName=example.com
&QueryTime=2019-02-21T08:00:00Z
&<Common request parameters>

Sample success responses

XML format

<DescribeLiveDomainFrameRateAndBitRateDataResponse>
  <RequestId>C3F2C2C4-59BB-4B62-81FF-345BE557E3E3</RequestId>
  <FrameRateAndBitRateInfos>
        <FrameRateAndBitRateInfo>
              <AudioFrameRate>42.9</AudioFrameRate>
              <StreamUrl>rtmp://example.com/test/livestream_3_4</StreamUrl>
              <BitRate>30693.96</BitRate>
              <VideoFrameRate>24.9</VideoFrameRate>
        </FrameRateAndBitRateInfo>
        <FrameRateAndBitRateInfo>
              <AudioFrameRate>42.9</AudioFrameRate>
              <StreamUrl>rtmp://example.com/test/livestream_3_2</StreamUrl>
              <BitRate>31963.28</BitRate>
              <VideoFrameRate>24.9</VideoFrameRate>
        </FrameRateAndBitRateInfo>
        <FrameRateAndBitRateInfo>
              <AudioFrameRate>43.11</AudioFrameRate>
              <StreamUrl>rtmp://example.com/test/livestream_3_1</StreamUrl>
              <BitRate>33724.43</BitRate>
              <VideoFrameRate>25.03</VideoFrameRate>
        </FrameRateAndBitRateInfo>
        <FrameRateAndBitRateInfo>
              <AudioFrameRate>43.11</AudioFrameRate>
              <StreamUrl>rtmp://example.com/test/livestream_3_0</StreamUrl>
              <BitRate>32180.96</BitRate>
              <VideoFrameRate>25.01</VideoFrameRate>
        </FrameRateAndBitRateInfo>
  </FrameRateAndBitRateInfos>
</DescribeLiveDomainFrameRateAndBitRateDataResponse>

JSON format

{
    "RequestId": "C3F2C2C4-59BB-4B62-81FF-345BE557E3E3",
    "FrameRateAndBitRateInfos": {
        "FrameRateAndBitRateInfo": [{
            "AudioFrameRate": 42.9,
            "StreamUrl": "rtmp://example.com/test/livestream_3_4",
            "BitRate": 30693.96,
            "VideoFrameRate": 24.9
        }, {
            "AudioFrameRate": 42.9,
            "StreamUrl": "rtmp://example.com/test/livestream_3_2",
            "BitRate": 31963.28,
            "VideoFrameRate": 24.9
        }, {
            "AudioFrameRate": 43.11,
            "StreamUrl": "rtmp://example.com/test/livestream_3_1",
            "BitRate": 33724.43,
            "VideoFrameRate": 25.03
        }, {
            "AudioFrameRate": 43.11,
            "StreamUrl": "rtmp://example.com/test/livestream_3_0",
            "BitRate": 32180.96,
            "VideoFrameRate": 25.01
        }]
    }
}

Error codes

For a list of error codes, visit the API Error Center.