华为云会议Meeting对接使用完全指南：从API集成到SDK二次开发

1. 华为云会议开放能力全景

华为云会议Meeting作为一款企业级云视频会议解决方案，提供了多层次的开放接口，方便开发者将音视频会议能力集成到自有业务系统中。整体来看，华为云会议的开放能力分为三大类别：服务端REST API集成、客户端UI SDK集成、以及终端Scheme应用集成。

服务端集成主要面向业务后台系统，开发者可以通过调用RESTful API实现企业管理、用户管理、会议管理、会议控制等能力。客户端SDK集成则面向移动端和桌面端App，华为云会议提供了Windows、Android、iOS、Mac、Electron、HarmonyOS、Web等平台的SDK，开发者只需调用少量接口即可在自己的App中集成完整的会议功能。Scheme应用集成是最轻量的方式，通过URL协议直接拉起华为云会议客户端并带入会参数。

这三种方式各有适用场景：如果需要在自有后台系统中管理会议日程、控制会议流程，应选择服务端API集成；如果需要在自有App内嵌入会议界面，提供无缝的用户体验，应选择客户端SDK集成；如果只是想从Web页面或App中快速跳转到华为云会议客户端参加会议，Scheme集成最为便捷。

需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联

2. 对接前的准备工作

2.1 注册华为云账号并开通会议服务

在进行任何开发工作之前，首先需要注册华为云账号并开通华为云会议服务。访问华为云官网完成账号注册，并尽快完成企业实名认证。正式商用场景下需要订购华为云会议套餐；如果是测试验证阶段，可以使用免费试用服务——登录华为云会议控制台，点击开通云会议服务，填写企业邮箱、验证码、企业名称等信息即可完成开通。

2.2 申请App ID

无论是服务端API集成还是客户端SDK集成，App ID都是必不可少的凭证。App ID是华为云会议为第三方应用分配的唯一标识，用于鉴权认证。开发者需要在华为云会议控制台中申请App ID，申请后系统会生成App ID和对应的App Secret。App ID鉴权是官方推荐的鉴权方式，第一次鉴权通过后，华为云会议后台会自动为第三方用户应用分配一个华为云会议账号，这个绑定关系由华为云会议维护，开发者无需自行管理。

2.3 准备开发环境

根据所选的集成方式，准备对应的开发环境。服务端API集成需要支持HTTPS协议的HTTP客户端工具或开发框架。客户端SDK集成则需根据目标平台准备对应的开发工具：Android开发需要Android Studio及Android SDK；iOS开发需要Xcode；Windows开发需要Visual Studio；Web开发需要现代浏览器及Node.js环境。

3. 服务端REST API集成

3.1 API概述与调用规范

华为云会议服务端对外开放的RESTful API遵循标准的HTTP/HTTPS协议规范。API请求URI由协议头、Endpoint、资源路径和查询参数四部分组成。中国站Endpoint为api.meeting.huaweicloud.com，国际站为api-intl.meeting.huaweicloud.com。所有API均采用HTTPS协议传输，确保通信安全。

服务端API覆盖了极为丰富的功能维度：企业管理方面支持SP管理员对企业的增删改查以及企业资源管理；用户管理方面支持部门的增删改查、用户的增删改查、密码管理及企业通讯录查询；会议管理方面支持会议及周期性会议的创建、修改、查询以及历史会议查询；会议控制方面支持会中对与会人的邀请、挂断、静音以及多画面设置；此外还包括云会议室管理、硬终端管理、会议信息推送等能力。

3.2 App ID鉴权流程

调用任何业务API之前，必须先完成鉴权登录。App ID鉴权是官方推荐的方式。整个鉴权流程如下：

• 第三方应用服务器初始化参数，填入App ID、User ID等信息，并按照签名算法生成Signature
• 向网关APIG发起鉴权请求
• 网关将请求转发给华为云会议服务端
• 服务端验证通过后返回接入Token（accessToken）
• 后续所有业务API调用都需要在HTTP Header中携带该Token

以下是一个使用curl命令进行App ID鉴权的示例：

curl -X POST https://api.meeting.huaweicloud.com/v1/mmc/management/webtoken/login \\n  -H 'Content-Type: application/json' \\n  -d '{\\n    \"appId\": \"your_app_id_here\",\\n    \"userId\": \"your_user_id\",\\n    \"signature\": \"generated_signature\",\\n    \"timestamp\": 1700000000000\\n  }'

鉴权成功后，服务端会返回accessToken，该Token具有一定的有效期，过期后需要重新获取或通过刷新接口续期。

3.3 创建会议API调用

完成鉴权后，即可调用会议管理相关的API。创建会议是其中最常用的接口之一，支持创建即时会议和预约会议两种类型。调用该接口创建即时会议时，默认会将调用者作为主持人加入会议，无需在与会者参数中传递自己的信息。

以下是通过服务端API创建即时会议的示例：

curl -X POST https://api.meeting.huaweicloud.com/v1/mmc/management/conferences \\n  -H 'Content-Type: application/json' \\n  -H 'X-Access-Token: your_access_token_here' \\n  -d '{\\n    \"subject\": \"项目评审会议\",\\n    \"mediaTypes\": \"video\",\\n    \"startTime\": \"2026-07-10 14:00:00\",\\n    \"duration\": 60,\\n    \"timeZoneID\": \"56\",\\n    \"isAutoRecord\": false,\\n    \"password\": \"123456\",\\n    \"attendees\": [\\n      {\\n        \"name\": \"张三\",\\n        \"phone\": \"+8613800138000\"\\n      }\\n    ]\\n  }'

创建预约会议时，需指定startTime和duration参数，会议将在指定时间开始。会议创建成功后，服务端会返回会议ID、会议密码、主持人密码、入会链接等信息，开发者可将这些信息通过短信、邮件等方式通知与会者。

3.4 会议控制API

会议进行中，开发者可以通过会控API实现对会议的远程控制。主要包括：添加与会者、静音/取消静音与会者、设置多画面布局、申请/释放主持人、锁定/解锁会议、结束会议等。会控操作需要获取会控Token，该Token通过专门的获取会控Token接口获得。

以下是将指定与会者静音的API调用示例：

curl -X PUT https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/participants/mute \\n  -H 'Content-Type: application/json' \\n  -H 'X-Conference-Token: your_conf_token_here' \\n  -d '{\\n    \"conferenceID\": \"987654321\",\\n    \"participantID\": \"participant_id_here\",\\n    \"mute\": true\\n  }'

华为云会议提供的每个服务端REST API都可以在华为云的API Explorer上进行在线调试，极大地方便了开发者在集成过程中的接口验证工作。

4. 客户端SDK集成

4.1 SDK概述与选型

华为云会议的客户端SDK覆盖了主流开发平台，包括Android、iOS、Windows、Mac、Electron、HarmonyOS和Web。这些SDK已经实现了会议中的完整UI界面，包括会场画面显示、会议控制功能、桌面共享等，开发者只需要调用少量接口即可完成集成。

不同平台SDK的功能支持略有差异。桌面端（Windows/Mac）和移动端（Android/iOS）功能最为完整，支持登录、会议预约、会控等全量功能。HarmonyOS SDK功能与Android/iOS基本对齐。Web SDK主要作为辅助接入能力，功能相对精简，仅支持通过会议ID或会议链接加入会议，不支持登录、预约等管理功能。

各平台SDK的功能对比如下：

• 基础功能：Windows/Mac/Android/iOS/HarmonyOS支持登录和第三方通讯录，Web不支持
• 会议管理：桌面端和移动端支持会议预约、创建、编辑、取消、查询会议详情等，Web不支持
• 加入会议：所有平台均支持通过会议ID加入会议和通过会议链接（Random码）加入会议
• 被邀加入会议：桌面端和移动端支持被邀请入会，Web不支持

4.2 Android SDK集成

Android SDK提供了一套完整的API接口集合，开发者可通过调用这些API快速集成音视频会议功能。在开始集成之前，需要先下载Android SDK开发包，Demo源代码包含在SDK包中。

Android SDK的初始化必须在主线程中调用。初始化完成后，即可调用创建会议、加入会议等核心接口。以下是一个使用Android SDK创建即时会议的代码示例：

// 创建会议参数\\nCreateConfParam createConfParam = new CreateConfParam();\\ncreateConfParam.setSubject(\"项目评审会议\");\\ncreateConfParam.setMediaType(MediaType.VIDEO);\\ncreateConfParam.setPassword(\"123456\");\\ncreateConfParam.setAttendeeList(attendeeList);\\n\\n// 调用创建会议接口\\nHWMSdk.getOpenApi().createConf(activity, createConfParam, new HwmCancelableCallBack() {\\n    @Override\\n    public void onSuccess(Void aVoid) {\\n        // 创建会议成功\\n    }\\n    \\n    @Override\\n    public void onFailed(int errorCode, String errorMsg) {\\n        // 创建会议失败\\n    }\\n});

加入已有会议同样简单，只需传入会议ID和密码即可。需要注意的是，登录并非必须步骤，在不登录的情况下也能通过会议ID和密码加入已创建的会议。开启共享、结束共享、离开会议、结束会议等操作，SDK的UI上已经提供了对应的功能按钮，如果App不需要程序化控制这些功能则无需额外调用接口。

4.3 iOS SDK集成

iOS SDK同样提供了完整的API集合，支持创建、预约、加入会议以及屏幕共享等功能。iOS SDK的初始化必须在主线程调用。以下是通过会议ID加入已存在会议的代码示例：

HWMJoinConfParam *joinParam = [[HWMJoinConfParam alloc] init];\\njoinParam.confId = @\"987654321\";\\njoinParam.password = @\"123456\";\\njoinParam.displayName = @\"张三\";\\n\\n[HWMSdk.getOpenApi joinConf:joinParam callback:^(NSError *error) {\\n    if (error) {\\n        // 加入会议失败\\n    } else {\\n        // 加入会议成功\\n    }\\n}];

4.4 Windows SDK集成

Windows SDK提供了完整的音视频会议能力，包括创建/预约/加入会议、屏幕共享、程序共享、白板标注、全场静音等功能。Windows SDK集成时需要注意：SDK接口中的字符串参数需要编码为UTF-8格式。

Windows SDK的初始化示例如下：

HwmInitInfo initParam;\\nmemset(&initParam, 0, sizeof(HwmInitInfo));\\n// 初始化参数配置\\ninitParam.notify = &g_notify;  // 设置回调通知\\ninitParam.logPath = L\"C:\\\\Logs\\\\Meeting\";\\ninitParam.dataPath = L\"C:\\\\Data\\\\Meeting\";\\n\\nint ret = InitSdk(&initParam);\\nif (ret != 0) {\\n    // 初始化失败\\n}

初始化完成后，使用JoinConfById接口加入会议，并实现对应的回调函数和消息通知。

4.5 Web SDK集成

Web SDK提供了一套完整的JSApi接口集合，开发者可以在自己的Web应用中快速集成音视频会议功能，包括加入/离开会议、会控操作、界面定制等。Web SDK有两种引入方式：通过script标签引入或通过npm模块化方式引入。

方式一：Script标签引入

<script src=\"./HWMeeting.js\"></script>\\n<!-- 需同时引入SDK依赖的第三方库 -->\\n<script src=\"./react.development.js\" crossorigin></script>\\n<script src=\"./react-dom.development.js\" crossorigin></script>

方式二：npm模块化引入

// 安装HWMeeting模块\\nnpm install https://esdk.obs.cn-north-1.myhuaweicloud.com/huaweimeeting/hwmeeting-1.0.20.tgz\\n\\n// 在代码中引入\\nimport * as HWMeeting from 'hwmeeting';\\n\\n// 获取SDK版本\\nconsole.log(HWMeeting.getVersion());\\n\\n// 检测浏览器兼容性\\nconst result = await HWMeeting.checkSystemRequirements();

Web SDK受浏览器安全策略限制，仅支持通过https://域名方式访问，或在本地搭建服务器通过localhost访问，否则无法获取摄像头及麦克风权限。Web端只能主动加入会议，无法被邀请加入会议。

以下是通过Web SDK加入会议的示例：

// 设置服务器地址（中国站）\\nHWMeeting.setServerConfig({\\n    serverAddr: 'meeting.huaweicloud.com'\\n});\\n\\n// 加入会议\\nHWMeeting.joinConf({\\n    confId: '987654321',\\n    password: '123456',\\n    displayName: '张三'\\n}).then(() => {\\n    console.log('入会成功');\\n}).catch((error) => {\\n    console.error('入会失败', error);\\n});

5. Scheme应用集成

Scheme应用集成是最轻量级的对接方式，通过URL Protocol直接拉起华为云会议客户端并执行特定操作。第三方应用（包括Web页面或终端App）可以通过定义好的URL参数，实现拉起App、拉起App并登录、加入会议等操作。

这种集成方式的典型应用场景是：第三方系统在自有页面上提供"加入会议"按钮，用户点击后自动拉起本地已安装的华为云会议客户端，并直接进入指定的会议房间。

URL Scheme的格式如下：

cloudmeeting://join?confId={会议ID}&password={会议密码}&displayName={显示名称}

服务器地址可通过参数指定：中国站使用meeting.huaweicloud.com，国际站使用intl.meeting.huaweicloud.com。若希望以主持人身份入会，必须在参数中传入主持人密码；若以来宾身份入会，当会议要求来宾密码时需传入来宾密码。

在未登录场景下调用该链接，会进入华为云会议App主界面，登录的账号是获取Token时的账号。在已登录场景下则会直接进入会议。

6. 企业SSO单点登录配置

对于已经拥有自有身份认证系统的企业，华为云会议支持通过SSO（Single Sign-On）实现与企业认证系统的对接。配置SSO登录生效后，企业用户登录华为云会议客户端或管理平台将直接使用企业内认证的账号。

SSO登录需要满足以下前提条件：

• 企业需为付费版用户
• 企业自主规划的域名在华为云会议系统中必须唯一
• 企业认证系统需支持OAuth2.0协议
• 企业需将华为云会议的回调地址配置到企业认证系统中
• 需从企业认证系统获取Client_ID、Client_Secret、鉴权中心URL、获取Token URL、用户信息查询URL等参数

配置步骤如下：

1. 登录华为云会议管理平台
2. 在左侧菜单栏进入"高级 > 开放性设置"界面
3. 单击"SSO登录 > 编辑"并配置相关参数

配置参数包括企业域名、APP ID（来源于企业认证系统Client_ID）、APP密钥、鉴权中心URL、获取Token URL、用户信息查询URL等。同时还需要配置字段映射关系，指定第三方账号字段名称、第三方access token字段名称、第三方姓名字段名称等。

配置完成后，企业用户即可在华为云会议客户端选择SSO登录方式，输入企业域名后跳转至企业认证页面完成身份验证。

7. 典型集成场景与实践

7.1 场景一：第三方系统预约会议并拉起客户端

这是最常见的企业集成场景。企业自有业务系统通过调用华为云会议服务端的REST API预约会议，然后在业务页面上生成一个"加入会议"链接，用户点击链接后自动拉起华为云会议客户端并入会。

该场景的完整流程如下：

1. 业务系统调用服务端创建会议API，传入会议主题、时间、与会者等信息
2. 会议服务端返回会议ID、密码、入会链接等数据
3. 业务系统将会议信息展示在页面上，生成"加入会议"按钮
4. 用户点击按钮，通过Scheme URL拉起华为云会议客户端
5. 客户端自动入会，用户开始会议

这种方式的优势在于：会议管理在业务系统中完成，用户体验无缝流畅，且无需在App中集成SDK。

7.2 场景二：第三方App通过UI SDK集成

如果需要在自有App中嵌入完整的会议界面，应选择客户端UI SDK集成方式。开发者只需在App中开发对应的入口页面并调用SDK的预约会议、创建会议、加入会议等接口，入会后的所有会控操作均由SDK提供的UI界面完成，无需额外开发。

该场景的典型集成步骤如下：

1. 下载对应平台的SDK开发包，Demo源代码包含在SDK包中
2. 运行Demo体验完整功能，验证开发环境的正确性
3. 将SDK集成到自有App工程中
4. 在App中调用SDK接口实现创会、入会等功能
5. 进行功能调试和测试
6. 商用发布

SDK中已经集成了入会后的完整UI，包括会场画面显示、会议控制功能、桌面共享等，开发者只需少量接口调用即可完成集成。

7.3 场景三：服务端API实现会议全流程管理

对于需要完全自动化管理会议流程的场景，可以纯后端方式调用服务端API实现会议的全生命周期管理。典型能力包括：

• 通过API创建即时会议或预约会议
• 通过API编辑或取消预约会议
• 通过API查询会议列表及会议详情
• 通过会控API邀请与会者、静音、结束会议等
• 通过Websocket或Webhook接收会议状态推送

这种方式适用于需要将会议管理深度集成到企业OA、CRM、项目管理等后台系统中的场景。

8. 常见问题与注意事项

8.1 开发注意事项

在对接开发过程中，有几点需要特别注意：

• App ID和App Secret是核心凭证，必须妥善保管，严禁硬编码在客户端代码中
• 服务端API调用的accessToken具有有效期，需实现Token的刷新机制
• 客户端SDK的初始化必须在主线程调用
• Windows SDK接口中的字符串参数需编码为UTF-8格式
• Web SDK仅支持HTTPS协议或localhost访问
• UI SDK提供一年的维护周期，建议及时升级到最新版本

8.2 常见问答

问1：App ID鉴权失败如何处理？

首先检查App ID和App Secret是否正确，其次确认签名算法是否正确，确保timestamp参数与服务端时间误差在合理范围内。还可以通过API Explorer在线调试接口验证参数。

问2：SDK初始化后调用接口无响应？

确认初始化是否在主线程完成，检查初始化返回码是否为成功状态。同时确认SDK版本与开发环境是否匹配。

问3：Web SDK无法获取摄像头和麦克风权限？

检查页面是否通过https://域名访问，或通过localhost访问。浏览器安全策略限制非安全上下文下的媒体设备访问。

问4：服务端API调用返回认证错误？

检查HTTP Header中是否携带了正确的X-Access-Token，确认Token是否已过期。如果Token过期，需要重新调用鉴权接口获取新的Token。

问5：如何调试服务端API？

华为云会议的所有服务端REST API都可以在华为云API Explorer上进行在线调试，无需编写代码即可验证接口参数和返回值。

问6：企业SSO配置后无法登录？

检查企业认证系统是否支持OAuth2.0协议，确认回调地址配置是否正确，验证Client_ID和Client_Secret是否有效。