如何进行课程的对接?
以下调用的接口都可使用欢拓 服务端API SDK 进行调用
SDK下载地址
用户观看回放流程
通过调用 Web API 接口,传入课程ID、用户唯一ID、用户昵称等参数,即可获取回放页地址,进入回放页进行观看
流程如下:
* 1、用户访问客户网站并完成登录,获取到用户的唯一ID
* 2、获取课程数据,拿到需要访问的课程ID
* 3、发送请求调用客户服务器接口进行鉴权(如检查是否登录,是否有权限观看该课程等)
* 4、如果有权限观看,则调用欢拓 Web API 的 `course.access.playback` 接口,传入课程ID、用户UID、用户昵称等参数,获取回放页地址
如果没有权限观看,提示用户没有权限
* 5、使用欢拓Web API SDK,调用Web API获取到回放页地址后,可以将该地址iframe到页面上
course.access.playback接口可传入options参数的times选项,限制回放页地址的打开次数,0为不限制,默认为0
流程图:
调用代码示例:
PHP
$MTCloud = new MTCloud
$course_id = 10621; //欢拓返回的课程ID
$uid = 2489584; //填入用户的真实唯一性ID,int、string皆可,方便做数据查询
$nickname = '用户2'; //填入用户的昵称,以在用户列表、聊天记录等需要的地方进行显示
$role = MTCloud::ROLE_USER; //用户角色
$expire = 3600;
$options = array(
'avatar'=>'http://www.talk-fun.com/3.jpg', // 用户头像地址
'times'=>0, // 不限制打开次数
);
$result = $MTCloud->courseAccessPlayback($course_id,$uid,$nickname,$role,$expire,$options);
返回
{
"code": 0,
"data": {
//access_token 用于定制页面输出页面给JS调用
"access_token": "2QzMhZmNjVmNiFjMzYWO4UmZzMmMxkzNkZzN0QGMjhDf8xXfdtlOiIHd0FmIsQjM2UDO4AzN0EjOiUWbpR3ZlJnIsIiN0UDM3UjI6ICZphnIsQDNyETM6ICZpBnIscjM2ATM6ICZp9VZzJXdvNmIsIyZuBnL05WZkVHdz9CXn1Wavw1czN2LcNXbj9FduVGZ1R3cvw1Yw9CXzVGdhxGctVGdvwVbvNmLuVnZtsGbhRnLpF2avw1LcpDc0RHaiojIyFGdhZXYiwCM6IiclRmbldmIsQjMykDO4AzN0EjOiUmcpBHelJCLyYDOxUTN6ICZp12bvJnIsICOycjM1xVM3ETO1x1bN9WTiojIl1WYut2Yp5mIsIiclNXdiojIlx2byJCLiAzMiojIklWdiwCN0ITMxojIkl2XyVmb0JXYwJye",
//直接进入回放的地址
"playbackUrl": "http://open.talk-fun.com/room.php?access_token=2QzMhZmNjVmNiFjMzYWO4UmZzMmMxkzNkZzN0QGMjhDf8xXfdtlOiIHd0FmIsQjM2UDO4AzN0EjOiUWbpR3ZlJnIsIiN0UDM3UjI6ICZphnIsQDNyETM6ICZpBnIscjM2ATM6ICZp9VZzJXdvNmIsIyZuBnL05WZkVHdz9CXn1Wavw1czN2LcNXbj9FduVGZ1R3cvw1Yw9CXzVGdhxGctVGdvwVbvNmLuVnZtsGbhRnLpF2avw1LcpDc0RHaiojIyFGdhZXYiwCM6IiclRmbldmIsQjMykDO4AzN0EjOiUmcpBHelJCLyYDOxUTN6ICZp12bvJnIsICOycjM1xVM3ETO1x1bN9WTiojIl1WYut2Yp5mIsIiclNXdiojIlx2byJCLiAzMiojIklWdiwCN0ITMxojIkl2XyVmb0JXYwJye"
}
}
iframe示例代码
- 请在页面中插入如下代码,并且把
${playbackUrl}
替换为直播间地址 如何获取 playbackUrl 地址?
<iframe id="talkfun_frame" src="${playbackUrl}" border="0" style="position:absolute; top: 0; left: 0; width=100%; height: 100%; overflow: hidden; margin: 0; padding: 0;"></iframe>
- 注意事项:
移动端请在head标签部分添加如下代码:
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />