产品介绍 官网开发者
产品简介
产品概述
开发者中心是基于微吼强大的视频处理能力和成熟的API&SDK能力,为用户提供便捷接入、功能全面、性能稳定、方式灵活的直播&点播服务。同时提供了丰富的API&SDK文档,您可以通过申请权限创建应用后,依照文档与自己的应用和服务进行集成。让您告别复杂的架构设计和编程开发,减少了百分之80%的开发成本,维护成本几近于零,使您可以专注于业务逻辑实现及最终用户体验的提升。
主要功能
类别 | 功能名称 | 详细内容 |
---|---|---|
API管理 | 直播管理 | 支持对直播进行增、删、改、查,支持发起、结束直播,支持直播相关数据查询 |
回放管理 | 支持生成回放,获取回放列表,将回放设置为默认活动回放,设置直播活动的默认回放视频,把回放发布为点播活动,查询回放视频时长 | |
用户管理 | 支持用户的增、删、改、查,支持用户权限的查询、修改,支持用户相关数据的查询 | |
获取 SDK TOKEN值 | 获取SDK推流&观看TOKEN | |
自定义广播消息 | 支持发送自定义广播消息 | |
嘉宾助理 | 支持获取嘉宾/助理页面,添加嘉宾/助理权限,添加嘉宾/助理权限 | |
白名单 | 支持添加活动观看白名单 | |
聊天评论 | 支持获取直播聊天页面,获取直播历史聊天记录,添加回看评论 | |
问答管理 | 获取问答管理URL | |
问卷管理 | 获取问卷列表,获取问卷ID对应问卷答案 | |
签到管理 | 获取活动发起签到记录,获取签到ID记录 | |
事件回调 | 设置/查询回调事件, 查看当前回调信息 | |
SDK管理 | iOS SDK | 支持用户登录、发直播、看直播、看回看、美颜、公告、签到、问答、问卷、抽奖、画笔白板、VR、投屏、回放评论功能 |
Andriod SDK | 支持用户登录、发直播、看直播、看回看、美颜、公告、签到、问答、问卷、抽奖、画笔白板、VR、投屏、回放评论功能 | |
JSSDK | 支持直播和点播上传 | |
Java SDK | 支持点播上传 | |
网页嵌入 | 网页嵌入 | 直播嵌入、问答嵌入 |
产品优势
全功能
支持推、拉等直播方式,提供全流程的直播、点播服务,支持360度全景直播
极致体验
更低延时,更高流畅度,更高清晰度
多终端
支持全终端播放器调用,终端涵盖PC、Android、ios等设备
数据分析
涵盖直播在线人数、活动数据、观看并发、流量信息多个层面
推广营销
支持微信、网页嵌入直播,支持多渠道推广,协助客户进行活动营销
丰富的互动形式
观看视频过程中提供问卷、签到、公告、礼物、文档等服务,增强视频的互动性和趣味性。
变更历史
JS SDK
日期 | 版本号 | 更新内容 | |
---|---|---|---|
2021-04-29 | 3.1.1 | 1、新增更新: 历史聊天消息中增加图片字段,用于图片消息回显 2、优化及修复: 优化播放封面在个别机型不展示的问题 |
|
2021-04-12 | 3.1.0 | 1、新增更新: ①从3.1版本起支持两种延签方式RSA和MD5 ②初始化新增password字段,处理第三方k值或已有用户密码问题 ③初始化新增record_id字段,播放指定回放(当前活动如果在直播,此字段传值正确,将默认播放该回放) ④初始化新增sign_type字段,表示验签方式,0:MD5(默认),1:RSA (用户需要在业务中自行处理RSA验签格式等拼接) ⑤新增文档开关监听DocOpenStatus。on开启, off关闭 ⑤新增文档白板切换监听DocAndWhiteStatus。 document开启文档,board开启白板 2、优化及修复: ①播放器进度条长显,默认4s自动隐藏,滑动触发 ②设置回放时间,不能按预期显示问题 |
|
2021-02-25 | 3.0.6 | 优化日志输出 | |
2021-01-21 | 3.0.6 | 升级播放器SDK,解决微信中播放器进度条被手机自带进度条劫持,导致显示不正确问题 | |
2020-12-03 | 3.0.5 | 1、新增更新: ①从3.0.5版本起,获取直播和回放历史聊天信息,统一使用vhall_get_live_history_chat_msg方法,并且此方法仅支持分页传参,查询分页数据。vhall_get_record_history_chat_msg 方法从3.0.5版本起将不再支持 |
|
2020-11-23 | 3.0.4 | 1、新增更新: ①JSSDK完成Flash活动去flash化。即JSSDK观看flash活动不再需要FLASH插件就可播放,并且Flash活动下JSSDK支持对播放器相关操作 ②JSSDK完成对IE10, IE11兼容 ③SDK增加全局destroy方法,同时销毁播放器SDK,聊天SDK。取消播放器SDK单独销毁方法destroy |
|
2020-09-17 | 3.0.2 | 1、修复问题: ①修复播放器控制按钮状态切换 ②SDK初始化完成事件监听ready ③SDK播放器初始化完成事件监听playerReady |
|
2020-08-20 | 3.0.1 | 1、新增内容: ①兼容SDK3.0版本前SDK使用方式 ② SDK增加错误提示,提高用户体验 2、修复问题: ①SDK内根据http泛协议进行自动转换 ②SDK在Edge浏览器中兼容问题 |
|
2020-08-07 | 3.0.0 | 1、新增内容: ①全新的 API 使用方法 ( 不兼容2.6.9之前版本 ,2.6.9 兼容API开发中 ) ②移动端文档演示笔触功能 ③ H5类型活动 清晰度切换功能 2、修复问题: ①JSSDK用户与APP端用户聊天互通时角色标识的问题 ②文档翻页后使用jssdk进入直播间,文档不显示当前页 ③JSSDK用户在成员列表中显示上麦按钮的BUG |
|
2020-06-08 | 2.6.9 | 解决使用JS SDK观看H5活动,导致控制台并发中1个人变成2个人的问题 | |
2020-05-18 | 2.6.8 | 1、H5活动,直播和回放时,支持观众可以对文档自由翻页。当有权限操作文档的人翻页时,该观众的文档回到当前文档位; 2、触发resize事件,文档部分新增自动调整文档大小功能 |
|
2020-04-10 | 2.6.5 | 具体详见链接:https://www.vhall.com/saas/doc/1729.html | |
2020-04-09 | 2.6.4 | 具体详见链接:https://www.vhall.com/saas/doc/1727.html | |
2020-04-02 | 2.6.3 | 1、5个api方法支持Promise返回 2、Flash聊天支持图片消息 |
|
2019-12-13 | 2.6.0 | 1、新增问卷提交(成功,失败)通知; 2、新增播发器“跑马灯”“水印”支持 — 需在控制台设置跑马灯信息(jssdk读取控制设置的跑马灯); 3、新增“抽奖”消息通知 — 抽奖开始,抽奖结束(是否中奖)及设置发送中奖信息) |
|
2017-12-4 | 2.3.3 | 支持直播过程中实时修改用户头像、昵称 | |
2017-10-31 | 2.3.3 | 修复2.3.3上传纯音频文件无法播放 | |
2017-10-20 | 2.3.3 | 新增子账号点播上传功能 | |
2017-10-12 | 2.3.3 | 新增自定义消类型功能 | |
2017-09-28 | 2.3.3 | 新增公告和签到功能 | |
2017-08-14 | 2.3.3 | 新增点播上传模块 | |
2017-08-11 | 2.3.3 | 新增PC端观看视频和文档 | |
2017-03-15 | 2.3.2 | 修复2.3.1拉取回放历史聊天数据bug | |
2017-03-13 | 2.3.1 | 支持https | |
2017-02-13 | 2.3.0 | 内部小优化,不影响以前版本的使用 | |
2017-01-08 | 2.1.0 | 新增观看端视频与文档模块(仅只支持移动端) | |
2016-12-02 | 2.0.0 | 新增观看端问答&对1.0.0版本优化 | |
2016-11-10 | 1.0.0 | 初稿,支持观看端聊天 |
点播 SDK
日期 | 版本号 | 更新内容 |
---|---|---|
2021-04-09 | 2.0.0 | 更新版本后,上传点播默认H5播放器 |
iOS SDK
日期 | 版本号 | 更新内容 |
---|---|---|
2020-07-02 | V4.3.3 | 解决文档初始化是否显示的问题 |
2020-06-15 | V4.3.1 | 解决web先打开文档,ios 文档不加载问题 |
2020-06-11 | V4.3.0 | 1、新增水印功能 2、扬声器设备占用优化(后台切换等情况) 3、角色信息bug修复 4、新增直播前连接消息服务 5、解决回放显示文档的问题 6、优化demo |
2020-05-21 | V4.2.1 | 解决互动偶尔声音小问题 |
2020-04-27 | V4.2.0 | 1、支持投屏功能;2、日志上报优化 |
2020-04-20 | V4.1.2 | 修复问题,如demo优化、解决GPUimage 冲突bug、解决角色错误问题、解决历史聊天收不到、历史聊天没有回复、@的问题、回放静音失效问题、更新LSS SDK |
2019-11-27 | V4.0.1 | 鉴于Google Chrome 从2020年12月开始将不再支持Flash,PC端新增H5相关播放器实现;SaaS SDK 支持H5相关播放功能。 |
2017-11-21 | V3.0.2 | 播放优化,实现智能化调度 |
2017-10-23 | V3.0.1 | 投屏,PPT和白板优化,自定义消息 |
2017-7-27 | V3.0.0 | 新增降噪,音频增益功能,自定义滤镜,内部结构优化 |
2017-5-27 | V2.9.0 | 发起错误码调整,性能优化,发直播初始化接口修正 |
2017-4-13 | V2.8.0 | 观看VR视频和陀螺仪功能 |
2017-3-30 | V2.7.1 | 新增画笔白板功能 |
2017-3-13 | V2.7.0 | V2.7.0新增问卷功能 |
2017-3-1 | V2.6.0 | 新增公告功能,新增签到功能 |
2016-12-20 | V2.5.3 | 新增美颜功能,评论相关功能,支持MP4回放,支持Https协议 |
2016-11-10 | V2.5.0 | 新增抽奖功能,新增获取20条最近聊天记录功能 |
2016-09-27 | V2.4.0 | 新增登录,新增聊天,新增问答,集成应用签名机制,观看直播支持音视频切换 |
2016-07-26 | V2.3.0 | 新增清晰度切换 |
2016-05-06 | V2.2.0 | 新增文档演示 |
2016-04-21 | V2.1.2 | 初稿 |
Andriod SDK
日期 | 版本号 | 更新内容 |
---|---|---|
2021-02-08 | V6.0.0 | 说明:6.0.0以上版本请访问:https://saas-doc.vhall.com/docs/show/1225 |
2020-12-02 | V5.0.2 | 修复已知问题 |
2020-11-20 | V5.0.1 | 1、增加上报额外参数接口 2、增加直播镜像接口 3、优化基础功能 |
2020-10-30 | V5.0.0 | 1、优化用户使用 h5和flash统一使用方法 2、优化日志上报 3、添加h5文档显示 具体可以参考demo实现 或者查看大版本更新说明 4、优化基础功能 |
2020-07-02 | V4.3.1 | 1、当活动为预告状态时,主持人开播后,当前观众正在预告页,可以收到开始直播消息; 2、Demo问答显示隐藏优化 |
2020-6-15 | V4.3.0 | 1、新增水印功能 2、修复角色问题 3、修复回复空数据问题 4、优化demo |
2020-4-29 | V4.2.0 | 1、支持投屏功能;2、新增聊天回复、@操作数据返回等; |
2019-11-27 | V4.0.0 | 鉴于Google Chrome 从2020年12月开始将不再支持Flash,PC端新增H5相关播放器实现;SaaS SDK 新增VSS组件以支持H5相关播放功能。 |
2017-11-21 | V3.0.2 | 播放优化,实现智能化调度 |
2017-10-23 | V3.0.1 | 投屏,PPT和白板优化,自定义消息 |
2017-7-27 | V3.0.0 | 新增降噪,音频增益功能,自定义滤镜,内部结构优化 |
2017-5-27 | V2.9.0 | 发起错误码调整,性能优化,发直播初始化接口修正 |
2017-4-13 | V2.8.0 | 观看VR视频和陀螺仪功能 |
2017-3-30 | V2.7.1 | 新增画笔白板功能 |
2017-3-13 | V2.7.0 | V2.7.0新增问卷功能 |
2017-3-1 | V2.6.0 | 新增公告功能,新增签到功能 |
2016-12-20 | V2.5.3 | 新增美颜功能,评论相关功能,支持MP4回放,支持Https协议 |
2016-11-10 | V2.5.0 | 新增抽奖功能,新增获取20条最近聊天记录功能 |
2016-09-27 | V2.4.0 | 新增登录,新增聊天,新增问答,集成应用签名机制,观看直播支持音视频切换 |
2016-07-26 | V2.3.0 | 新增清晰度切换 |
2016-05-06 | V2.2.0 | 新增文档演示 |
2016-04-21 | V2.1.2 | 初稿 |
Java SDK
日期 | 版本号 | 更新内容 |
---|---|---|
2020-02-10 | 4.0.0 | 上传点播支持选择播放器:Flash和H5 |
2017-09-29 | 1.0.0 | 支持5G内点播文件上传并生成回看 |
API
日期 | 接口地址 | 更新内容 |
---|---|---|
2021-05-08 | http://e.vhall.com/api/vhallapi/v2/webinar/report | 修改此接口字段含义描述 |
2021-04-29 | http://e.vhall.com/api/vhallapi/v2/webinar/create、http://e.vhall.com/api/vhallapi/v2/webinar/fetch | 新增推流方式,非必选,0竖屏,1横屏,默认为1。竖屏推流直播请使用微吼直播APP推流,网页直播默认横屏推流 |
2021-04-15 | http://e.vhall.com/api/vhallapi/v2/record/default | 设置默认回放新增字段type,非必选,默认1,1.设置默认回放,0.取消默认回放 |
2021-02-07 | http://e.vhall.com/api/vhallapi/v2/webinar/create、http://e.vhall.com/api/vhallapi/v2/webinar/update、http://e.vhall.com/api/vhallapi/v2/webinar/fetch | 创建直播、更新直播、查询直播3个接口,去掉auto_record |
2020-12-08 | http://e.vhall.com/api/vhallapi/v2/report/lottery-details | 新增字段:remark,代表备注如地址,支持获取观众填写的地址信息 |
2020-12-03 | http://e.vhall.com/api/vhallapi/v2/report/track | 新增字段:返回数据是否包含主持人嘉宾(只针对H5活动生效), 0(否) 1(是) ,默认 0 |
2020-09-28 | /api/vhallapi/v2/webinar/fetch | 新增功能:增加player、exist_3rd_auth、auth_url三个字段 |
2020-09-14 | http://e.vhall.com/api/vhallapi/v3/record/getDownloadUrl | 新增功能:获取回放下载地址,技术文档参考:https://www.vhall.com/saas/doc/1797.html |
2020-07-03 | http://e.vhall.com/api/vhallapi/v2/redpacket/package | 新增功能:API接口支持获取红包信息,技术文档参考:https://www.vhall.com/saas/doc/1736.html |
2020-05-14 | http://e.vhall.com/api/vhallapi/v2/attendee/add-whitelist | 新增功能:API接口-百名单新增工号、其他2个字段,技术文档参考:https://www.vhall.com/saas/doc/52.html |
2020-04-23 | http://e.vhall.com/api/vhallapi/v2/guest/client-protocol | 新增功能:获取主持人/嘉宾的客户端私有协议,返回链接可唤起客户端,技术文档参考:https://www.vhall.com/saas/doc/1731.html |
2020-02-24 | http://e.vhall.com/api/vhallapi/v2/guest/password | 新增功能:嘉宾/助理接口增加口令,嘉宾可以通过口令调起客户端,https://www.vhall.com/saas/doc/1716.html |
2019-12-24 | http://e.vhall.com/api/vhallapi/v2/chat/add-keywords | 新增功能:子账号支持此关键词过滤,参数名:user_id(子账号微吼用户id,不传默认当前账号) |
2019-12-12 | http://e.vhall.com/api/vhallapi/v2/webinar/get-player-config | 新增功能:获取播放器设置 |
2019-12-12 | http://e.vhall.com/api/vhallapi/v2/webinar/set-player-watermark | 新增功能:设置播放器水印 |
2019-12-12 | http://e.vhall.com/api/vhallapi/v2/webinar/set-player-text | 新增功能:设置播放器跑马灯 |
2019-12-12 | http://e.vhall.com/api/vhallapi/v2/webinar/switch-list | 新增功能:获取开播记录 |
2019-12-04 | http://e.vhall.com/api/vhallapi/v2/user/update | 更新用户时,code:10078,密码为6-30位 |
2019-12-04 | http://e.vhall.com/api/vhallapi/v2/user/register | 创建用户时,code:10078,密码为6-30位 |
2019-12-04 | http://e.vhall.com/api/vhallapi/v2/webinar/create | 创建直播,增加播放器类型player字段。1代表flash播放器,2代表H5播放器,默认为1。此参数创建后不可更改,当参数为2时,is_new_version参数必传且为1。使用sdk的用户,请升级sdk至最新版本 |
2019-12-04 | http://e.vhall.com/api/vhallapi/v2/report/lottery | 获取抽奖列表和获取抽奖详情:pos参数默认为0 |
常见问题
一、观看直播,对用户系统有什么要求?
1、对电脑操作系统没有严格要求,可运行的浏览器包括
IE,Firefox,Chrome,Safari。
2、请保障您的flashPlayer版本在11.4以上,如果需要测试本机flashPlayer版本号,可访问以下链接http://www.adobe.com/swf/software/flash/about/flashAbout_info_small.swf
3、如果需要与活动组织者进行语音互动,请保障您的音频设备使用正常。
二、活动直播对网络有什么要求?
1、主持人和嘉宾要求上行和下行带宽必须大于300kb。
2、普通参加者下行带宽大于300kb,上行带宽大于80kb。
三、活动发起者对硬件有哪些要求?
1、如果要进行音视频会议,主持人和嘉宾端要求有视频采集设备和音频采集设备;支持的视频设备包括摄像头和外置摄像机。
2、如果只进行音频会议,则主持人和嘉宾端只需要音频采集设备即可。
3、在设置录音设备时,应当在操作系统的麦克风设置面板中关闭“侦听此设备”的选项,以免使用者听到自己的声音的回传。
四、活动发起者都有哪些注意事项?
1、主持人和嘉宾在会议进行中,请尽可能的避免更换硬件设备的操作,如:插拔摄像头、麦克风等。
2、使用麦克风设备时,请尽可能使用头戴式麦克风或者质量较好的录音设备。尽量避免使用笔记本自带的或者和摄像头一体的录音设备,以保证参会者可以听到清晰的声音效果。
3、如果需要录制整个会议的过程,主持人和嘉宾应当避免在会议过程中进行刷新网页的操作。
五、更多其他问题
1、 桌面共享在哪里下载?
答:发起直播页面最下端的“保存并发送”右手边有插件可下载。
2、 直播需要的带宽要求多少?
答:发起方需要上行最少达2M独享,观看方只要下行达到300kb/s就行。
3、 用什么专业设备做直播好些?
答:笔记本电脑、摄像机(只要有视频输出就行)
高清视频采集卡:upmost mpb710
标清视频采集卡:宝狮BS 602DVD-PLUS
音频采集盒:罗兰ROLAND UA-55
以上是建议采购的音视频采用卡设备,如果在室内50平米的地方直播,也可以直播采购罗技CC3000E。
4、 发起直播需要什么硬件?
答:最简单的直播,只需要一台联网的带摄像头的电脑即可。
5、 聊天区可以发送图片吗?
答:暂时不支持,但可以发送表情。
6、 自助版直播手机观看PPT 能放大吗?
答:手机观看是无法缩放的。PC是在flash里实现缩放的,而手机观看就是浏览器,它是由浏览器控制大小的。
7、 自助版有抽奖功能吗?
答:自助版暂时没有,但客户端有。
8、希望手机客户端能切换嘉宾并视频。
答:IOS和安卓均可一键发起视频,但暂不能切换嘉宾或视频。
9、摄像头禁用时无法插播视频?
答:需选择摄像头之后再插播,此外,插播切回禁用也无法直接操作,需先选择摄像头再选禁用。
10、移动端可以语音交流和文字互动吗?
答:移动端登录后可以文字互动,但不能语音交流。
11、IOS手机直接打开的直播链接不能边看直播边文字交流?
答:因为IOS系统本身问题,链接看视频都是直接全屏的,所以只能暂停直播视频后才可发送文字交流,而APP上没有问题,可以边看视频连文字评论,但是没PPT;安卓系统没问题,可以上半部分视频下半部分文字交流和观看PPT。
12、是否提供下载功能?
答:只要是做第三方嵌入的,都有下载的接口提供。
13、能在局域网内直播吗?
答:不能直播。
14、嘉宾和嘉宾之间可以进行私聊么?
答:不可以。嘉宾可以上传文件,但不能删除。
15、普通参会者可以进行麦克风设备的选择么?
答:可以。
16、嘉宾角色进入直播页面,有人员管理功能吗? 答:没有的。
17、上传的PPT文件或视频文件不能超过多大?
答:支持500M以内的文件,视频文件过大可以转成flv格式或分成多段视频。
18、可以上传多少个视频文件或PPT 文件?
答:原则上不限制文件数量。
19、在直播页面,一次最多可以邀请几个观众?
答:一次最多10个。
20、具有演示权限的角色有?
答:组织者、嘉宾
21、语音交流时,所有观众都可以听到吗?
答:是的,所有在线观众都可以听到对话。
22、调查问卷可以重复提交吗?
答:不可以。
23、投票可以重复提交吗?
答:可以,但是以最后一次为准,之前的投票会清零。
24、有视频设备没有音频设备可以屏幕共享吗?
答:可以。
25、插播的视频文件,移动端可以观看吗?
答:可以。
26、主持人放大或缩小文档展示区的内容,观众也会随之变化吗?
答:不会。
27、被踢出的普通参会者,还能继续进入此次会议吗?
答:不能。
28、在线问答功能,只有组织者可以回答吗?
答:不是的,嘉宾和组织者均可以回答。
29、进行三方语音如何操作?
答:主持人权切给嘉宾、组织者开启语音、普通参会者(或非当前演示嘉宾的另一个嘉宾)申请发言,组织者允许申请者,此时即可进行三方语音。
30、普通参会者的在线问答有哪两个标签页,分别显示的内容是什么?
答:我的问题:显示自己提出的所有问题列表;已回复:显示所有已回复过的问题列表。
31、哪些视频片段会被录制?
答:组织者点击“录制”“暂停”按钮中间的片段会被录制。嘉宾为当前演讲者时,默认全部录制。不用点录制也是全部录制,如果有四个人是主讲的话,可以分成四个链接,每个人讲的时候点录制和暂停,讲完一个就可以形成一个链接,可存为1、2、3、4 。
32、插播的视频文件会被录制吗?
答:会。
33、APP下载与不下载的区别?
答:IOS系统和安卓系统下载APP后,均可一键发起或观看直播。
34、直播界面去掉微吼的元素如何收费?
答:全案版单次去LOGO元素3000元,如果是包年的自助版要去LOGO,需要5万元。
35、PC延时在5秒左右,为何移动端有15 秒左右呢?
答:因为移动端的配置不如PC的高,所以延时比较长。
36、“主讲人”和“参会者”这两个名称能编辑修改为“老师”和“学生”吗?
答:不可以的。
37、客户自己剪辑视频(含PPT翻页脚本)上线?
答:客户自己编辑的视频可能会造成PPT翻页信息丢失、视频格式与平台要求不符等多种异常情况。因为通用的编辑器一般会丢弃非音视频数据(如:翻页和画图信息),而且由于直播的特殊性,如果直播过程出现网络波动或卡顿,会造成编辑后的音视频不同步等后果。
38、小范围内私聊(主持人、助理、嘉宾之前私聊)可以吗?
答:微吼直播面向的是大规模高并发直播,小范围交流的模式。
39、客户是否可以用自己的编码器?能不能提供一个RTMP发布地址,或者别的发布方式?
答: 一次性的活动和一路流长时间推(比如监控摄像头)可以单独给客户一次性配置;而经常自助使用者则不行。
40、音频采集卡的要求?
答:只要有卡龙或6.5的接口即可。
更多常见问题,https://www.vhall.com/help