用户授权

进入直播api名称:course.access,SDK对应的方法:courseAccess(或courseAccessUrl,无需请求授权接口,返回直播间地址URL)

进入回放api名称:course.access.playback,SDK对应方法:courseAccessPlayback(或courseAccessPlaybackUrl,无需请求授权接口,返回回放地址URL)

注意:直播和回放的授权接口是分开的,不能用直播的地址或access_token进入回放,反之也不行

请正确判断课程状态,再调用不同的接口。因为每次上下课都有回调,中途下课或生成回放的回调不能作为课程结束依据,是否结束判断请加上课程预设的时间。如果是用课程信息判断,可以判断liveStatus字段

  • 应用参数说明:
名称 类型 必选 描述
course_id int Y 课程ID
uid String Y 接入方用户唯一ID。uid只能包含字母、数字、_、-、*、:,最长32位
nickname String Y 用户昵称
role String Y 用户身份(user/admin/guest/watch,分别对应普通用户/管理员(助教)/游客(不参与抽奖活动)/直播监课)
expire int N 有效期,默认:3600(单位:秒),最小值为 3600s,最大值为 7d (建议客户至少设置1小时的缓存,避免相同用户在短时间内重复获取直播间鉴权参数,造成接口调用频率达到上限)
options Object N 其它可选项
gender:性别(1为男性,2为女性)
avatar:头像链接地址(默认头像可不传,由欢拓来配置);
gid:用户分组ID,范围 0-255,默认为0,表示不分组;不同分组的用户之间互相隔离(包括管理员),看不到对方的聊天及在线情况
ssl:是否使用https(true为使用,false为不使用);
times:限制授权链接或token打开次数,为大于0数字,仅回放可用;默认0,为不限制
miniprogramAppid:小程序ID,用来确定小程序的业务域名

options示例:{"gender":1,"avatar":"http://www.talk-fun.com/avatar.jpg","gid":1}

分组是直播时多个助教分别管理和自己分组相同的学员时用,如果没有分开管理,请不要传或传0

  • 返回data参数说明:
名称 类型 描述
playbackUrl string 回放地址
liveUrl string 直播地址
liveVideoUrl string 直播视频外链地址
access_token string 用户的access_token
playbackOutUrl string 回放纯视频播放地址
miniprogramUrl string 小程序web-view的直播或回放地址(未传miniprogramAppid参数时返回默认域名的直播或回放地址)
Copyright Talkfun all right reserved,powered by Gitbook修订时间: 2024-04-22 14:58:33

results matching ""

    No results matching ""