分析用户行为时，您可能会需要查看用户观看时长的分布情况。AnalysisUserBehaviorPeople 接口支持指定直播状态 PlayStatus，获取观看时长超过百分比 Percentage 阈值的观众数量。获取直播间用户观看时长人数分布。
说明
该接口已经不再维护，建议调用 AnalysisUserBehaviorPeopleV2 接口获取直播间不同观看时长的人数。
以下请求参数列表仅列出了该接口的部分公共参数，完整公共参数列表见公共请求参数。
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 接口名称 |
| Version | String | 是 | 接口版本。直播当前 API 的版本为 2020-06-01。 |
| ActivityID | Int64 | 是 | 直播间 ID |
PlayStatus | Int32 | 是 | 根据直播状态进行筛选。支持以下取值。
例如，取值为 |
StartTime | Int64 | 否 | 查询范围的开始时间，Unix 时间戳，单位为秒。 |
EndTime | Int64 | 否 | 查询范围的结束时间，Unix 时间戳，单位为秒。 |
TotalTime | Int64 | 否 | 总时长，作为观看时长占比
例如，A 直播从 12:00 开始推流，14:00 结束推流；其中，前 30 分钟播放预告片，之后 90 分钟为直播时间，则可以将 |
Percentage | Int64 | 是 | 观看时长占总时长的百分比，取值范围为 (0,100]。 |
Source | Int32 | 否 | 根据页面访问来源进行筛选。支持以下六种取值，默认取值为
|
| Extra | String | 否 | 业务方扩展字段，可根据该字段进行筛选。自定义登录时，用户行为中记录了 extra 值。 |
IsMerge | Int32 | 否 | 是否根据设备（Cookie）筛选。 说明
|
IsMergeUserId | Int32 | 否 | 是否根据 userID 筛选，没有 userID 的根据设备（Cookie）进行筛选。 说明
|
| 参数 | 类型 | 描述 |
|---|---|---|
| TotalPeople | Int64 | 总人数 |
| TotalTime | Int64 | 总时间 |
| AnalysisPeople | Int64 | 实际观看时长占总时长的百分比大于等于Percentage 的人数。 |
Get http://livesaas.volcengineapi.com/?Action=AnalysisUserBehaviorPeople&Version=2020-06-01&ActivityID=1231231231&PlayStatus=1&StartTime=1652895802&EndTime=1652895802&Percentage=50&TotalTime=5400&Source=-1&IsMerge=1
{
"ResponseMetadata":{
"RequestId":"202201201826170101501312091D1C09D2",
"Action":"AnalysisUserBehaviorPeople",
"Version":"2020-06-01",
"Service":"livesaas",
"Region":"cn-north-1",
"SystemTime":1656067132
},
"Result":{
"TotalPeople": 123,
"TotalTime": 1234,
"AnalysisPeople": 12
}
}
{
"ResponseMetadata":{
"RequestId" :"202201201826170101501312091D1C09D2",
"Action":"AnalysisUserBehaviorPeople",
"Version":"2020-06-01",
"Service":"livesaas",
"Region":"cn-north-1",
"SystemTime":1656067132,
},
"Error":{
"Code":"200000",
"Message":"参数异常"
}
}
访问公共错误码获取详细信息。