亿联会议的开放能力
亿联会议提供完善的服务端API和客户端SDK开放能力,开发者可根据业务需求使用相应开放能力进行集成开发。
1、服务端API:
Yealink云视讯开放API向第三方开发者提供安全使用云视讯服务的入口。通过Yealink APIs,开发者可以使用云视讯的企业成员管理、会议管理和会议控制等功能。
Yealink API是基于HTTP的类REST风格API(REST-like API)。类REST风格表示使用URI标记资源并且允许通过HTTP协议访问API。API依赖于HTTP的语义和方法。
为了保证使用Yealink云视讯API的安全性,传输协议统一使用HTTPS并且全部请求都需要进行身份认证。如果使用Yealink API时,没有携带正确的身份凭证信息,那么请求将直接被拒绝。
2、客户端SDK:
亿联会议提供了客户端SDK开放,开发者可以在自己开发的App上集成亿联会议的视频会议能力,实现快速会议、加入会议、屏幕共享等功能。
SDK中已集成入会后的UI,第三方App只需调用少量接口就可以在自己的App中集成亿联会议的视频能力。
3、客户端Scheme应用集成:
亿联会议客户端提供URL Protocol定义好的参数,第三方应用(包括Web页面或者终端App应用)可以直接唤醒亿联会议客户端并自动入会。
表1 亿联会议开放能力简介
亿联会议开放能力简介 | ||
---|---|---|
开放能力分类 | 开放能力 | 开放能力详情 |
服务端开放能力 | 企业管理 | 本企业信息查询、编辑 |
用户管理 | 分组增、删、改、查;企业用户增、删、改、查;查询用户申请列表;企业用户树查询 | |
云会议室管理 | 云会议室创建、修改、删除、查询 | |
会议管理 | 会议/周期性会议创建、修改、查询、删除 | |
录制管理 | 录制文件列表查询、录制文件详情查询;录制文件名称修改、录制文件删除;获取录制文件下载链接 | |
会议控制 | 会中对主持人、与会者进行邀请入会、挂断、静音、摄像头开闭、会议布局设置(主持人布局、与会者布局、个人布局)等 | |
统计分析 | 企业通话记录列表、详情,个人通话记录列表、详情 | |
单点登陆 | Oauth2.0 | 单点登录功能支持企业直接使用第三方账号登录亿联会议,无需提前同步账号信息。 |
CAS | ||
客户端 SDK开放能力 | Android SDK | 创建会议、加入会议、匿名入会、P2P通话 |
iOS SDK | ||
Windows SDK | 创建会议、加入会议、匿名入会、获取当前视频会议布局、获取当前会议信息 | |
Mac SDK | ||
Electron UI SDK | ||
Web SDK | 加入会议、自定义入会名称、通话界面UI控件支持隐藏/显示 | |
客户端 Scheme 开放能力 | 亿联会议Android App | 唤醒App/唤醒App并加入会议 |
亿联会议iOS App | ||
亿联会议Windows客户端 | ||
亿联会议Mac客户端 |
集成场景举例1:预约一场会议
第三方应用可以调用亿联云视讯服务端的REST API预约会议,添加参会者,预约成功后,对应参会者的客户端上将收到会议日程,可选查看会议详情或加入会议。
tips:亿联会议已支持提供会议管理相关的webhook事件,若您需要实时获悉当前云企业的预约会议、变更会议、删除会议的事件变化时,您可查阅服务端API参考--webhook章节点击跳转,根据步骤配置事件订阅。
图1 API调用流程
图2 参会成员客户端会议日程
集成场景举例2:Oauth2.0集成
OAuth(Open Authorization)是一个关于授权(authorization)的开放网络标准,允许用户授权第三方 应用访问他们存储在另外的服务提供者上的信息,而不需要将用户名和密码提供给第三方移动应用或分享他 们数据的所有内容。OAuth在全世界得到广泛应用,目前的版本是2.0版。
集成场景举例3:第三方App集成亿联会议SDK实现入会
您可在自己App上集成亿联会议客户端SDK,只需在App上开发集成对应的服务端API接口:预约会议、查询会议列表、查询会议详情,以及SDK接口:加入会议,入会后的会控操作均是SDK提供的UI界面,无需新开发。
图3 第三方App集成SDK场景
上图中①②③④⑤的界面都在同一个App中,其中①②③④是第三方自己的App界面,⑤是SDK提供的界面。