調(diào)用DescribeQualityDistributionStatData獲取質(zhì)量統(tǒng)計的分布數(shù)據(jù)。

使用說明

本接口用于獲取質(zhì)量統(tǒng)計的分布數(shù)據(jù)。使用該接口時，限制如下：

  • 支持查詢最近365天（不包含查詢當(dāng)天）任意范圍的數(shù)據(jù)。
  • 如果查詢范圍小于24小時，則按小時統(tǒng)計查詢的數(shù)據(jù)；如果查詢范圍大于或等于24小時，則按天統(tǒng)計查詢的數(shù)據(jù)。

QPS限制

本接口的單用戶QPS限制為10次/秒。超過限制，API調(diào)用會被限流，這可能會影響您的業(yè)務(wù)，請合理調(diào)用。更多信息，請參見QPS限制。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數(shù)文檔。

請求語法

POST /api/quality/describeQualityDistributionStatData HTTP/1.1

請求參數(shù)

名稱 類型 位置 是否必選 示例值 描述
StartDate Long Query 是 1615824000

查詢的開始時間，使用UNIX時間戳表示，單位：秒。
EndDate Long Query 是 1615910399

查詢的結(jié)束時間，使用UNIX時間戳表示，單位：秒。
StatDim String Query 是 CHANNEL_ONLINE

統(tǒng)計維度，取值：

  • CHANNEL_ONLINE：按照頻道在線人數(shù)統(tǒng)計。
  • NETWORK：按照網(wǎng)絡(luò)類型統(tǒng)計。
  • OS：按照系統(tǒng)類型統(tǒng)計。
AppId String Query 是 0rbd****

App ID，可通過控制臺創(chuàng)建和查詢。

返回數(shù)據(jù)

名稱 類型 示例值 描述
QualityStatDataList Array of QualityStatData

質(zhì)量統(tǒng)計數(shù)據(jù)列表。
Name String WiFi

統(tǒng)計維度，取值：

  • 當(dāng)StatDim為CHANNELONLINE時，取值：ONE_TO_FIVE（1~5人）、SIX_TO_TEN（6~10人）、ELEVEN_TO_TWENTY（11~20人）、TWENTYONE_TO_FIFTY（21~50人）、ABOVE_FIFTY（50人以上）。
  • 當(dāng)StatDim為NETWORK時，取值：WiFi、4G等。
  • 當(dāng)StatDim為OS時，取值：iOS、Android等。
CallDurationRatio String 0.8366

通話時長占比，用四位小數(shù)表示，例如1.0000表示通話時長占比為100%。
JoinChannelSucRate String 0.9966

加入頻道成功率，用四位小數(shù)表示。
JoinChannelSucFiveSecRate String 0.9920

5秒加入頻道成功率，用四位小數(shù)表示。
AudioSpeakOutDuration Long 1546

音頻首次出聲時間，單位：毫秒。
VideoFirstPicDuration Long 1677

視頻首次出圖時間，單位：毫秒。
AudioStuckRate String 0.0049

音頻卡頓率，用四位小數(shù)表示。
VideoStuckRate String 0.0137

視頻卡頓率，用四位小數(shù)表示。
AudioDelay Long 464

音頻延時，單位：毫秒。
VideoDelay Long 403

視頻延時，單位：毫秒。
AudioHighQualityTransmissionRate String 0.9941

音頻優(yōu)質(zhì)傳輸率，用四位小數(shù)表示。
VideoHighQualityTransmissionRate String 0.9974

視頻優(yōu)質(zhì)傳輸率，用四位小數(shù)表示。
RequestId String 2D9B00C1-1BA9-4388-9CC1-91F1A933262D

請求ID。

示例

請求示例

POST /api/quality/describeQualityDistributionStatData?StartDate=1615824000&EndDate=1615910399&StatDim=CHANNEL_ONLINE&AppId=0rbd**** HTTP/1.1
Host: vdc.cn-shenzhen.aliyuncs.com 
Date: GMT Date

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeQualityDistributionStatDataResponse>
    <code>200</code>
    <data>
        <RequestId>2D9B00C1-1BA9-4388-9CC1-91F1A933262D</RequestId>
        <QualityStatDataList>
            <AudioStuckRate>0.0049</AudioStuckRate>
            <VideoStuckRate>0.0137</VideoStuckRate>
            <JoinChannelSucRate>0.9966</JoinChannelSucRate>
            <CallDurationRatio>0.8366</CallDurationRatio>
            <VideoHighQualityTransmissionRate>0.9974</VideoHighQualityTransmissionRate>
            <JoinChannelSucFiveSecRate>0.9920</JoinChannelSucFiveSecRate>
            <VideoDelay>403</VideoDelay>
            <AudioDelay>464</AudioDelay>
            <VideoFirstPicDuration>1677</VideoFirstPicDuration>
            <AudioSpeakOutDuration>1546</AudioSpeakOutDuration>
            <AudioHighQualityTransmissionRate>0.9941</AudioHighQualityTransmissionRate>
            <Name>WiFi</Name>
        </QualityStatDataList>
        <QualityStatDataList>
            <AudioStuckRate>0.0039</AudioStuckRate>
            <VideoStuckRate>0.0166</VideoStuckRate>
            <JoinChannelSucRate>1.0000</JoinChannelSucRate>
            <CallDurationRatio>0.1399</CallDurationRatio>
            <VideoHighQualityTransmissionRate>0.9933</VideoHighQualityTransmissionRate>
            <JoinChannelSucFiveSecRate>1.0000</JoinChannelSucFiveSecRate>
            <VideoDelay>266</VideoDelay>
            <AudioDelay>311</AudioDelay>
            <VideoFirstPicDuration>1181</VideoFirstPicDuration>
            <AudioSpeakOutDuration>888</AudioSpeakOutDuration>
            <AudioHighQualityTransmissionRate>0.9898</AudioHighQualityTransmissionRate>
            <Name>UNKNOWN</Name>
        </QualityStatDataList>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>2D9B00C1-1BA9-4388-9CC1-91F1A933262D</requestId>
    <successResponse>true</successResponse>
</DescribeQualityDistributionStatDataResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "code" : "200",
  "data" : {
    "RequestId" : "2D9B00C1-1BA9-4388-9CC1-91F1A933262D",
    "QualityStatDataList" : [ {
      "AudioStuckRate" : "0.0049",
      "VideoStuckRate" : "0.0137",
      "JoinChannelSucRate" : "0.9966",
      "CallDurationRatio" : "0.8366",
      "VideoHighQualityTransmissionRate" : "0.9974",
      "JoinChannelSucFiveSecRate" : "0.9920",
      "VideoDelay" : 403,
      "AudioDelay" : 464,
      "VideoFirstPicDuration" : 1677,
      "AudioSpeakOutDuration" : 1546,
      "AudioHighQualityTransmissionRate" : "0.9941",
      "Name" : "WiFi"
    }, {
      "AudioStuckRate" : "0.0039",
      "VideoStuckRate" : "0.0166",
      "JoinChannelSucRate" : "1.0000",
      "CallDurationRatio" : "0.1399",
      "VideoHighQualityTransmissionRate" : "0.9933",
      "JoinChannelSucFiveSecRate" : "1.0000",
      "VideoDelay" : 266,
      "AudioDelay" : 311,
      "VideoFirstPicDuration" : 1181,
      "AudioSpeakOutDuration" : 888,
      "AudioHighQualityTransmissionRate" : "0.9898",
      "Name" : "UNKNOWN"
    } ]
  },
  "httpStatusCode" : "200",
  "requestId" : "2D9B00C1-1BA9-4388-9CC1-91F1A933262D",
  "successResponse" : true
}