# wx.getChannelsLiveInfo(Object object)

基础库 2.15.0 开始支持,低版本需做兼容处理

Promise 风格 调用:不支持

小程序插件:不支持

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

相关文档: 视频号直播

# 功能描述

获取视频号直播信息

# 参数

# Object object

属性 类型 默认值 必填 说明 最低版本
finderUserName string 视频号 id,以“sph”开头的id,可在视频号助手获取
startTime number 起始时间,筛选指定时间段的直播。若上传了endTime,未上传startTime,则startTime默认为0 2.29.0
endTime number 结束时间,筛选指定时间段的直播。若上传了startTime,未上传endTime,则endTime默认取当前时间 2.29.0
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# object.success 回调函数

# 参数
# Object res
属性 类型 说明 最低版本
feedId string 直播 feedId
nonceId string 直播 nonceId
description string 直播主题
status number 直播状态
合法值 说明
1 直播状态不存在(针对未开过直播的主播)
2 直播中
3 直播已结束
4 直播准备中(未开播)
headUrl string 视频号头像
nickname string 视频号昵称
replayStatus string 直播回放状态 2.29.0
合法值 说明
0 未生成
1 已生成
3 生成中
6 已过期
otherInfos Array 除最近的一条直播外,其他的直播列表(注意:每次最多返回按时间戳增序排列的15个直播信息,其中时间最近的那个直播会在接口其他的返回参数中展示,其余的直播会在该字段中展示)。 2.29.0

# 常见错误码说明

100008 视频号需要认证 40097 入参异常 1416104 视频号获取到的数据为空 1416100 非法的视频号id