调用GetLiveRoomStatistics查询与指定直播相关的数据统计信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetLiveRoomStatistics

系统规定参数。取值:GetLiveRoomStatistics

AppId String 7m***q

用户的应用ID,在控制台创建应用时生成。包含小写字母、数字,长度为6个字符。

LiveId String b7f2****ebb3

直播资源的唯一标识ID。

返回数据

名称 类型 示例值 描述
RequestId String FE22D613-D3C6-4A58-87CA-F21FC85AA08E

请求ID。

Result Object

查询直播统计数据返回的结果。

LiveId String b7f2****ebb3

直播资源的唯一标识ID。

Status Integer 1

直播状态。取值:

  • 0:已创建,未开始直播。
  • 1:直播中。
  • 2:直播结束。
Uv Long 100

访问用户数,同个访客多次访问直播间仅计算一个UV。

Pv Long 200

访问用户人次,访客对同一直播间的多次访问,PV累加。

MessageCount Long 500

互动消息数。

StartTime Long 1624259500000

直播开始时间,单位:毫秒。

EndTime Long 1624259500000

直播结束时间,单位:毫秒。直播结束后生成。

WatchLiveTime Long 10000000

所有用户总观看时长,单位:毫秒。直播结束后生成。

LikeCount Long 100

点赞数。

OnlineCount Long 50

在线用户数。

示例

请求示例

http(s)://[Endpoint]/?Action=GetLiveRoomStatistics
&AppId=7m***q
&LiveId=b7f2****ebb3
&公共请求参数

正常返回示例

XML格式

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

<GetLiveRoomStatisticsResponse>
    <RequestId>FE22D613-D3C6-4A58-87CA-F21FC85AA08E</RequestId>
    <Result>
        <LiveId>b7f2****ebb3</LiveId>
        <Status>1</Status>
        <Uv>100</Uv>
        <Pv>200</Pv>
        <MessageCount>500</MessageCount>
        <StartTime>1624259500000</StartTime>
        <EndTime>1624259500000</EndTime>
        <WatchLiveTime>10000000</WatchLiveTime>
        <LikeCount>100</LikeCount>
        <OnlineCount>50</OnlineCount>
    </Result>
</GetLiveRoomStatisticsResponse>

JSON格式

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

{
  "RequestId" : "FE22D613-D3C6-4A58-87CA-F21FC85AA08E",
  "Result" : {
    "LiveId" : "b7f2****ebb3",
    "Status" : 1,
    "Uv" : 100,
    "Pv" : 200,
    "MessageCount" : 500,
    "StartTime" : 1624259500000,
    "EndTime" : 1624259500000,
    "WatchLiveTime" : 10000000,
    "LikeCount" : 100,
    "OnlineCount" : 50
  }
}

错误码

访问错误中心查看更多错误码。