acc5GSJC

close sendMsg cancelFullscreen seek

概述

acc5GSJC模块封装了展视互动平台的直播和点播SDK,使用此模块可实现在线课堂的直播和点播功能。

使用展视互动基本流程说明: 1.在展视互动网站( http://www.gensee.com/ )申请账号试用。

playGS

打开一个直播或点播

playGS({params},function(ret,err))

uid

  • 类型:数值型(0-100000000000)
  • 描述:自定义的uid。

domain

  • 类型:字符串
  • 描述:从展视互动申请到的域名。

account

  • 类型:字符串
  • 描述:从展视互动申请到的账号。

accountPwd

  • 类型:字符串
  • 描述:从展视互动申请到的账号密码。

room

  • 类型:数值型
  • 描述:直播或者点播的房间号。

joinPwd

  • 类型:字符串
  • 描述:用户加入房间需要的密码。

nickName

  • 类型:字符串
  • 描述:昵称。

fixedOn

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)

switchFlag

  • 类型:布尔型
  • 描述:是否可以切换摄像头和文档的显示位置,true可以切换,false不可以。
  • 默认:false。

isVod

  • 类型:布尔值
  • 描述:设置当前打开的是直播还是点播,true为点播,false为直播。
  • 默认值:false。

vrect

  • 类型:JSON 对象
  • 描述:(可选项)摄像头区域的位置及尺寸
  • 内部字段:
  • {
    • x: 0, //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    • y: 0, //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    • w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
    • h: 300 //(可选项)数字类型;模块的高度;默认:w的3/4 }

drect

  • 类型:JSON 对象
  • 描述:(可选项)文档区域的位置及尺寸
  • 内部字段:
  • {
    • x: 0, //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    • y: 0, //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    • w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
    • h: 300 //(可选项)数字类型;模块的高度;默认:w的3/4 }

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. cmd:"",//onJoin加入成功;onRosterTotal返回观看人数;didUserJoin用户加入;didUserLeave用户离开;screenStatus老师屏幕分享和摄像头切换时会调用
  3. sendMsgStatus:1,//1 信息发送成功;0 信息发送失败
  4. type:'public',//仅当type==1&&sendMsgStatus==1有聊天信息回调
  5. nickName:'',//仅当type==1&&sendMsgStatus==1有值,发言者的昵称
  6. chatId,'',//仅当type==1&&sendMsgStatus==1有值,发言id
  7. senderId,//仅当type==1&&sendMsgStatus==1有值,发言者id
  8. role,//仅当type==1&&sendMsgStatus==1有值,发言者角色
  9. msg,//仅当cmd=onRosterTotal有值,为观看人数
  10. }

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. acc5GSJC.playGS({
  3. uid: 0, //用户自定义的id,可根据自家数据库用户的id给定此值
  4. domain: "xx.gensee.com",//从展视互动申请到的域名
  5. account: "xx@xx.com",//从展视互动申请到的账号
  6. accountPwd: "pwd123456",//账号密码
  7. joinPwd: "123456",//房间密码
  8. nickName: '',昵称//
  9. fixedOn: api.frameName,//当前frame的名字
  10. switchFlag:true,//文档和摄像头互换,true为可以,false 为不可以
  11. isVod:true,//true当前是点播;false当前是直播;
  12. drect: {x:0,y:0,w:300,h:200},//文档的大小位置
  13. },function(ret,err){
  14. alert(JSON.stringify(ret));
  15. })

可用性

可提供的1.0.0及更高版本

close

关闭直播或者点播

close()

示例代码

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

changeVisible

设置视频区域和文档区域的显示与隐藏

params

type

  • 类型:字符串
  • 描述:要隐藏的区域,doc为文档区域,video为视频区域。

isShow

  • 类型:数值类型
  • 描述:显示或者隐藏,0为隐藏,1为显示。

changeVisible({params},function(ret,err))

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. acc5GSJC.changeVisible({
  3. type: 'doc',
  4. isShow: 1
  5. })

iOS系统,Android系统

可提供的1.0.0及更高版本

sendMsg

发送聊天消息。

sendMsg({params},function(ret,err))

params

content

  • 类型:字符串
  • 描述:聊天消息纯文本。

richtext

  • 类型:数值类型
  • 描述:聊天消息富文本。

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. content:'test',
  3. richtext:'<span style="color:red">test</span>'
  4. },function(ret,err){
  5. alert(JSON.stringify(ret));
  6. })

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

fullscreen

文档区域全屏显示

fullscreen()

示例代码

可用性

可提供的1.0.0及更高版本

cancelFullscreen

文档区域取消全屏

cancelFullscreen()

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. acc5GSJC.cancelFullscreen()

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setRect

设置文档或者摄像头区域的位置及大小

setRect({params})

type

  • 类型:字符串
  • 描述:要设置的区域,video为摄像头区域,doc文档区域。

rect

  • 类型:JSON 对象
  • 描述:(可选项)文档或摄像头区域的位置及尺寸
  • 内部字段:
  • {
    • x: 0, //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    • y: 0, //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    • w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
    • h: 300 //(可选项)数字类型;模块的高度;默认:w的3/4 }

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. acc5GSJC.setRect({
  3. type: 'video',//video摄像头区域,doc文档区域
  4. rect: {x:0,y:0,w:300,h:200}
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

seek

点播播放的位置

seek({params})

params

pos

  • 类型:int
  • 描述:点播播放的位置,单位为毫秒。

示例代码

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

switchDV

文档和摄像头区域互换位置大小,仅当playGS()中switchFlag==true时有效

switchDV()

示例代码

  1. var acc5GSJC=api.require('acc5GSJC');
  2. acc5GSJC.switchDV()

可用性

iOS系统,Android系统