Pro并发模式集成指南

本指南为入门性质,方便项目管理人员了解相关流程和基本原理,负责集成工作的技术人员,需要详细预约下面的API文档,以及SDK中的UserGuide文档。


资料下载

API文档下载

https://down.bizvideo.cn/app/bizconf/open/api_bingfa.docx 

Pro APP下载

https://pro.bizvideo.cn/support/download

SDK下载

https://www.jianshu.com/p/febfc71d0abb



集成概述

会畅提供的API,一般不建议客户的APP直接访问。建议客户用自己的web服务器访问会畅API预约会议,然后将预约成功的信息转给APP,同时在自己的数据库中保存。


准备工作

方案1. 如果您采用API预约会议,调用Pro APP参加会议的方式,只需要由商务代表为您申请开通站点,提供sitesign和API key,即可启动研发工作。

方案2. 如果您采用API预约会议,调用SDK,在您自己的APP中参加会议的方式,那么需要由商务代表为您申请开通站点,提供sitesign和API key,以及channel ID和 SDK key,方可启动研发工作。


API传参说明

传参格式为application/x-www-form-urlencoded,不能用json格式传参。否则会返回109错误。

userId:一般建议填您的系统中的这个用户的ID。假设您的APP是一个OA系统,那么可以传您给用户定义的OA账号ID;长度一般不超过32个字符。

username:是会中显示的名字,也建议您传您系统中的用户昵称,和APP保持一致。

token根据手册中的方法,生成大写的32位MD5值,即MD5(“userId|APIKey|timeStamp”);

timestamp是毫秒,不要用秒,请注意

sitesign是商务代表帮您申请的二级站点的前缀。比如,二级站点为huawei.bizvideo.cn,那么这里就填“huawei”,必须一字不差! 

starttime是GMT时间,也就是北京时间减掉8小时。格式必须是“2019-01-03

07:00:00”。

confParties:会议申请占用的并发数量。比如您预计本场会议约有50人参加,则可以传50.系统会为您保留50个并发资源,保证会议开始后50个参会人可以顺利加入。如果会议开始后,发现50并发不够,届时可以通过《2.14 会中修改会议》接口临时扩容。

注意事项

timestamp和token都是一次性的,用一次,下次就要换一个值!

confPassword是会议密码,长度不可超过10位!

token要大写!



主持人如何开启会议

会议预约成功后,返回值中会有hostStartUrl和protocolHostStartUrl两个字段。

如果您采用的集成方式是方案1(API+Pro APP),可以通过浏览器打开hostStartUrl,进入到一个启会页面,该页面会自动调起Pro APP开会。

如果您采用的集成方案是方案2(API+SDK),需要调用SDK中的startMeeting接口,具体用法如下(以iOS端为例):

- (void)startMeeting:(NSString *)protocol

needRemind:(BOOL)needRemind

result:(void (^)(BizSDKMeetError))completion;

参数解释

protocol就填web返回的protocolHostStartUrl,包含了会议号,身份认证等所有信息。needRemind如果传YES,那么在会议结束前10分钟,会弹框提示用户“会议即将结束”,以避免超出时间后,和其他的会议冲突。


参会人如何参加会议

会议预约成功后,返回值中会有joinURL和protocolJoinUrl两个字段。

如果您采用的集成方式是方案1(API+Pro APP),可以通过浏览器打开joinURL,进入到一个启会页面,该页面会自动调起Pro APP参会。如果您希望给参会人指定一个姓名,在joinURL后面追加?uname=XXX就可以了。

如果您采用的集成方案是方案2(API+SDK),需要调用SDK中的joinMeeting接口,具体用法如下(以iOS端为例):

- (void)joinMeeting:(NSString *)protocolJoinUrl

isAudio:(BOOL)audio

isvideo:(BOOL)video

result:(void(^)(BizSDKMeetError))completion;

参数解释

protocol就填web返回的protocolJoinUrl,包含了会议号,参会密码等所有信息。isAudio如果传YES,那么在进入会议后,自动连接语音,传NO,则需要用户手动连接语音(可以自由选择接入方式,比如VoIP,电话呼入,外呼)。isvideo如果传YES,则在进入会议后,摄像头默认是开着的(前提是web在预约会议时,optionVideoParticipants传了1。否则即使此项传YES,进入会议后摄像头也是关闭状态)。

如果您要给参会人指定一个姓名,在protocolJoinUrl后面追加&uname=XXX就可以了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。