华为云用户手册

开放性应用实践概览 华为云会议提供了服务端API开放和客户端SDK开放，开发者基于自己的应用场景可以灵活地集成华为云会议的开放性接口。本文介绍了几个基于华为云会议集成的最佳实践，帮助开发者了解几种典型场景下的集成方案，以管窥豹，快速掌握基于华为云会议的集成开发能力。 图1 开放性应用实践概览 表1 服务端API集成实践 实践 应用场景 实践1：鉴权登录 服务端API调用前需要鉴权登录后获取接入Token，开放者通过App ID鉴权接口完成鉴权登录，并获取接入Token。 实践2：创建会议 服务端创建会议：用户已有的管理系统可集成华为会议服务的会议管理接口，可以调用服务端API创建会议。 客户端创建会议：用户可以在客户端上直接创建立即开始的会议或者预约会议。 实践3：加入会议 服务端拉起与会者：调用服务端API，添加与会者。与会者收到会议来电并加入会议。 客户端主动入会：用户可以，通过输入会议ID/密码入会；单击邮件链接入会；单击Web链接入会；在微信/微信小程序中单击链接入会。 实践4：离开会议 服务端结束会议：调用服务端API，结束会议。 客户端离开/结束会议：用户在会中界面上结束会议和离开会议。

集成客户端UI SDK 下载客户端SDK开发包以及二次开发文档。 在集成开发客户端SDK的过程中，除本开发指南外，开发者还需要查看本《客户端SDK参考》。 请参考《客户端SDK参考》中的“资源下载”获取SDK开发包，Demo源代码在SDK包中。 试用Demo。 华为云会议为每个平台SDK提供了Demo安装包，开发者可以下载Demo，快速体验功能的运行和调试。 请参考《客户端SDK参考》中每个平台SDK下的“Demo安装包下载”试用Demo。 准备开发环境。 开发环境准备 不同平台的开发工具及环境要求。详见《客户端SDK参考》中对应平台下的“快速入门”。 调测环境准备 订购华为云会议服务后或者申请免费试用账号后，调用客户端SDK。 调用SDK集成开发。 开发者可以在自己对应要开发的平台上集成华为云会议对应平台的SDK接口。 详细开发方法参见《客户端SDK参考》。 功能调试。 开发完成后，可以接入华为云会议调试环境进行功能调试。

最佳实践1：鉴权登录 开发者集成华为云会议服务端API时，推荐使用App ID鉴权方式，鉴权通过后可以获取接入Token。第一次鉴权通过后，华为云会议后台会自动为第三方的用户应用分配一个华为云会议账号。 图2 APP ID鉴权 登录成功后，华为云会议会自动给第三方应用分配华为云会议账号。这个绑定关系由华为云会议维护，第三方开发者不用关注华为云会议账号。 表2 第三方账号和华为云会议账号的映射关系 第三方账号 华为云会议账号 15012345678 Auto-94b91e94ce3f4ddab9ecfe7625418e60 18012345678 Auto-7700ebc37cf580a680cdfde4b34b41d0

集成服务端REST API 下载服务端集成开发工具以及二次开发文档。 在集成开发服务端API的过程中，除本开发指南外，开发者还需要参考《服务端API参考》。 准备开发环境。 订购华为云会议服务，基于业务账号调用服务端API，接入地址是“https://api.meeting.huaweicloud.com”。 集成登录鉴权。 第三方系统在直接调用云会议功能前，需要先调用鉴权接口，完成第三方应用账号向会议服务端的鉴权。详细开发方法参见《服务端API参考》中的“登录鉴权”章节。 图17 服务端鉴权集成 调用REST接口集成开发。 在完成鉴权调用后，开发者可以在第三方应用系统上集成华为云会议的服务端功能接口。 详细开发方法参见《服务端API参考》。 功能调试。 开发完成后，可以接入华为云会议调试环境（https://api.meeting.huaweicloud.com）进行功能调试。 华为云会议提供的每个服务端REST API都可以在华为云的 API Explorer 上调试。

返回403状态码 访问 CDN加速 后的资源，返回403状态码，请您排查以下配置： 请确认您的源站能否正常访问，测试步骤详见排查访问异常是CDN节点问题还是源站问题。 请确认您的加速 域名 CNAME配置是否正确，请确认CNAME与加速域名匹配，如下图所示，配置CNAME的具体操作请参考：配置CNAME域名解析。 如果您设置了referer防盗链，请确认您的访问地址是否符合referer防盗链规则，访问请求到达CDN节点后，CDN节点会根据配置的referer黑白名单规则，对访问者的身份进行识别和过滤，符合规则的可以顺利访问到该内容。如果不符合规则，该访问请求将会被禁止，返回403禁止访问的错误信息。具体规则请参考防盗链配置。 如果您的源站为OBS桶，源站配置了referer防盗链白名单，且不允许为空，而CDN侧未配置referer防盗链白名单。如果原始请求不带referer防盗链规则，cdn回源时也不携带referer防盗链规则，将导致CDN无法回源而返回403状态码，请在OBS侧修改referer防盗链规则，配置方法请参考防盗链配置。 如果您的源站为OBS私有桶，且未在CDN侧开启OBS委托授权，访问会返回403。请在CDN侧开启OBS委托授权，配置方法请参考OBS委托授权。 如果您设置了IP黑白名单，请确认您的IP黑白名单配置，如果您的访问地址在IP黑名单（或者没有在白名单）中，访问请求将会被禁止，返回403禁止访问的错误信息。具体规则请参考IP黑名单配置。 如果您设置了UA黑白名单，请确认您的UA黑白名单配置，如果您的访问地址在UA黑名单（或者没有在白名单）中，访问请求将会被禁止，返回403禁止访问的错误信息。具体规则请参考UA黑名单配置。 如果您设置了URL鉴权，请确认您的鉴权有效时间，如果终端用户访问URL的时间在鉴权有效时间范围以外，该访问请求会返回将会被禁止，返回403禁止访问的错误信息。具体规则请参考URL鉴权。

返回404状态码 访问CDN加速后的资源，返回404状态码，请按照以下步骤排查： 测试源站的URL访问是否404，排查是否是源站异常，测试步骤详见排查访问异常是CDN节点问题还是源站问题。 如果源站访问正常，请登录CDN控制台，在域名基本配置中检查回源HOST是否正确，详见回源HOST。 源站与回源HOST的区别如下所示： 源站：源站决定了用户回源时访问的地址，即源站服务器IP。 回源HOST：回源HOST决定了回源时访问到该IP地址上的具体站点。 示例：源站IP为x.x.x.x，加速域名www.example.com，源站中部署了多个站点：www.a.com、www.b.com。 如果您想要CDN回源到本服务器，您需要在CDN侧将源站配置为：x.x.x.x。 CDN默认回源HOST为加速域名www.example.com。如果您需要访问到的站点为www.a.com，您就需要将回源HOST配置为www.a.com；如果您需要访问到的站点为www.b.com，您就需要将回源HOST配置为www.b.com。 如果您的源站是OBS桶，则回源HOST必须是OBS桶域名。 如果您的源站为第三方对象存储桶，您需要将回源HOST修改为您的对象存储桶域名。 检查源站配置是否正确，登录CDN控制台，在域名基本配置中检查源站的配置是否为该域名的源站服务器，如果不是，请修改成对应的服务器IP或域名。

排查步骤 检查域名是否接入CDN加速 如果您刚在控制台添加加速域名，正在做配置CNAME前的本地测试加速域名工作，请忽略本步骤，参照快速入门流程配置即可。 您需要检查域名是否解析到CDN，以Windows操作系统为例，打开cmd程序，输入如下指令： nslookup -qt=cname 加速域名 如果返回结果显示CNAME，则表示CNAME配置已经生效，如下图： 如果查询出的域名解析中没有上图红框中所示，后缀为.c.cdnhwc1.com的CNAME解析记录，则说明您添加的域名的CDN加速未生效。此种情况下CDN加速未生效的可能原因是您没有在域名DNS服务商处配置CNAME记录，请根据配置CNAME内容指导前往您的域名DNS服务商处配置CNAME记录。 如果您确认已正确配置CNAME记录，请检查同一解析线路下该域名的上一记录类型的TTL时间，TTL时间决定了解析记录在本地DNS服务器的缓存时间。您新添加的CNAME记录在上一记录类型的本地TTL缓存时间过期后才会正式生效。 查看是否命中CDN缓存 在浏览器Chrome上，按F12，选择“Network”。查看指定URL的响应头，查看头部信息，进行如下判断： 如果有“x-hcs-proxy-type”头部，值为“1”即命中缓存，值为“0”即未命中缓存，不再查看其它头部； 如果无“x-hcs-proxy-type”头部，而有“X-Cache-Lookup”头部，值为“Hit From MemCache”、“Hit From Disktank”或“Hit From Upstream”即为命中缓存，其它值表示未命中缓存，不再查看其它头部； 如果同时无“x-hcs-proxy-type”、“X-Cache-Lookup”头部，有“age”头部，则值大于“0”即命中缓存，值为“0”即未命中缓存。 如果未命中缓存，请跳到4. 检查缓存规则设置查看缓存规则设置。 如果命中缓存，请进入下一步分析。 是否跨运营商和跨省 如果用户访问跨省和跨运营商，可能会影响访问速度，请按照以下步骤排查： 在客户端打开华为云CDN用户诊断系统，输入您的加速域名，单击“检测”，获得客户端IP、LDNS。 根据客户端IP和LDNS分析是否跨运营商和跨省。如果使用了代理，可能会出现跨运营商和跨省，影响访问效果。 示例1：用户在河北使用广电网络访问，但IP是北京联通，LDNS又是石家庄电信，访问速度就会较慢，跨运营商对网速的影响很大。 示例2：用户在北京使用广电网络访问，但IP是北京联通，LDNS又是广东电信，用户访问加速域名时CDN调度系统会根据LDNS匹配最近的广东节点，导致访问速度较慢。 华为云CDN目前支持的运营商有电信、联通、移动、铁通、教育网、鹏博士等。 检查缓存规则设置 检查所访问的资源对应的缓存规则，是否存在配置的缓存过期时间为0或者缓存过期时间过短的情况。CDN不缓存或者缓存过期时间过短会导致请求回源，无法达到加速效果。 检查您的源站缓存设置，如果源站设置了no-cache、private、no-store，CDN侧同时开启了“缓存遵循源站”功能（此功能默认关闭），CDN将无法缓存源站资源，导致所有请求回源，无法达到加速效果。 检查您设置缓存规则的优先级，数值越大优先级越大，系统会优先匹配。 如果您的URL携带了参数，并且参数不断变化，当使用不同的URL去访问的时候，CDN会认为这是一个新请求（即使这两个不同的URL访问的是同一个文件，并且该文件已经缓存在节点上），依然会回源请求该资源。如果携带不同的参数的URL访问的是同一个资源，建议开启忽略URL参数功能，请参见URL参数。 更多缓存设置请参考如何设置缓存过期时间。 检查资源是否预热 如果您是首次访问某资源，且之前未对该资源做过预热处理，CDN节点会回源请求资源，首次访问速度慢属于正常。 首次接入CDN后，建议您预热大文件或者视频，图片、小文件等不建议预热。 检查客户端网络 ping CDN加速后访问依然较慢的域名，检查网络时延和丢包。如果网络时延大或者丢包严重，需要检查客户端网络接入问题。 检查是否存在跨境访问 仅开通了中国大陆境内加速：如果域名的服务范围为中国大陆，此时所有客户端请求均会调度到中国大陆的节点，此时中国大陆境外用户访问域名时，受跨境网络影响，加速效果不太明显，甚至无法访问。 源站位置和服务范围不一致： 如果域名的源站地址在中国大陆境外，服务范围为中国大陆，此时客户端请求回源时受跨境网络影响，加速效果不太明显，甚至无法访问。 如果域名的源站地址在中国大陆境外，服务范围为全球，那么中国大陆用户访问该域名下的资源时，将调度到中国大陆的节点，如果节点未缓存该资源，此时客户端请求回源时受跨境网络影响，加速效果不太明显，甚至无法访问。 如果排除以上几点后问题仍然存在，请联系客服或提交工单处理。

排查步骤 检查故障是源站的问题还是CDN节点的问题，请参照排查访问异常是CDN节点问题还是源站问题排查。 检查域名是否接入CDN加速 如果您刚在控制台添加加速域名，正在进行配置CNAME解析前的测试，请忽略本步骤，参照快速入门流程配置即可。 您需要检查域名是否解析到CDN，以Windows操作系统为例，打开cmd程序，输入如下指令： nslookup -qt=cname 加速域名 如果返回结果显示CNAME，则表示CNAME配置已经生效，如下图： 如果返回结果没有.c.cdnhwc1.com，说明域名未解析到华为云CDN。建议您先执行本地测试加速域名，测试成功后，在DNS域名提供商修改解析记录，配置CDN提供的CNAME，配置步骤请参见配置CNAME 。 如果您确认已正确配置CNAME记录，请检查同一解析线路下该域名的上一记录类型的TTL时间，TTL时间决定了解析记录在本地DNS服务器的缓存时间，您新添加的CNAME记录在上一记录类型的本地TTL缓存时间过期后才会正式生效。 如果域名解析无异常，请进行下一步排查。 排查CDN状态码和域名配置 如果您的域名经过CDN加速后返回4xx、5xx、301/302状态码，请参照以下情况处理： 域名经过CDN加速后返回4xx，请参照访问CDN加速资源后返回4XX状态码。 域名经过CDN加速后返回5xx，请参照访问CDN加速资源后返回5XX状态码。 域名经过CDN加速后返回301/302，请参照访问CDN加速资源后无限循环301/302状态码。 检查源站配置是否正确，登录CDN控制台，在域名基本配置中检查源站的配置是否为该域名的源站服务器，如果不是，请修改成对应的服务器IP或域名。 检查账户余额 当您的账户欠费进入保留期后，系统将停用加速域名，您将无法使用CDN。您可以前往费用中心查看账户的费用信息，并通过充值来核销欠款。 如果经过以上排查仍无法解决您的问题，请您联系客服或提交工单处理。并提供以下信息： 在客户端使用华为云CDN用户诊断系统，输入加速域名，单击检测，将结果截图。 无法访问的URL。 访问异常的时间。

状态码说明及处理建议 状态码 描述 处理建议 200 请求正常。 - 301 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 - 302 资源被临时移动。 - 304 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 - 400 服务器未能处理请求。 请检查请求语法或者参数是否正确。 401 被请求的页面需要用户名和密码。 请使用账号登录后访问。 403 对被请求页面的访问被禁止。 请检查是否配置referer黑白名单、IP黑白名单、鉴权等访问控制功能。详细说明请见访问CDN加速资源后返回4XX状态码。 404 服务器无法找到被请求的页面。 请检查源站是否正常或者源站信息、回源HOST配置是否配置正确。 请检查源站资源是否不存在该资源。 详细说明请见访问CDN加速资源后返回4XX状态码。 405 请求中指定的方法不被允许。 请在控制台-高级配置-HTTP header配置中，设置Access-Control-Allow-Methods，添加业务所需的请求方法。详细说明请见访问CDN加速资源后返回4XX状态码。 406 服务器生成的响应无法被客户端所接受。 请检查源站响应header头中Accept的值是否正确，是否不在客户端接受的范围内。 407 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 请检查业务是否设置特殊的鉴权。 408 请求超出了服务器的等待时间。 请检查客户端发送请求逻辑。 409 由于冲突，请求无法被完成。 冲突通常发生于对PUT请求的处理中，请检查上传的文件。 416 客户端请求的范围无效。 请检查客户端的range请求范围是否超出资源大小。 499 客户端主动断开连接。 请检查客户端状态或超时时间设置。 500 请求未完成。服务异常。 请检查源站是否正常。详细说明请见排查访问异常是CDN节点问题还是源站问题。 501 请求未完成。服务器不支持所请求的功能。 请检查客户端的请求方法是否正确。 502 请求未完成。服务器从上游服务器收到一个无效的响应。 请检查业务源站是否正常。详细说明请见访问CDN加速资源后返回5XX状态码。 503 请求未完成。系统暂时异常。 请检查业务源站是否正常。 504 网关超时。 请检查业务源站是否正常、是否超负载。详细说明请见访问CDN加速资源后返回5XX状态码。

故障概览 本文列举了使用CDN的过程中部分常见故障场景，单击链接可查看更详细的排查步骤。 故障现象 可能的原因 购买了流量包，还会扣除余额 计费方式还不是按流量计费。 域名的业务类型为全站加速。 购买流量包的区域不对。 使用量超出了流量包的流量包规格。 接入CDN后，网站无法访问或视频无法播放 源站故障。 域名未接入CDN。 域名配置不当。 账号欠费。 接入CDN后，网页显示的内容/下载文件/播放的视频不正确 缓存规则设置有误。 本地缓存问题。 资源更新后节点未刷新。 多个源站文件不一致。 访问资源被劫持。 接入CDN后，访问速度仍然很慢 域名未接入CDN加速。 未命中CDN缓存。 存在跨运营商和跨省访问。 缓存规则设置不合理。 加速资源未预热。 客户端网络问题。 流量命中率偏低 源站问题（设置不缓存，动态资源占比高，网站访问量低，源站故障）。 CDN问题（缓存规则设置不合理，频繁执行缓存刷新）。 预热失败 大批量集中预热。 检查缓存过期时间。 源站不允许缓存。 源站是否可以正常访问。 访问CDN加速资源后返回5XX状态码 源站业务故障。 CDN域名配置异常。 源站拦截。 CDN节点异常。 访问CDN加速资源后返回4XX状态码 404排查思路：源站资源缺失、CDN域名配置异常。 403排查思路：域名未接入CDN加速、源站故障、CDN域名设置了拦截。 访问CDN加速资源后无限循环301/302状态码 回源方式和强制跳转配置有误。 状态码说明及处理建议 - CDN权限问题排查 账号权限配置有误。 访问CDN加速域名，无法正常登录或者显示其他用户信息 缓存了动态资源。 不同节点缓存内容不一致 URL参数配置为忽略所有URL参数。 源站资源更新后没有执行缓存刷新操作。 为什么配置的缓存规则没生效 缓存规则配置刚下发，暂未生效（大约5分钟）。 缓存规则设置不当。 接入CDN后，客户端访问时浏览器提示跨域异常 跨域配置不当。 源站是OBS桶，配置CDN加速后，加速域名访问是下载，不是在线展示 OBS的默认规则导致，您需要前往CDN控制台的“域名管理”-高级配置-添加“Content-Disposition”响应头，取值为“inline”。 OBS桶接入CDN后，访问域名会列出所有文件列表 源站是OBS公有桶，未在OBS桶开启静态网站托管。 源站是OBS私有桶，授权访问后默认展示文件列表。

CDN权限问题排查 如果您在使用CDN的过程中，报权限不足或者权限错误，请您按照以下步骤排查： 如果您使用的是 IAM 子账号，报权限不足，请您前往CDN权限管理查看各权限的作用并参考创建用户并授权使用CDN为您的IAM子账号分配相应的权限。 CDN常用权限请见下表： 策略名称 描述 策略类别 CDN Administrator 操作权限：对CDN的所有执行权限。 作用范围：全局级服务。 系统角色 CDN DomainReadOnlyAccess 操作权限：对CDN加速域名信息的只读权限。 作用范围：全局级服务。 系统策略 CDN StatisticsReadOnlyAccess 操作权限：对CDN统计信息的只读权限。 作用范围：全局级服务。 说明： 此策略不能查询运营报表。 系统策略 CDN LogsReadOnlyAccess 操作权限：对CDN日志的只读权限。 作用范围：全局级服务。 系统策略 CDN DomainConfiguration 操作权限：对CDN加速域名的配置权限。 作用范围：全局级服务。 系统策略 CDN RefreshAndPreheatAccess 操作权限：CDN刷新预热权限。 作用范围：全局级服务。 系统策略 CDN FullAccess 操作权限：对CDN的所有执行权限。 作用范围：全局级服务 系统策略 CDN ReadOnlyAccess 操作权限：对CDN的所有只读权限。 作用范围：全局级服务 系统策略 不能单独配置CDN DomainConfiguration和CDN RefreshAndPreheatAccess权限，如果想配置这两个权限，请同时配置CDN DomainReadOnlyAccess权限，否则会造成所有域名不可见导致无法进行域名配置和刷新预热配置。 请查看您的账号是否欠费，如果欠费到了保留期，系统会停用您的加速域名，此时您的CDN业务将停止；如果欠费过了保留期，CDN会释放资源，您的域名将被删除。

可能的原因及应对措施 可能是跨域请求的资源没有响应消息头部信息：Access-Control-Allow-Origin，建议您根据域名需求配置响应消息头部信息，详情可参考HTTP header配置。 为防止因浏览器缓存导致报跨域错误，跨域请求头“Access-Control-Allow-Origin”配置完成后，请您及时清理浏览器缓存。 如果您的域名源站是OBS桶域名且CDN配置了跨域规则，OBS侧也需要同时配置跨域资源共享。

可能的原因 原因一：您在CDN控制台开启了忽略URL参数，同时源站设置了根据URL参数不同返回不同的资源。 当您的源站设置了根据不同URL参数返回不同资源，而CDN侧开启了忽略URL参数，CDN就会忽略参数进行缓存资源，这样就导致不同的节点可能由于首次请求时带的参数不同而缓存不同的资源。当下一次同一个请求访问到不同的节点，收到的返回数据也会不同。 原因二：源站资源更新后没有执行缓存刷新操作。 如果您的源站更新了某个资源，而这个资源的访问URL没有变化，终端用户访问该资源时如果节点有缓存，就会直接命中缓存。如果您在更新资源后没有执行缓存刷新操作，只有当节点已缓存的资源过期后才会回源请求最新的资源并重新缓存到节点。同时，由于各个地区访问热度不同，淘汰时间不同，有的节点缓存已经淘汰，用户再次访问时，会回源站请求新的资源，有的节点缓存还在，用户访问时直接返回给用户，从而这导致各个节点的缓存可能出现新老版本同时存在，不同节点缓存内容不一致的情况。

可能的原因及应对措施 缓存规则配置生效大约需要5分钟时间，请您在规则生效后再预热资源，然后验证是否命中缓存。 检查您的缓存过期时间是否设置的过小：缓存过期时间设置的太小就会导致频繁回源，如图1所示，请合理设置缓存过期时间。 图1 缓存过期时间设置过小 缓存规则有优先级（数值越大优先级越高），优先级较高的会优先匹配，请检查您的缓存规则优先级。 配置示例：某客户为域名www.example.com配置了文件名后缀为.jpg的规则，希望缓存过期时间为1天，优先级为2。 图2 缓存规则配置 配置结果：当用户访问www.example.com/test/cdn.jpg文件时，有两条规则包含了此文件：文件名后缀、全路径，但是由于全路径的优先级为3，优先级较高，所以系统最终匹配全路径/test/*.jpg这条规则，缓存时间为3秒。 调整方法：如果想要.jpg这条文件名后缀的规则优先生效，需要将优先级调整为大于3的数值。 如果.jpg这条缓存规则开启了“缓存遵循源站”功能，当源站设置了no-cache、private、no-store时CDN节点不缓存源站资源，用户每次访问都需要回源，此时您需要关闭“缓存遵循源站”功能。

为什么视频会出现卡顿？ 网络、设备性能等原因都可能导致视频出现卡顿。若出现视频播放卡顿问题，您可以先参考如下方法进行初步排查。 自检操作，您可以从以下几方面进行排查。 判断是持续性的还是一次性的卡顿。一次性的卡顿是由网络和设备的随机性导致，属于正常现象。 检查网络状态，判断连接是否正常。 如果网络连接正常但依然卡顿，请尝试更换网络连接，检查在网络状态良好的条件下是否依然卡顿。 如果网络良好且条件允许，请尝试更换设备。 如果有视频前处理，例如美颜等，请先关闭前处理，检查卡顿是否由于前处理导致。 通过视镜功能进行端到端链路检查。 若上述方法均无法解决问题，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

Web端如何切换摄像头和麦克风？ 音视频输入设备通过设备ID（deviceId）标识，每个音视频设备均有一个唯一的设备ID，您可以通过getDevices方法获取。设备ID是随机生成的，部分情况下同一个设备的ID可能会改变，因此建议您每次切换设备时都先调用getDevices获取设备ID。您可以先通过getDevices获取到系统的摄像头和麦克风设备后，调用switchDevice进行切换。 父主题： SDK使用

SparkRTC支持哪些平台？ SparkRTC支持的平台有Android、iOS、MAC、Windows和Web。其中支持的各平台系统版本如下所示： Android：支持Android 5.0及以上版本。 iOS：支持iOS 8.0及以上版本。 MAC：支持MacOS10.11或以上版本，x86_64。 Windows：支持Windows 7或以上版本，32位。 Web：支持的浏览器详情请参见Web浏览器适配详情。 父主题： 产品咨询

服务端如何计算Signature？ //认证用的app_key和app_id硬编码至代码中或以明文形式存储会有极大风险。建议密文形式配置存储在文件或者环境变量中，使用时解密，以确保安全。本例以app_key和app_id存放至环境变量为例，运行前请先在本地环境中设置完成环境变量APP_KEY和APP_ID。app_key = System.getenv("APP_KEY");app_id = System.getenv("APP_ID");signature = HMAC256(app_key,(app_id + room_id + user_id +ctime)) 父主题： Signature相关

SparkRTC RoomID是什么？取值区间值是多少？ RoomID是房间ID，房间是一个音视频空间，同一房间内的用户可以互相接收对方的 实时音视频 数据。 SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离； 只有在同一个房间里的用户才可以相互接收音视频； 房间ID的命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合； RoomID由租户自定义。 父主题： 产品咨询

为什么无法打开摄像头？ 摄像头打开失败有多种原因，建议您参照如下方面进行初步排查： 确认摄像头权限是否已打开。Android和iOS系统都有权限管理，请在系统设置中进行检查。同时Android的部分安全软件也会进行权限管理。 检查是否有其他应用占据了摄像头。若有请关闭后，重启手机再打开摄像头。 摄像头硬件问题。打开系统自带的拍摄视频程序看是否可以录像。 若上述方法均无法解决问题，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

什么是Signature？ 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。signature为标识签名，由租户使用华为云SparkRTC提供的“app_key”，按照华为SparkRTC的签名算法自行生成。应用开发者需要向远端服务器获取鉴权签名。具体请参见接入鉴权。 父主题： Signature相关

怎么理解SparkRTC的角色Role？ 角色Role是指用户在房间内的不同角色类型，不同角色类型有不同的权限模型。主要有如下三种角色类型： 主播（publisher）：只发流不收流主播型角色。SparkRTC预留的角色类型。 互动观众（joiner）：既能发流也能收流的互动型角色。 普通观众（player）：只收流的观看型角色。 SparkRTC示例Demo中的角色切换、上台/下台、上麦/下麦主要指在joiner/player两个角色之间进行切换。 父主题： 产品咨询

Web端通话过程中为什么会出现回声、杂音、噪声、声音小？ 通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点。当其他端听到Web端的声音存在回声、噪声、杂音等情况时，说明Web端的3A处理没有生效。 若您使用了浏览器原生getUserMedia接口进行自定义采集，则需要手动设置3A参数，详细设置请参见媒体追踪约束。 echoCancellation：回声消除开关 noiseSuppression：噪声抑制开关 autoGainControl：自动增益开关 若您使用HRTC.createStream接口进行采集，则无需手动设置3A参数，SDK默认开启3A。 父主题： SDK使用

单流录制模式和合流录制模式有什么区别？ 单流和合流录制模式的主要区别如下： 单流录制：支持将房间中的每一个用户的音视频流分别录制成独立的文件。例如，在线课堂场景中，若家长只想观看老师和自己孩子的视频，则可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。单流录制的具体实现方法请参见创建单流录制任务。 合流录制：支持将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。例如，需要录制一个连麦直播时，可以选择合流模式，将所有主播的音视频录制后存储在一个文件中，而无需在录制后通过脚本进行合并。合流录制的具体实现方法请参见创建合流录制任务。 父主题： 录制相关

不同角色的入门流程 根据使用的套餐、用户角色，您可以了解入门流程，选择阅读对应的章节。 免费版 个人用户：注册免费个人会议账号后，可体验客户端会议功能，详细介绍请参见注册免费个人会议账号、体验客户端会议功能。 企业管理员：注册免费个人会议账号并创建企业/组织后成为企业管理员，可邀请同事加入企业/组织、体验客户端会议功能、为企业购买华为云会议资源，详细介绍请参见注册免费个人会议账号、创建企业/组织、邀请同事加入企业/组织、体验客户端会议功能、购买华为云会议。 企业成员：受邀激活华为云会议账号后，体验客户端会议功能，详细介绍请参见受邀者激活账号、体验客户端会议功能。 Flexus版/旗舰版 企业管理员：注册免费个人会议账号并创建企业/组织后成为企业管理员，可邀请同事加入企业/组织、体验客户端会议功能。为企业购买华为云会议资源后，可使用会议资源召开会议，详细介绍请参见注册免费个人会议账号、创建企业/组织、邀请同事加入企业/组织、体验客户端会议功能、购买华为云会议、使用会议资源召开会议。 企业成员：受邀激活华为云会议账号后，可体验客户端会议功能、使用会议资源召开会议，详细介绍请参见受邀者激活账号、体验客户端会议功能、使用会议资源召开会议。

如何处理视频黑屏问题？ 常见的视频黑屏问题有以下三种情况： 本地视频黑屏远端视频正常。 本地视频正常远端视频黑屏。 本地远端视频都黑屏。 可能导致出现视频黑屏的原因如下： 本地网络信号差或者信号中断。 通话中有一方的网络出现问题，其他人也会看不到此用户的视频。 用户主动关闭了视频。 您可以通过视镜功能进行端到端链路检查。 若问题仍未解决，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查

华为云会议账号介绍 华为云会议用户按角色可分为企业管理员、企业普通用户和个人用户。 各角色的账号和权限说明如表1所示。 表1 华为云会议账号介绍 角色 账号 权限说明 个人用户 华为云会议个人账号 免费注册的个人用户，未创建企业或未被邀请加入企业，可使用免费版套餐的资源、体验客户端会议功能。 企业管理员 华为云会议企业默认管理员账号 个人用户创建企业/组织后成为企业默认管理员。 可邀请同事加入企业/组织、体验客户端会议功能、购买华为云会议、使用会议资源召开会议等。 华为云会议企业普通管理员账号 企业默认管理员可添加企业普通管理员，并设置其管理角色、管理范围、管理权限。 华为云会议企业普通管理员可邀请同事加入企业/组织、体验客户端会议功能、使用会议资源召开会议等。 华为云账号 华为云账号用于登录华为云会议控制台。 华为云账号绑定华为云会议账号后，用于购买华为云会议、前往管理平台等。 企业成员 华为云会议企业用户账号 被企业管理员或其他企业成员邀请加入企业的用户，可受邀激活会议账号、体验客户端会议功能、使用会议资源召开会议等。

下载并登录客户端 您可以使用会议管理员账号登录桌面客户端或者移动客户端。 下载客户端。 桌面客户端：请单击下载并安装桌面客户端。 移动客户端：您可以选择以下任一种方式下载移动客户端。 请扫描以下二维码下载安装移动客户端。 图3 下载华为云会议移动端 前往华为云会议客户端下载并安装移动客户端。 前往应用商店或App Store，搜索“华为云会议”。 使用在（可选）创建用户账号中创建的任一用户账号登录华为云会议管理平台。

创建会议 会议与会方数不能超过购买的并发资源数。 在Web端创建会议 使用企业中任一用户账号登录华为云会议管理平台。 在“创建会议”页面，设置会议参数，如下图所示。设置完成后单击“创建”即可。 图4 在管理平台创建会议 在PC客户端创建会议 在“发起会议”页签，选择“会议并发”，单击“保存”并单击“发起会议”即可马上召开会议。 图5 在桌面端创建会议 在手机客户端创建会议 在“发起会议”界面，选择“使用个人会议ID”，单击“立即开始”即可马上召开会议。 图6 在移动端创建会议

会控操作 您可以在华为云会议管理平台“我的会议”页面，找到正在召开的会议，单击“进入会控”进行会议控制。 添加与会方 您可以添加企业通讯录中的联系人/硬件终端，“入会方式”可以选择软终端或手机号入会。 窗口左侧含有导航树，支持按整个部门来邀请。 企业管理员添加了外部联系人后，您在添加与会方时还可以邀请外部联系人加入会议。 您还可以在“其他会场”的文本框中输入其他与会方的号码添加其他联系人或终端。 图9 添加与会者 删除与会方 您可以在“与会者列表”中右键单击想要删除的与会方，然后单击“移除”。 您还可以在“与会者列表”中单击想要删除的与会方所在行的挂断与会方。 图10 删除与会者 静音/取消静音 您可以给与会者取消静音。 单击“取消全场静音”给所有与会方取消静音。 单击“操作”列中取消静音单个与会方。 图11 静音或取消静音 会议共享 PC端发起共享 单击会议界面下方的“共享”，根据需要可选择共享屏幕、白板和程序。 图12 会议共享 更多精彩会控请参见桌面客户端会议控制、移动客户端会议控制、Web端会议控制。 更多会议相关操作请参见Web端会议管理员指南、PC端用户指南、移动端用户指南。