• 首页
  • 教育培训
    • 双师课堂
    • 直播网校
    • 大班课堂
    • 小班课堂
  • 互动直播
    • 财经直播
    • 网络互动直播
    • 企业培训
    • 年会直播
    • 移动直播
    • 营销直播
    • 网络研讨会
    • 网络市场活动
    • 企业级网络会议
  • 关于我们
    • 公司新闻
    • 关于我们
    • 荣誉资质
    • 联系我们
    • 人才招聘
  • 帮助与下载
    • 工具下载
    • app下载
    • 视频教程
    • FAQ
    • 开发者
    • 开发文档(新)
    • 功能说明
    • SDK下载
  • 销售热线:4006-010-263
  • 免费试用
English
  • 接口使用指引
  • Web接口开发指南
    • Webcast API接口
      • Webcast Json API
      • Webcast URL API
    • Training API接口
      • Training Json API
      • Training URL API
    • Web Flash SDK
      • 直播 SDK
      • 点播 SDK
    • Web H5 SDK
      • 桌面端点播SDK
      • 移动端点播SDK
      • 移动端直播SDK
      • 桌面端直播SDK
  • 实时系统回调接口
  • APP SDK开发指南
    • SDK 快速选择指南
    • Ios 接口开发
      • IOS-VOD SDK
      • IOS-RT SDK
      • IOS-Player SDK
      • IOS-Fast SDK
    • Android 接口开发
      • Android 接口FAQ
      • Android -VOD SDK
      • Android -RT SDK
      • Android-Player SDK
      • Android-Fast SDK
  • 微信小程序接口
    • 微信小程序 SDK
      • 微信小程序 点播SDK
      • 微信小程序 直播SDK

桌面端点播SDK

1文档介绍

1.1文档目的

众多客户希望能拥有更多的点播播放器设计能力,特别是对于拥有UI, 开发人员资源的公司。为此,特提供点播web端播放器集成SDK,以便客户可以针对自己的业务场景设计最符合自己业务场景的点播播放器。

1.2术语与缩写解释

编号

术语

解释

  1.  

SDK

Software Development Kit

  1.  

Widget

部件,能展现特定功能的html片段。目前仅提供视频部件和文档部件

  1.  

Webcast服务

Gensee提供的直播服务,见http://www.gensee.com/live.html

  1.  

Training服务

Gensee提供的教育培训服务,见http://www.gensee.com/education-training.html

  1.  

 

 

  1.  

 

 

  1.  

 

 

  1.  

 

 

  1.  

 

 

 

2SDK使用介绍

2.1需要引入的javascript

<script type="text/javascript" src="http://static.gensee.com/webcast/static/sdk/js/gssdk-1.3.js"></script>

注意:如果直接引用,在sdk内容更新时可能存在未下载最新sdk而使用浏览器中缓存的版本,在用户不清空缓存时会存在代码不一致导致异常的报错。建议对sdk添加时间戳,保证gssdk-1.3.js引入时是服务器最新版本。
例:
<script type="text/javascript">
(function(){ 
     var randomh=Math.random();
     var e = document.getElementsByTagName("script")[0];
     var d = document.createElement("script");
     d.src = "//site.com/js.js©x="+randomh+"";
     d.type = "text/javascript"; 
     d.async = true;
     d.defer = true;
     e.parentNode.insertBefore(d,e);
 })();
document.write("<script type='text/javascript' src='//static.gensee.com/webcast/static/sdk/js/gssdk-1.3.js©v=" + Date.now() + "'><\/script>");
</script>

2.2Html命名空间

<html xmlns:gs="http://www.gensee.com/ec">

 

2.3Vod Video Widget (必选)

 

注意:一场点播在一个页面上请保证只有一个Vod Video Widget!

 

网页html的body内,任意地方可以插入如下代码:

 

<gs:video-vod id="videoComponent" site="192.168.0.168"  ctx="webcast" ownerid="f8625298d18042fbbba7a8" uid="55831" uname="user5623" authcode="333333"/>

 

属性说明:

  • Id: html的元素ID。(可选)用户可自行指定。SDK将以此ID作为Widget ID。
  • ctx: 服务选项。可选值为webcast或training。无此属性说明默认使用webcast服务。
  • site:  站点域名 (必填)Example:www.gensee.com
  • ownerid: webcast服务下,表示点播ID ;training服务下,表示课件ID(必填)
  • uid: 用户ID (可选)。若无此属性,系统会自动生成随机UID。为了避免uid跟Gensee系统的内部用户ID冲突,该uid要求必须大于1000000000 小于9007199254740992
  • uname: 用户名称(可选)。若无此属性,系统自动生成英文随机名称。若点播(课件)要求登录,则用户名称必须是系统的登录账号。注:登录方式无论是账号密码或手机动态密码,接口只能使用账户登录。
  • authcode: (可选)校验码。对应点播(课件)的web端口令。若点播(课件)要求输入口令,则此属性必填。否则不需要。
  • encodetype: 指定authcode的编码方式。值若为md5,则authcode必须经过MD5的32位小写编码过。不写该属性或者值为空,则authcode为明文。
  • password: (可选)若点播(课件)要求登录,此属性表示登录账号的密码。
  • group: 分组名称。(可选) 适用于不同点播(课件)的Widget放在同一个页面中的情况。Group用来标示哪些Video和Doc Widget属于同一个组。相同组内的Widget可以共享通讯信息。若不填,SDK会自动将Widget归属到默认组。
  • k: 若直播开启第三方认证功能,则需要k值验证。关于第三方认证,请参看Gensee_URL_API_SPEC。
  • lang: 指定语言。中文是zh_CN, 英文是 en,日文是ja。
  • bar: 指定是否显示控制栏,值为true或者false。注意:该值得设置只对PCWebFlash播放器生效。
  • bgimg: 设置背景图案,图片URL地址。
  • py: 设置点播是否自动播放,值为1或者0。1表示自动播放,0则表示手动播放
  • btnimg:设置播放按钮图案,图片url地址。注意:该值得设置只对H5播放器生效。
  • fullscreen:是否在flash视频界面上显示全屏操作按钮。可选值为true或者false。默认值为false。(可选)
  • gsver:采用何种技术的播放器(H5 Flash)。可选值为2或者其他。默认值为空(即Flash播放器)
  • post  k值认证方式,get请求或post请求。可选值为true或者false。默认值为true。(可选)

 

2.4Doc Widget(可选)

网页html的body内,任意地方可以插入如下代码:

 

<gs:doc id="docComponent"  ctx="webcast"  site="192.168.0.168" ownerid=" f8625298d18042fbbba7a8" />

 

属性说明:

  • Id: html的element id。(可选)
  • site: 站点域名(必填)
  • ownerid:  点播或课件ID。(必填)
  • group: 分组名称。作用同Video Widget的Group属性。(可选)
  • ctx: 服务选项。可选值为webcast或training。无此属性说明默认使用webcast服务。(可选)
  • fullscreen:是否支持flash全屏。可选值为true或者false。默认值为false。(可选)
  • bgcolor: 背景色。参考值:#00ff00。默认为空。(可选)
  • bgimg: 设置背景图案,图片URL地址。

2.5Channel (可选)

Channel是SDK提供的基于组(group)的数据通讯通道。相同组(group)的Widget和Channel共享通讯方式和数据。

通讯分两种形式:

  • 监听事件
  • 提交数据

根据不同类型,把对应的API罗列在下文中。事件API,见第四章节;提交API,见第五章节。

所有事件的参数都是一个js对象,方便内部以JSON格式传递。

用户可以根据需求决定是否使用Channel。

通过如下js代码可以创建Channel:

 

GS.createChannel(groupName);

 

2.6样例代码

<!DOCTYPE html>

<html xmlns:gs="http://www.gensee.com/ec">

<head>

    <meta charset="utf-8"/>

    <title>Example Page</title>

    <script type="text/javascript" src="http://static.gensee.com/webcast/static/sdk/js/gssdk.js"></script>

    <link href="http://static.gensee.com/webcast/static/sdk/css/bootstrap.css" type="text/css" rel="stylesheet">

    <style type="text/css">

        .videoDiv {

            height: 400px;

        }

 

        .docDiv {

            height: 198px;

            padding: 1px;

        }

    </style>

    <script type="text/javascript">

        //1. 根据组获得通讯通道

        var channel = GS.createChannel("testgroup");

        //2. 通过通道监听互动调查事件

        channel.bind("onVote", function (event) {

            alert(event.data);

        });

        //2. 通过通道监听问答事件

        channel.bind("onQA", function (event) {

            alert(event.data.question);

        });

        //3.通过通道留言

        channel.send("submitLeaveMessage", {

            "content": "what's your name?"

        });

    </script>

</head>

<body>

<h2 align="center">Test Page</h2><br>

 

<div class="container">

    <div class="row-fluid">

        <div class="span6 videoDiv">

            <!-- Video Widget -->

            <gs:video-vod site="www.gensee.com" ownerid="f8625298d18042fbbba7a8d4f75555ca"

                           uid="55831" uname="user5623" authcode="333333" group="testgroup"/>

        </div>

        <div class="span6">

            <div class="docDiv">

                <!-- Doc Widget -->

                <gs:doc site="www.gensee.com" ownerid="f8625298d18042fbbba7a8d4f75555ca" group="testgroup"/>

            </div>

        </div>

    </div>

</div>

</body>

</html>

 

2.7Widget加载错误提示

有时候,由于用户在使用widget时,填入了错误参数,会导致widget加载失败。以下罗列所有的失败提示:

  • param_error:必填参数未填写
  • login_fail:要求登录,登录失败
  • not_assign:点播未与该用户关联,该用户不能观看
  • auth_fail:口令错误或第三方认证失败
  • not_found:点播不存在
  • service_disabled:服务(点播,教育培训等)已禁止
  • required_client_join:要求使用客户端,web端不可用
  • ipad_not_support:当前不支持移动平台
  • api_disabled:SDK功能未开启

2.8调试工具

Gensee为每个客户(Site)均提供了独立的点播服务Web Player SDK调试页面,以辅助客户(Site)的开发人员调试点播服务SDK接口。

测试页面的URL规则如下:

  • http://{站点域名}/sdk/site/test/vod?ownerid={点播ID}&authcode={观看口令}&ctx={可选值为webcast或training。无此属性说明默认使用webcast服务}&gsver={可选值为2或者其他。无此属性说明默认使用SDK1.0版本}

URL格式范例:

  • http://test.gensee.com/sdk/site/test/vod?ownerid=abcd&authcode=123456&gsver=2

工具截图

image1

2.9DEMO与源码

为了方便客户方开发人员快速实现页面播放器的开发,我们提供了完全基于SDK接口制作的网页DEMO播放器,并开放所有源码。

点击此处,下载DEMO播放器与源码

DEMO源码的使用:

替换site="product.gensee.com"里的值为自己站点的域名

替换ownerid="qnYvtuDg1R"为当前直播的sdk id

如果设置密码请设置authcode=""的值为点播密码

最后添加属性gsver="2"

DEMO播放器功能:

DEMO播放器中包括大部分的点播功能(并非全部),如需DEMO未包括的功能,仍然需要开发人员阅读本文档中的接口说明自行开发。

模块分类

功能项

状态

标题

音视频

音量

自动播放

暂停&恢复播放

文档

--

聊天

聊天记录

问答

问答记录

问卷

接收及提交问卷

接收问卷统计结果

章节

序号、标题、播放时间


 

3监听事件API

注意:所有事件触发,将收到event对象。其中data属性即数据参数。本文档中均以json格式来表达数据参数

 

3.1onDocChange

事件说明:文档翻页

参数:

{

"width" : 800,

"height" : 600,

"ppt" : [true|false],

"doc" : "测试文档",

"title" : "第一页",

"timestamp" : 200

}

参数

说明

width

页宽

height

页高

ppt

是否是ppt类型

doc

文档主题

title

页标题

timestamp

事件触发时间(毫秒)该属性移动平台暂时没有

3.2onChapter

事件说明:章节信息

参数:

{list:[{

“titile” : ”第一页”,

“doc” : ”测试文档”,

“starttimestamp” : 20242,

“stoptimestamp” : 100215,

"img" : "http://static.gensee.com/webcast/sdk/.......png"

}

]}

参数

说明

doc

文档主题

title

页标题

starttimestamp

开始播放时间单位为毫秒

stoptimestamp

结束播放时间单位为毫秒

img

文档图片地址

3.3onDataReady

事件说明:SDK加载完毕,所有API生效 。同时通知第三方开发人员某些功能模块的配置项初始值。

参数:

{

       "supportChatSync" : [ true | false ]

}

参数

说明

supportChatSync

该点播是否支持公聊数据的同步播放功能。

true – 支持

false – 不支持

supportH5

该点播是否支持采用H5播放器播放。  true 支持 , false 不支持

 

 

 

3.4onVideoConfig

事件说明:视频配置更改通知

参数:

{

"hasVideo" : [true|false],

"width" : 320,

"height" : 240,

"type" : ["video"|"share"]

}

参数

说明

hasVideo

是否有视频数据, true 或者 false

width

流宽度

height

流高度

type

video – 当前Video Widget显示视频流;

share start – Video Widget显示共享流;

share stop – Video Widget 停止显示共享流

 

3.5onQAList

事件说明:监听事件,初始化后并不会马上返回任何数据。只有当提交submitQAList后,监听事件才会收到聊天数据,默认200条。如果需要加载更多记录,请参考more参数用法。

参数:

{

   "more" : true,

"list" : [

{

"id" : "abcd-efg-hi",

"question" : "how are you?",

"submitor" : "Tom",

"answer" : "fine, thank you.",

"answerBy" : "Jack",

"submitTime" : 9654123,

"answerTime" : 8795623,

"submitorId" : "111111",

"answererId" : "22222"

},

{

"id" : "abcd-efg-hi",

"question" : "how are you?",

"submitor" : "Tom",

"answer" : "fine, thank you.",

"answerBy" : "Jack",

"submitTime" : 9654123,

"answerTime" : 8795623,

"submitorId" : "111111",

"answererId" : "22222"

}

]

}

参数

说明

list

问答列表,列表中每个对象都是问答对象。

id

问答UUID

question

问题

submitor

提问者名称

answer

回复

answerBy

回复者名称

submitTime

提问时间,单位毫秒

answerTime

回复时间,单位毫秒

submitorId

提问者用户ID

answererId

回答者用户ID

more

false – 说明后续没有Q&A数据

true – 说明后续还有Q&A数据,可以再次调用submitQAList以获取下一批200条聊天数据。

 

 

 

3.6onTextWebcast

事件说明:文字直播历史记录

参数:

{

list : [

{

time : 1526,

content : "content",

lang : "zh_cn"

}

]

}

 

参数

说明

time

文字提交的时间,单位毫秒

content

文字直播内容

lang

所属语言

 

 

3.7onLottery

事件说明:抽奖

参数:

{

"action" : ["start"|"stop"|"abort"],

"user" : "Tom"

}

参数

说明

action

start 开始抽奖

stop 抽奖结束

abort 抽奖中途终止

user

当抽奖结束时候,告诉中奖用户名称

3.8onModuleFocus

事件说明:web端布局控制

参数:

{

"focus" : ["0" | "1" | "2" | "3"]

}

参数

说明

focus

0 -- 文档为主 ;

1 -- 视频最大化;

2 -- 文档最大化;

3 -- 视频为主

 

3.9loadStart

事件说明:初始化点播,点播开始

参数:

{

}

参数

说明

 

 

 

3.10onPause

事件说明:提交pause请求后的异步回调事件

参数:

{

"timestamp" : 200

 

}

参数

说明

timestamp

暂停时候的时间点,单位毫秒

 

3.11onPlay

事件说明:视频进入播放状态触发该事件

参数:

{

"timestamp" : 200

 

}

参数

说明

timestamp

点播恢复时候的时间点,单位毫秒。

 

3.12onStop

事件说明:播放结束

参数:

{

}

参数

说明

 

 

3.13onSeekCompleted

事件说明:跳转结束

参数:

{

"timestamp" : 200

"moreChat" : [true|false]

}

参数

说明

timestamp

最终跳转到的时间点。由于关键帧的原因,最终的跳转时间点不一定跟指定的跳转时间点相同。关键帧的原理请百度或者google。

moreChat

是否有更多聊天

3.14onPlayheadTime

事件说明:提交playheadTime请求后的异步回调事件

参数:

{

"playheadTime" : 200,

"downloadProgress" : [0-100]

}

参数

说明

playheadTime

点播当前播放的时间点,单位毫秒。

downloadProgress

点播当前下载百分比(该属性仅支持PCWebFlash播放器,H5不支持)

3.15onFileDuration

事件说明:收到点播文件的总时长

参数:

{

"duration" : 23400

}

参数

说明

duration

点播当前文件总时长,单位毫秒

 

3.16onVote

事件说明:收到调查问卷

参数:

{

    "id" : "abcd-efg-hi",

    "skip" : ["true" | "false"],

    "subject" : "test vote",

    "questions" : [

        {

            "id" : "uuid",

            "subject" : "first question",

            "type" : ["single"|"multi"|"text"],

            "answer" : "1,3",

               "text" : ""

            "items" : [

                {

                    "id" : "uuid",

                    "correct" : ["true" | "false"],

                    "option" : "answer1",

               "selected" : ["true" | "false"]

                },

                {

                    "id" : "uuid",

                    "correct" : ["true" | "false"],

                    "option" : "answer2",

                "selected" : ["true" | "false"]

                }

            ]

        }

    ]

}

参数

说明

id

投票ID; 问题ID;选项(答案)ID

skip

false表明是强制投票

subject

投票主题;问题

questions

问题列表

type

single 单选题

multi 多选题

text 文字题

answer

Single或者multi类型时候,表明哪些选项是正确答案。多选时候,用数组表达。

text

默认为空。预留给submitVote这个API使用

items

选项(答案)列表

option

选项(答案)

correct

是否为正确答案,与answer属性作用相同

selected

默认为false。表明用户没有选择该项。预留给submitVote这个API使用。

3.17onStatus

事件说明:SDK状态通知

参数:

{

"type" : [1 | 2 | 3] ,

"explain" : "license not enough"

}

参数

说明

type

类型

1 - License不足;

2 - 点播未开始,等待点击开始按钮;

3 - 缓冲状态

4 - 不能在ipad中播放

5 - 正在执行seek命令

6 - 表示有人登陆

7 - 人数已经满了

8 – 数据还没有准备好

9 - 视频第一次缓冲播放开始

explain

说明

 

3.18onAPIError

事件说明:API错误通知

参数:

{

"api" : "submitQuestion",

"param" : {……},

"explain" : "format error",

"type" : 1

}

参数

说明

api

API名称

param

API所提交的原始参数

explain

说明

type

错误类型

0 – API名称错误

1 – 参数校验错误;

2 – 必填项缺失;

3.19onChatSegmentList

事件说明:收到分段聊天记录

默认200条。如果需要加载更多记录,请参考more参数用法。

{

"more" : true,

"list" : [

{

"sender" : "Tom",

"content" : "fine, thank you.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ”1,2,4”

},

{

"sender" : "Jacky",

"content" : "Hi.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ”1,2,4”

}

]

}

参数

说明

sender

发送者名称

content

聊天内容

submitTime

发送时间 单位毫秒

senderId

发送者用户ID

senderRole

(需支持公聊数据的同步播放功能,才会输出)

用户角色以组合的形式出现,可能是单个角色,可能是多个角色,多个角色用逗号分隔,角色对应含义如下:组织者 = 1

主讲   = 2

嘉宾   = 4

普通参加者 = 8

Web参加者 = 为空

more

false – 说明没有更早的聊天数据

true – 说明还有更早的聊天数据,可以再次调用submitChatSegment以获取下一批200条聊天数据。

3.20onMessage

事件说明:收到系统消息 (广播消息)

参数:

{

"content":"通知。。。。"

"time":"1543458908000”

}

参数

说明

content

系统消息内容

time

系统消息发出的时间(毫秒)

 

3.21onLeaveMessageList

事件说明:收到用户留言信息

参数:

{

       

"list": [

{

"id": "abcd-efg-hi",

"question": "how are you?",

"submitor": "Tom",

"answer": "fine, thank you.",

"answerBy": "Jack",

"submitTime": 9654123,

"answerTime": 8795623

},

{

"id": "abcd-efg-hi",

"question": "how are you?",

"submitor": "Tom",

"answer": "fine, thank you.",

"answerBy": "Jack",

"submitTime": 9654123,

"answerTime": 8795623

}

]

}

参数

说明

list

问答列表,列表中每个对象都是留言信息。可以参考onQA的字段说明

 

3.22onChatHistory

事件说明:监听事件,初始化后并不会马上返回任何数据。只有当提交submitChatHistory后,监听事件才会收到聊天数据,默认200条。如果需要加载更多记录,请参考more参数用法。

参数:

{

"more" : true,

"list" : [

{

"sender" : "Tom",

"content" : "fine, thank you.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ”1,2,4”

},

{

"sender" : "Jacky",

"content" : "Hi.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ”1,2,4”

}

]

}

参数

说明

sender

发送者名称

content

聊天内容

submitTime

发送时间 单位毫秒

senderId

发送者用户ID

senderRole

(需支持公聊数据的同步播放功能,才会输出)

用户角色以组合的形式出现,可能是单个角色,可能是多个角色,多个角色用逗号分隔,角色对应含义如下:组织者 = 1

主讲   = 2

嘉宾   = 4

普通参加者 = 8

Web参加者 = 为空

more

false – 说明后续没有聊天数据

true – 说明后续还有聊天数据,可以再次调用submitChatHistory以获取下一批200条聊天数据。

 

 

3.23onVideoProperties

事件说明:通知点播视频属性

参数:

{

"startTime":1539238594

"endTime":1539238383

}

参数

说明

startTime

点播开始时间 单位毫秒(GMT 1970.1.1)

endTime

点播结束时间 单位毫秒(GMT 1970.1.1)

3.24onChat

事件说明:当点播支持聊天同步功能时,开启聊天数据同步播放功能并监听该事件,则可以在点播播放过程中根据播放进度收到对应的聊天数据。

参数:

{

"list" : [

{

"sender" : "Tom",

"content" : "fine, thank you.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ” 1,2,4”

},

{

"sender" : "Jacky",

"content" : "Hi.",

"submitTime" : 9654123,

"senderId" : "111111",

“senderRole” : ”1,2,4”

}

]

}

参数

说明

sender

发送者名称

content

聊天内容

submitTime

发送时间 单位为秒(GMT 1970.1.1)

senderId

发送者用户ID

senderRole

(需支持公聊数据的同步播放功能,才会输出)

用户角色以组合的形式出现,可能是单个角色,可能是多个角色,多个角色用逗号分隔,角色对应含义如下:组织者 = 1

主讲   = 2

嘉宾   = 4

普通参加者 = 8

Web参加者 = 为空

3.25onDoubleClick – 收到用户双击组件事件

事件说明:用户双击特定组件

参数:

{

"widgetType":"vp|pd"

}

参数

说明

widgetType

双击组件的 类型vp:播放器 pd:文档

 

 

3.26onVideoClick – 收到用户单击组件事件

事件说明:用户点击视频组件

参数:

{

}

参数

说明

 

 

 

 

3.27onVideoKeyboardPress – 收到用户键盘按键事件

事件说明:用户按下键盘按键后释放时触发(只有在视频组件获取焦点时有效)

前提条件:视频组件获取页面焦点

参数:

{

"keyCode":32

}

参数

说明

keyCode

键盘按键Unicode值

 

 

 

 

3.28onMute – 静音监听接口

事件说明:用户被动收到禁音命令时触发

备注:仅对pcH5播放器有效

参数:

{

      "mute":[true | false]

}

参数

说明

mute

该属性主要用于外部自定义控制条状态的同步

3.29 onMobileStatus- 收到登陆用户手机绑定状态

事件说明:需用户登陆状态下,手机的绑定状态(在截止日期后必须绑定手机,否则无法登陆)

参数:

{

    "code": “mobile_not_bind”,

}

参数

说明

code

值为mobile_not_bind 当前未绑定手机

 

4提交命令或数据API

4.1seek

说明:跳转到指定时间点

注意:该api只在不采用默认控制条的前提下生效

参数:

{

"timestamp":100

}

参数

说明

timestamp

指定时间点,单位毫秒。

4.2pause

说明:暂停播放

注意:该api只在不采用默认控制条的前提下生效

参数:

{

}

参数

说明

 

 

4.3play

说明:开始播放/暂停后恢复播放

注意:该api只在不采用默认控制条的前提下生效

参数:

{

}

参数

说明

 

 

4.4playheadTime

说明:获取当前播放时间点,下载进度,文件总时长

参数:

{

}

参数

说明

 

 

 

4.5submitVote

事件说明:提交调查问卷结果

参数:

提交对象格式同onVote接口,请参看onVote接口的参数说明

{

    "id" : "abcd-efg-hi",

    "skip" : ["true" | "false"],

    "subject" : "test vote",

    "questions" : [

        {

            "id" : "uuid",

            "subject" : "first question",

            "type" : ["single"|"multi"|"text"],

            "answer" : "1,3",

               "text" : ""

            "items" : [

                {

                    "id" : "uuid",

                    "correct" : ["true" | "false"],

                    "option" : "answer1",

                          "selected" : ["true" | "false"]

                },

                {

                    "id" : "uuid",

                    "correct" : ["true" | "false"],

                    "option" : "answer2",

                                      "selected" : ["true" | "false"]

                }

            ]

        }

    ]

}

参数

说明

 

 

4.6 leaveMessage

说明:留言

参数:

{

"content" : "what's your name?",

"email":"dsfdsf@126.com"

}

参数

说明

content

问题内容

email

邮件(非必选)

4.7submitMute

事件说明:提交静音信息。

注意:该api只在不采用默认控制条的前提下生效

参数:

{

"mute" : [true | false]

}

参数

说明

mute

是否设置为静音。

 

 

4.8submitVolume

事件说明:提交音量信息。

注意:该api只在不采用默认控制条的前提下生效

参数:

{

"value" : 0.75

}

参数

说明

value

该值在0~1范围内有效

 

4.9submitStop

事件说明:通过接口直接结束现有点播。

注意:该api只在不采用默认控制条的前提下生效

参数:

{

}

 

 

 

 

4.10submitQAList

事件说明:通过接口申请获取生成该点播的直播Q&A历史记录。

这是个异步申请接口,Q&A数据将通过onQAList事件返回给第三方。因此,请在调用此方法前,预先监听onQAList事件。

参数:

{

}

 

 

 

 

 

4.11submitChatHistory

事件说明:通过接口申请获取生成该点播的直播公共聊天历史记录。

这是个异步申请接口,公共聊天历史数据将通过onChatHistory事件返回给第三方。因此,请在调用此方法前,预先监听onChatHistory事件。

参数:

{

}

 

 

 

 

 

4.12submitChatSegment

事件说明:通过接口申请获取该点播的直播公共聊天更多历史记录。开启聊天数据同步功能后可用。

这是个异步申请接口,聊天分段历史数据将通过onChatSegmentList事件返回给第三方。因此,请在调用此方法前,预先监听onChatSegmentList事件。

参数:

{

}

 

 

 

 

 

4.13submitLeaveMessageList

事件说明:通过接口申请获取该点播的留言历史记录。

这是个异步申请接口,留言历史数据将通过onLeaveMessageList事件返回给第三方。因此,请在调用此方法前,预先监听onLeaveMessageList事件。

参数:

{

}

4.14setupChatSync

说明:开启或关闭聊天数据同步功能。

当点播支持聊天同步功能时,开启同步功能则可以通过onChat事件收到聊天数据;关闭同步功能则不会发送onChat事件。

参数:

{

      "open" : [ true | false]

}

open

是否开启聊天同步播放功能。默认是不开启。

true – 开启

false – 关闭

4.15submitPlaybackRate

事件说明:通过接口控制音视频倍速播放

注意:该api只在PC Web H5播放器中支持

参数:

{

" playbackRate" : [0.5-4]

}

参数

说明

playbackRate

倍数可配置范围:0.5-4,微调精度:0.25

 

4.16 submitStream – 选择码流

备注:在多码流间切换。仅当移动端开启多码流功能情况下该接口生效。是否支持多码流参见 4.8 onSetting 接口说明。

参数:

{

"level": [0 | 1]

}

参数

说明

level

码流。0 – 标清,1 – 原始

4.17 submitSameQuestion - 提交同问数据接口

注意:同问接口目前只有小班课支持。

参数:

{

"id": "abcd-efg-hi"

}

参数

说明

id

问题id

4.18 submitFaultReport - 提交故障报告

事件说明:用户主动提交故障报告

参数:

{

 

}

参数

说明

 

 

 

5补充说明

 

5.1H5播放器兼容性问题

5.1.1 站点需要开启“移动端转码”,否则不支持H5播放器模式。

5.1.2 必须是4.7.8上线之后生成的点播件,才支持H5播放器模式。

5.2编码问题

5.2.1考虑到网页中文乱码问题,基于目前国际标准实现,建议客户的网页以UTF-8编码