查詢 RTMP 協定直播串流的詳細音視訊幀率與位元率。
介面說明
呼叫本介面查詢 RTMP 協定的直播串流在設定時間範圍內的一組音視訊幀率和音視訊位元率。
本介面為監控資料介面,資料採集處理方式不同於計費,不能用於計算用量進行對帳參考。
適用於獲取 90 天內的歷史資料。
介面資料延遲在 3-5 分鐘。
單次請求的時間跨度最大為 1 小時。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
live:DescribeLiveStreamDetailFrameRateAndBitRateData |
none |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
| DomainName |
string |
是 |
您的推流網域。 |
example.com |
| AppName |
string |
是 |
直播串流所屬應用程式名稱。您可在串流管理頁面查看 AppName。 |
AppName |
| StreamName |
string |
是 |
直播串流名稱。您可在串流管理頁面查看 StreamName。 |
exampleStreamName |
| StartTime |
string |
否 |
起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(北京時間,UTC+8)。 |
2017-12-21T08:00:00Z |
| EndTime |
string |
否 |
結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(北京時間,UTC+8)。 說明
StartTime 和 EndTime 指定不合法,或者不指定 StartTime 和 EndTime 時,預設讀取過去 1 小時的資料。 |
2017-12-22T08:00:00Z |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| FrameRateAndBitRateInfos |
array<object> |
每個時間間隔的詳細音視訊幀率與位元率資料。 |
|
|
object |
|||
| AudioBitRate |
number |
直播串流的音訊位元率。單位:Bps。 |
200 |
| AudioFrameRate |
number |
直播串流的音訊幀率。單位:FPS。 |
60 |
| BitRate |
number |
直播串流的位元率。單位:Bps。 |
1420 |
| StreamUrl |
string |
直播串流的 URL。 |
rtmp://example.com/AppName/exampleStreamName |
| Time |
string |
統計時間。格式為:yyyy-MM-ddTHH:mm:ssZ(北京時間,UTC+8)。 |
2016-09-13T16:04:00Z |
| VideoBitRate |
number |
直播串流的視訊位元率。單位:Bps。 |
1200 |
| VideoFrameRate |
number |
直播串流的視訊幀率。單位:FPS。 |
30 |
| RequestId |
string |
請求 ID。 |
BC858082-736F-4A25-867B-E5B67C85ACF7 |
直播串流的總位元率與音訊位元率、視訊位元率的計算採集方式是不同的,音訊位元率與視訊位元率的數值之和不一定與總位元率相等。本介面返回資料僅用於參考和監控之用,不能用於計算用量和對帳。
樣本
正常返回樣本
JSON格式
{
"FrameRateAndBitRateInfos": [
{
"AudioBitRate": 200,
"AudioFrameRate": 60,
"BitRate": 1420,
"StreamUrl": "rtmp://example.com/AppName/exampleStreamName",
"Time": "2016-09-13T16:04:00Z",
"VideoBitRate": 1200,
"VideoFrameRate": 30
}
],
"RequestId": "BC858082-736F-4A25-867B-E5B67C85ACF7"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。