好视通视频会议私有云产品接入接口规范V10.docx

好视通视频会议私有云产品接入接口规范深圳银澎云计算股份有限公司2015年6月1日版本修订记录版本号修订日期修订人修订记录1.02015-06-02高文杰新增：汇总以下文档，合并为该文档《好视通企业版接口说明》《好视通IOS接口说明》《好视通Android接口说明》文档说明接口应用说明随着移动互联网、智能终端和“互联网+”的飞速发展，云会议产品已经深入到金融、交通、运输、教育等不同行业，而且在人们的日程生活、工作中起着日益重要的作用。同时，各类消费者的不同需求也要求厂家能够提供更加细致的定制化功能。比如和企业网站的交互、企业办公软件（OA）的交互。针对市场需求，好视通推出了视频会议企业版接口，涵盖了客户端的命令行调用、Web页面调用、IOS客户端调用、Android客户调用等不同调用方式；通过WebService接口，为客户提供了更加丰富的二次开发接口，客户可通过WebService接口，对登陆会议的账号、会议室、权限等进行更加细致的功能开发。本文档适用读者本文档在于定义好视通云会议产品与第三方系统交互的接口，包括但不限于产品之间的互相调用以及业务模块之间通讯的接口协议，用于好视通产品的OEM或者ODM项目，以及第三方厂家的二次开发工作。本文档的适用读者包括：好视通云会议产品相关销售、测试、研发人员。第三方厂家相关销售、测试、研发人员接口范围本文档涵盖的产品包括：好视通私有云会议管理平台、好视通视频会议客户端、好视通IOS客户端、好视通Android客户端。PC客户端调用接口接口说明：好视通运营平台提供2种客户端登录接口，供第三方产品调用。分别为：命令行登录接口：命令行登录接口是通过在好视通客户端进程名后面添加命令行参数的方法，启动好视通客户端，登录会议。页面登录接口通过web页面方式，可直接启动好视通客户端。如果是嵌入B/S系统，建议采用第2种页面登录接口。如是果嵌入C/S系统，建议采用第1种命令行登录接口。命令行登录接口好视通客户端进程为客户端安装目录的FastMeeting.exe文件，客户端安装目录默认为C:\Program Files\Fastonz\FMClient\FMDesktop\FastMeeting.exe，可以通过查询注册表路径HKEY_CURRENT_USER\Software\Fastonz\FMDesktop下的FilePath，获得客户端进程的完整路径名。客户端的命令行参数定义如下：-rid 会议室ID-rpwd会议室密码-uname（必填）用户名-upwd用户密码-utype用户类型，0为游客 1为注册用户，默认为1-link（必填） 服务器登录地址，例如 TCP:localhost:1089-node节点ID（一般不需要填写）-run 客户端登录后的自动执行的操作，定义如下:RA申请发言RD申请主讲RV 广播本地视频RR 开始会议录制W1切换到标准布局W2 切换到培训布局W3 切换到视频布局WF切换到全屏模式WV1 切换到1分屏模式WV2 切换到2分屏模式WV3 切换到画中画分屏模式WV4 切换到4分屏模式WV6 切换到6分屏模式WV9 切换到9分屏模式WV12 切换到12分屏模式WV16 切换到16分屏模式WV25 切换到25分屏模式可以同时使用多个操作，中间用分号分隔当utype为1时，-upwd为必填当utype为0时，-rid为必填例如：FastMeeting -rid 10104 –uname t08 –upwd 8888 –link TCP:localhost:1089FastMeeting -rid 10104 –rpwd 1111 –uname hello –utype 0 –link TCP:localhost:1089如果某项参数为空，相应的前缀也不能出现在命令行中，例如：FastMeeting -rid –uname t08 –upwd 8888 –link TCP:localhost:1089就是错误的，因为-rid参数为空，就不应该在命令行中添加-rid页面登录接口3.3.1使用好视通登录页面好视通运营平台提供了使用URL地址的方式直接进入会议，其调用接口为：http:// localhost:8080/fm/userMgr/entermeeting.jsp可输入参数如下：userName：用户名userPwd：用户密码userType: 用户登陆类型，0为匿名登陆，1为凭用户名密码登陆roomID：会议室ID号roomPwd：会议室登陆密码（与后台设置的会议室登陆校验模型相关）出现以下两种情形之一时，登陆页面将会提示用户输入用户名和密码：1、未带参数userName2、userType为1但未带参数userPwd如果userType为0时，不会显示密码输入框。