edit-icon download-icon

DescribeLiveStreamBitRateData

Last Updated: Mar 19, 2018

Description

Get the frame rate and bit rate in a set time range of a rtmp-based live stream. Applicable for getting history data.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeLiveStreamBitRateData

The name of this interface. Value: DescribeLiveStreamBitRateData

DomainName String Yes www.yourdomain.com

Your domain name.

AppName String No testApp

Name of the app, which live stream belongs to.

EndTime String No 2017-12-22T08:00:00:00Z

EndTime.

  • UTC format, for example: 2016-06-30T19:00:00Z.

StartTime String No 2017-12-21T08:00:00:00Z

StartTime.

  • UTC format, for example: 2016-06-29T19:00:00Z.

StreamName String No testStream

Name of live stream.

Return parameters

Parameters Type Example values Description
FrameRateAndBitRateInfos

Frame rate/bit rate information of the live streams.

  └StreamUrl String rtmp://play.aliyunlive.com/AppName/StreamName

URL of the live stream.

  └VideoFrameRate Float 30

Video frame rate of the live stream.

  └AudioFrameRate Float 100

Audio frame rate of the live stream.

  └BitRate Float 600

Bit rate of the live stream.

  └Time String 2016-09-13T16:04:00Z

Statistic time.

  • UTC time.

RequestId String 40A4F36D-A7CC-473A-88E7-154F92242566

The ID of the job request.

Example

Request example

  1. https://live.aliyuncs.com/?Action=DescribeLiveStreamsFrameRateAndBitRateData&DomainName=live.aliyunlive.com&AppName=testApp&StreamName=testStream&StartTime=2016-09-13T16:00:00Z&EndTime=2016-09-13T16:05:00Z&<Public Request Parameter>

For more information, see Public Request Parameter.

Normal return example

JSON format

  1. {
  2. "FrameRateAndBitRateInfos":{
  3. "FrameRateAndBitRateInfo":[
  4. {
  5. "AudioFrameRate":"167.67",
  6. "BitRate":"192.02",
  7. "StreamUrl":"rtmp://live.aliyunlive.com/live/test101",
  8. "Time":" 2016 - 09 - 13 T16: 05: 00 Z",
  9. "VideoFrameRate":"30.01"
  10. },
  11. {
  12. "AudioFrameRate":"165.43",
  13. "BitRate":"192",
  14. "StreamUrl":"rtmp://live.aliyunlive.com/live/test102",
  15. "Time":"2016 - 09 - 13 T16: 04: 00 Z",
  16. "VideoFrameRate":"29.22"
  17. },
  18. {
  19. "AudioFrameRate":"166.77",
  20. "BitRate":"192",
  21. "StreamUrl":"rtmp://live.aliyunlive.com/live/test103",
  22. "Time":"2016 - 09 - 13 T16: 03: 00 Z",
  23. "VideoFrameRate":"30.33"
  24. },
  25. {
  26. "AudioFrameRate":"167.53",
  27. "BitRate":"192",
  28. "StreamUrl":"rtmp://live.aliyunlive.com/live/test104",
  29. "Time":"2016 - 09 - 13 T16: 02: 00 Z",
  30. "VideoFrameRate":"30"
  31. },
  32. {
  33. "AudioFrameRate":"168.01",
  34. "BitRate":"192",
  35. "StreamUrl":"rtmp://live.aliyunlive.com/live/test104",
  36. "Time":"2016 - 09 - 13 T16: 01: 00 Z",
  37. "VideoFrameRate":"30"
  38. }
  39. ]
  40. },
  41. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  42. }

Exception return example

JSON format

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

Error code

For more information about error code of this product, see Error code.

Thank you! We've received your feedback.