用户授权
进入直播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/spadmin,分别对应普通用户/管理员(助教)/游客(不参与抽奖活动)/直播监课/管理员) |
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参数时返回默认域名的直播或回放地址) |
adminMiniUrl | string | 手机端管理地址(role角色spadmin时返回) |