查询直播信息

api名称:course.get,SDK对应方法courseGet

应用参数说明:
名称 类型 必选 描述
course_id int Y 直播id
expire int Y 返回的回放地址的过期时间,单位秒。默认 86400 秒
options object N 附加参数
getsize 是否获取回放大小:0 否,1 是
返回data参数说明:
名称 类型 描述
course_id int 直播id
partner_id int 合作方id
course_name string 直播名
bid int 欢拓系统的主播id
start_time int 直播设置开始时间,时间戳,精确到秒,下同
end_time int 直播设置结束时间
add_time int 直播创建时间
status int 状态: 0 正常,-1 已删除
live_stime int 直播开始时间
live_etime int 直播结束时间
duration int 时长(秒)
chatTotal int 聊天总数
zhubo_key string 主播登录秘钥
admin_key string 管理员登录秘钥
user_key string 观众登录秘钥
lotteryTotal int 抽奖总数
livePv int 直播观看次数
pbPv int 回放观看次数
liveUv int 直播观看人数
liveUvPeak int 最高并发数
pbUv int 回放观看人数
zhubo object 主播信息
liveStatus int 直播状态:1 未开始;2 正在直播;3 已结束
robotTotal int 机器人数量
playback int 是否生成回放,0为未生成,1为已生成
videoThumb string 回放视频缩略图
playbackUrl string 回放地址
filesize int 回放大小(如果传了getsize)
scenes int 直播类型。1: 教育直播,2: 生活直播
goodsList object 商品列表,scenes为2时返回
watchUrl string 观众地址,scenes为2时返回
loginUrl string 登录地址,scenes为2时返回
thumb string 封面图
liveCartClicks int 直播时购物车点击数
playbackCartClicks int 回放时购物车点击数
fakelive int 是否为伪直播。0:否,1:是
zhubo参数说明:
名称 类型 描述
bid string 欢拓系统的主播id
partner_id string 合作方id
thirdAccount string 发起直播直播的合作方主播唯一账号或ID
nickname string 主播昵称
intro string 主播介绍
p_150 string 主播缩略图150x150
p_40 string 主播缩略图40x40
goodsList参数说明:
名称 类型 描述
name string 商品名称
img string 商品图片地址
price float 商品现价
originalPrice float 商品原价
tab int 商品标签(特价:1, 限时:2, 新品:3, 钜惠:4, 秒杀:5)
url string 商品链接
putaway int 商品状态 0下架,1上架,2推荐

直播列表(将返回开始时间在区间内的直播)

api名称:course.list,SDK对应方法:courseList

应用参数说明
名称 类型 必选 描述
start_time string N 开始时间区间,格式: 2015-01-01 12:00:00,传空时返回最新创建的课程
end_time string N 开始时间区间,格式: 2015-01-01 12:00:00,配合start_time使用,start_time不为空时必选
page int N 页码,默认为1。最大值为 9999
size int N 每页数量,默认为10。最大值为 999
options object N 可选参数
status 直播状态:0 为正常状态,-1 为已删除
expire 回放地址有效期:设置返回的回放地址的有效时长,单位秒
getsize 是否获取回放大小:0 否,1 是
departmentId 部门id:只获取某部门的直播
account 主播帐号;accountType 主播帐号类型:1 为欢拓主播帐号(欢拓后台的主播ID,或各个接口中返回的bid字段),2 为接入方主播帐号;account与accountType条件需要同时传入。
course_ids 直播列表:字符串格式: '1,2,3';数组格式: [1,2,3]。
scenes 直播类型:1 教育直播,2 生活直播

当start_time不为空时,查询结果有缓存,要实时获取最新创建的记录,请将start_time留空,传空字符串'',或0

返回data参数说明:
名称 类型 描述
course_id int 直播id
partner_id int 合作方id
course_name string 直播名
start_time int 直播设置开始时间
end_time int 直播设置结束时间
add_time int 直播创建时间
live_stime int 直播实际开始时间
live_etime int 直播结束结束时间
duration int 时长(秒)
status int 状态 0正常,-1已删除
bid int 欢拓系统的主播id
chatTotal int 聊天总数
zhubo_key string 主播登录秘钥
admin_key string 助教登录秘钥
user_key string 学生登录秘钥
lotteryTotal int 抽奖总数
livePv int 直播观看次数
pbPv int 回放观看次数
liveUv int 直播观看人数
liveUvPeak int 最高并发数
pbUv int 回放观看人数
liveStatus int 直播状态:1 未开始;2 正在直播;3 已结束
playback int 是否生成回放,0为未生成,1为已生成
videoThumb string 回放视频缩略图
playbackUrl string 回放地址
filesize int 回放大小(如果传了getsize)
scenes int 直播类型。1: 教育直播,2: 生活直播
thumb string 封面图
p_40 string 头像链接 40*40
p_150 string 头像链接 150*150
robotTotal int 虚拟用户数量
liveCartClicks int 直播时购物车点击数
playbackCartClicks int 回放时购物车点击数
fakelive int 是否为伪直播。0:否,1:是

获取生活直播相关配置

api名称:course.getLifeConfig,SDK对应方法:getLifeConfig

  • 应用参数说明:
名称 类型 必须 描述
course_id string Y 直播id
options array N 传对应模块获取相关配置(可以多个)
pageViewMode 界面模式
background 直播间背景图
intro 直播引导图
banner 广告条
focus 关注按钮
number 观看人数开关
invitationList 邀请榜单开关
countDown 直播倒计时开关
store 商城
service 客服私聊开关
reward 打赏主播开关
inviteRanking 邀请观看开关
redPack 发红包开关
like 点赞开关
more 更多入口
menu 菜单入口开关
chatTime 聊天时间开关
entranceTips 入场提示开关
menuList 菜单设置
goodsList 商品列表
share 分享设置
popUp 弹窗列表
ad 浮动广告开关
adlist 浮动广告

返回data参数

名称 类型 描述
pageViewMode string 界面模式 1全屏模式 0二分屏
background array 直播间背景图,background.enable 是否开启,0未开启 1开启;background.url直播间背景图
intro array 直播引导图,intro.url引导图链接
banner array 广告条,banner.enable是否选择开启,0未选择 1选择;banner.data广告条数组;banner.data.type 类型1链接地址 2拨打电话;banner.data.tel 电话;banner.data.link 链接地址;banner.data.imgurl 手机端广告图链接地址;banner.data.pcImgurl pc端广告图链接地址
focus array 关注按钮;focus.enable 是否选择 0否 1是;focus.data.popUp 进入直播间自动弹出公众号二维码 0否 1是;focus.data.url 公众号二维码
number array 观看人数;number.enable 是否开启 观看人数 0否 1是
invitationList array 邀请榜单开关,invitationList.enable 是否开启 0否 1是
countDown array 直播倒计时开关;countDown.enable 是否开启 0否 1是
store array 商城; store.enable是否开启 0未开启 1开启,store.type 1商品列表,2商城链接,3商城二维码;store.data.url 存储商城链接;store.data.qrcode 商城二维码
service array 客服私聊开关 ;service.enable 0否 1是;示例:{"enable":"1"}
reward array 打赏主播开关;reward.enable 是否开启 0否 1是
inviteRanking array 邀请观看开关;inviteRanking.enable 是否开启 0否 1是
redPack array 发红包开关;redPack.enable 是否开启 0否 1是
like array 点赞开关;like.enable 0否 1是
more array 更多入口;more.data.redPackRecord 红包记录开关 0否 1是;more.data.withdraw 提现开关 0否 1是;more.data.store 商城入口开关,more.data.store.enable 是否开启 0否 1是,more.data.store.url 商城入口链接;more.data.info 个人中心开关 0否 1是;more.data.liveLine 切换线路开关 0否 1是;more.data.report 举报开关 0否 1是
menu array 菜单入口开关,menu.enable 是否开启 0否 1是
chatTime array 聊天时间开关;chatTime.enable 是否开启 0否 1是
entranceTips array 入场提示开关;entranceTips.enable 是否开启 0否 1是
menuList array 菜单设置;字段: title, type, content。分别表示: 菜单名称, 菜单类型,自定义图文内容;菜单类型分为 chat聊天 editor自定义图文 invite邀请榜单 courseware课件
goodsList array 商品列表。字段: name, img, price, originalPrice, tab, url, putaway,pay,qrcode。分别表示: 商品名称, 商品图片地址, 商品现价, 商品原价, 商品标签(特价:1, 限时:2, 新品:3, 钜惠:4, 秒杀:5), 商品链接, 商品状态:0下架,1上架,2推荐, 购买模式(1,链接购买 2,二维码购买), 商品二维码
share array 分享设置;share.title 分享标题设置,share.title.type 标题类型 1默认当场直播名称 2固定标题, share.title.value 固定标题值;share.description.value 描述;share.img.value 图标url
popUp array 弹窗列表;字段uuid,img, title, url, type, duration。分别表示:弹窗唯id, 广告图链接, 主题, 链接地址, 推送类型 1手动推送 2进入直播间时推送, duration:展示时长
ad array 浮动广告开关(只能在全屏模式下使用),ad.enable 0未开启 1开启
adlist array 浮动广告;字段img, position.top, position.left, scale, link 分别表示:广告图,居上(%),居左(%),大小(%);
Copyright Talkfun all right reserved,powered by Gitbook修订时间: 2021-09-08 14:13:22

results matching ""

    No results matching ""