亿联UC的开放能力
亿联UC提供服务端API开放和客户端SDK开放,开发者可根据业务需求使用相应开放能力集成开发。
1、服务端集成:
UC开放API向第三方开发者提供安全使用UC服务的入口。 通过UC APIs, 开发者可以使用UC服务的企业成员管理、 会议管理和会议控制等功能。UC API是基于HTTP的类REST风格API(REST-like API) 。 类REST风格表示使用URI标记资源并且允许通过HTTP协议访问API, API依赖于HTTP的语义和方法。
为了保证使用UC API的安全性, 传输协议统一使用HTTPS并且全部请求都需要进行身份认证。 如果使用UC API时, 没有携带正确的身份凭证信息, 那么请求将直接被拒绝。
UC平台对API的调用频率进行限制, 保证系统的稳定性。 大多数端点的速率限制为每秒50个请求。 这个速率限制是企业级别, 对于每个支持UC API的企业, 我们允许每秒50个请求。
特殊限制说明:
API 模块 | URI Pattern | 限制速率 |
---|---|---|
会议控制 | /v2/ctrl/* | 500个请求/秒 |
2、客户端SDK集成:
亿联UME提供了客户端会议SDK开放,开发者可以在自己开发的App上集成亿联UME的会议视频会议能力,实现快速会议、加入会议、屏幕共享等功能。
SDK本身已集成入会后的UI,第三方App只需调用少量接口就可以在自己的App中集成亿联UME的视频会议能力。
3、客户端Scheme应用集成:
亿联UME客户端提供URL Protocol定义好的参数,第三方应用(包括Web页面或者终端App应用)可以直接唤醒亿联会议客户端并自动入会。
表1 亿联UC开放能力简介
开放能力分类 | 开放能力 | 开放能力详情 |
服务端开放能力 | 企业管理 | 本企业信息查询、编辑 |
用户管理 | 分组增、删、改、查;企业用户增、删、改、查;查询用户申请列表;企业用户树查询 | |
云会议室管理 | 云会议室创建、修改、删除、查询 | |
会议管理 | 会议/周期性会议创建、修改、查询、删除 | |
录制管理 | 录制文件列表查询、录制文件详情查询;录制文件名称修改、录制文件删除;获取录制文件下载链接 | |
录音文件管理 | 查询企业或个人录音文件列表、删除企业或个人录音文件、查询企业或个人录制文件下载地址 | |
会议控制 | 会中对主持人、与会者进行邀请入会、挂断、静音、摄像头开闭、会议布局设置(主持人布局、与会者布局、个人布局)、会控webhook等 | |
统计分析 | 企业通话记录列表、详情,个人通话记录列表、详情等 | |
IM | 发送卡片消息、发送文本消息等 | |
Phone呼叫控制 | SIP话机注册信息查询、服务端控制sip话机呼叫、服务端结束sip话机通话、Phone webhook等 | |
客户端Meeting SDK开放能力 | Android SDK | 创建会议、加入会议、匿名入会、P2P通话 |
iOS SDK | 创建会议、加入会议、匿名入会、P2P通话 | |
Windows SDK | 创建会议、加入会议、匿名入会、获取当前视频会议布局、获取当前会议信息 | |
Mac SDK | 创建会议、加入会议、匿名入会、获取当前视频会议布局、获取当前会议信息 | |
PC Web SDK | 加入会议、自定义入会名称、通话界面UI控件支持隐藏/显示 | |
移动端 Web SDK | 加入会议、自定义入会名称、通话界面UI控件支持隐藏/显示 | |
微信小程序 SDK | 加入会议、通话界面大小位置支持自定义、UI控件支持隐藏/显示 | |
客户端Scheme开放能力 | 亿联UME Android App | 唤醒App/唤醒App登录账号/唤醒App并加入会议 |
亿联UME iOS App | 唤醒App/唤醒App登录账号/唤醒App并加入会议 | |
亿联UME Windows客户端 | 唤醒App/唤醒App登录账号/唤醒App并加入会议 | |
亿联UME Mac客户端 | 唤醒App/唤醒App登录账号/唤醒App并加入会议 | |
亿联UME Linux客户端 | 唤醒App/唤醒App登录账号/唤醒App并加入会议 |
4、集成场景举例1:预约一场会议
当您需要在自己开发的应用中集成亿联UC会议服务,预约一场线上会议时,您可以调用亿联UC服务端的REST API添加会议接口,该接口同时支持了添加参会者,当您预约成功后,对应参会者的客户端上将收到会议日程,可选查看会议详情或直接加入会议。
tips:uc支持会议管理的webhook事件,因此您也可以利用webhook在自行集成亿联UME会议SDK的app上,实现会议日程,亿联UME会议SDK暂未支持会议日程能力
图1 API调用流程
图2 参会成员客户端会议日程
5、集成场景举例2:亿联UME客户端应用集成免登跳转
1)应用背景:
当您的内网中或云上存在多个业务系统,如OA系统、审批报销系统等,日常使用时需逐个访问登录网页,输账号,输密码,是否十分繁琐?
如果将所有网页应用集成在一个融合通信客户端上,既兼顾已有业务系统,又提供IM办公聊天、视频会议,相信能对您的办公效率带来十分可观的提升。
2)亿联UME客户端应用对接支持现状:
支持同时对接多个网页应用,可实现一键免登跳转。满足用户使用一个ume客户端,便同时拥有了多个网页应用的一键免登跳转体验,有效地提高了办公效率。
图3 亿联UME客户端应用集成免登跳转
上图中①是亿联UME客户端中的工作台,点击后自动跳转,②是跳转到浏览器网页(可选跳转系统浏览器或UME内置浏览器),并自动访问OA登录上自身对应OA账号。