# 实时音视频 SparkRTC

> 低时延、高并发、安全可靠的音视频通话服务

## 服务公告

- [版本规划](https://support.huaweicloud.com/bulletin-rtc/rtc_14_0001.md): 本章节为您介绍实时音视频服务（SparkRTC）客户端SDK的版本支持机制。版本号格式为a.b.c.d，其中：a为大版本号：在版本架构重构的情况下更新。b为小版本号：在重大特性或接口变更的情况下更新。c为月度开发版本号：月度累加。d为release版本号：300开头表示第一个release版本号，补丁版本累加。版本号样例：2.0.9.30
- [【下线公告】实时音视频服务下线客户端SDK](https://support.huaweicloud.com/bulletin-rtc/rtc_14_0002.md): 华为云实时音视频服务计划于2025年6月30日，完全下线客户端SDK，届时此功能将无法再为老用户提供维护和升级能力，新用户不再支持接入。下线区域：所有区域。如您正在使用客户端SDK功能，建议您及时处理完成已有业务，及时备份和保存已有音视频数据，以避免SDK不再维护和升级可能带来的影响。客户端SDK功能下线后，相关文档说明也会同步下线。如您

## 产品介绍

- [什么是实时音视频？](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0001.md): 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。实时音视频 客户端SDK：提供Android、iOS、Windows、Web等平台的SDK，方便用户快速集成开发音视频通话、互动直播等功能。实
- [产品优势](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0002.md): 提供覆盖全球的高质量、大规模的实时音视频网络。 自研高效调度算法，具有全网调度能力。丰富的节点资源储备，保证端到端平均时延小于200ms。基于华为30年音视频编解码能力和优异弱网对抗能力80%丢包下音频通话流畅，50%丢包下视频通话流畅。提供覆盖iOS、Android、Windows、macOS、Web等各平台，兼容适配各类终端。完善示例
- [应用场景](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0003.md): 丰富的一对一教学、小班课、大班课等多种解决方案，轻松构建高品质互动教学体验。高清、低时延、高并发直播，易集成，可快速部署到在线教育视频平台。零距离互动新玩法，助力业务创新、流量变现。适用于网红直播、企业直播、娱乐直播、游戏直播等场景，提供功能强大的实时媒体处理能力，实现各种直播场景玩法，为客户和合作伙伴打造端到端一站式“音视频互动”解决方
- [产品功能](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0004.md): 华为云SparkRTC支持的主要功能如下。关于各功能支持的地域（Region）信息，可通过控制台查询详情。即1对1或多人视频通话，支持720P及以上高清画质。单个房间最多支持2000人同时在线，最高支持500人互动。常见场景：1对1视频通话、视频会议、在线问诊、多人视频聊天、视频客服、视频双录、在线理赔等。即1对1或多人语音通话，单个房间
- [使用限制](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0005.md): 在使用实时音视频前，您需要了解本服务的使用限制。
- [常用概念](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0007.md): 应用标识或应用ID，简称appID，是SparkRTC用来区分不同应用的唯一标识，在SparkRTC控制台中创建应用时自动生成。房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离。只有在同一个房间里的用户才可以相互接收音视频。房间ID的命名规则：可自定义，
- [计费说明](https://support.huaweicloud.com/productdesc-rtc/rtc_01_0008.md): 华为云实时音视频服务的计费详情，请提交工单咨询。

## 快速入门

- [入门指引](https://support.huaweicloud.com/qs-rtc/rtc_02_0001.md): 如需开通购买SparkRTC服务，请提交工单处理。SparkRTC的入门操作流程说明如表1所示。

## 用户指南

- [功能介绍](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0004.md): 在实时音视频控制台，您可以快速进行应用的创建、编辑等管理。同时，还提供了音视频互动质量指标监控服务，方便您进行数据分析。
- [应用管理](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0001.md): 您可以在实时音视频控制台创建应用并查询应用的基本信息，应用创建后，您可以使用应用对应的App ID和域名进入互动频道。首次使用华为云实时音视频服务，请先提交工单联系华为云技术客服进行业务咨询。停用或删除应用会导致业务不可用，请谨慎处理。参数配置说明，如表1所示。应用成功创建后，您可以在应用列表中查看到新创建的应用信息，包括应用名称、应用I
- [配置录制规则](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0006.md): SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。云资源授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许Spark
- [配置录制回调](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0007.md): SparkRTC服务提供了录制任务状态回调设置，支持配置HTTP/HTTPS URL，向用户服务器发送POST请求，将录制任务状态信息实时反馈到用户服务器。请求：HTTP POST请求，请求Body的内容为JSON格式。应答：HTTP STATUS CODE = 200，应答内容为JSON格式，用户可以根据实际需求自定义应答内容。示例如下
- [通话调查](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0010.md): 您可以查看各房间的用户通话质量指标详情，对通话体验和端到端数据进行问题定位和原因分析，有效解决通话质量问题。“通话调查”中的数据仅供数据分析和质量问题查询，计费数据请以账单为准。由于统计数据需要时间，可能会有5分钟以内的延迟。支持查询的时间跨度最长为14天。支持查询最近24小时的实时数据。通话调查中提供的数据包括：设备状态，包括APP C
- [数据洞察](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0011.md): 您可以通过查看通话用量和质量数据，了解通话用量和质量的总体趋势、不同维度的分布情况和每天的数据明细。“数据洞察”中的数据仅供数据分析和质量问题查询，计费数据请以账单为准。支持查询最近90天的历史数据。支持查询的时间跨度最长为31天。用量：支持查看通话时长、房间与用户数据统计、用户通话用量区域分布，以及通话用户所使用的网络类型、操作系统和S
- [实时数据](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0012.md): 您可以查看音视频通话的规模、体验、网络指标的实时数据和分析图表，实时掌握项目整体动态，及时识别异常通话体验和异常根因。“实时数据”中的数据仅供数据分析和质量问题查询，计费数据请以账单为准。由于统计数据需要时间，可能会有5分钟以内的延迟。支持查询最近24小时的实时数据。支持查询的时间跨度最长为24小时。看板：展现项目的实时在线规模、质量水平
- [自动诊断](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0013.md): 您可以实时查看应用下所有通话体验异常的用户信息及异常明细数据，快速识别通话异常的类型和影响因素。由于统计数据需要时间，可能会有5分钟以内的延迟。支持查询最近24小时的实时数据。支持查询的时间跨度最长为24小时。诊断数据图表中可查看的信息主要包含不同异常类型的用户数据、不同异常影响因素的分布和所有通话体验异常的用户详情。总览-RTC展示不同
- [用量统计](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0003.md): 您可以根据应用名称查询近90天的音视频互动时长。“用量统计”非实时刷新，每5分钟统计一次，数据展示可能会有5分钟左右的延迟。支持最大查询跨度31天，最大查询周期90天。您也可以通过在“应用管理”页面的“操作”列，单击“用量”跳转到“用量统计”页面进行查看。统计图中展示了不同分辨率档位（标清/高清/超清）的视频通话时长和纯语音通话时长统计数
- [云资源授权](https://support.huaweicloud.com/usermanual-rtc/rtc_04_0008.md): 您可以将OBS桶授权给SparkRTC服务，允许录制文件存储在OBS桶中。授权的OBS桶所在区域必须为华北-北京四。因录制生成的视频文件是存储在OBS服务中的，因此，您需要先开通OBS服务，具体请参见OBS快速入门。已在OBS服务中创建用于存储录制文件的OBS桶，若未创建，请参见OBS帮助中心创建桶。您也可以通过在“添加录制规则”页面的“

## 最佳实践

- [概述](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0008.md): 华为云实时音视频服务提供的云端录制回放功能适用于需要将音视频通话或互动直播过程进行录制和存储的业务场景。云端录制功能包含两种模式，如表1所示。
- [单流录制](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0009.md): 将房间中的每一个用户的音视频流分别录制成独立的文件。SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。
- [合流录制](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0010.md): 将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。九宫格模板每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置。最多支持25个画面。不同人数
- [环境准备](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0071.md): 详情请参考开发前准备。
- [屏幕分享](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0011.md): 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。共享桌面加入房间后可以调用setAuxiliaryVideoEncoderConfig设置编码参数，其中HRTCVideoAuxiliarEncParam
- [通话中质量监测](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0012.md): 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前本地和远端的音视频统计信息。通话质量上报onNetworkQualityNotify，房间内客户端网络质量实时上报，默认开启，每2s上报一次，两人以上才会回调。@Override public void onNetworkQualityNotify(List<HRTCQual
- [播放音效文件](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0013.md): 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放音效文件调用playAudioClip播放音效文件并启动混音。可以同时播放多个音效文件，
- [播放音乐文件](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0014.md): 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。可以播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放
- [原始音频数据（音频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0015.md): 音视频传输过程中，可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以进行音
- [音频自采集和音频自渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0016.md): 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求：app中已有自己的音频模块。需要使用自定义的采集或播放处理。某些音频采集设备被系统独占。加入房间前加入房间前，调用setExternalAudioCapture，开启音频自采集。public 
- [原始视频数据（视频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0017.md): 音视频传输过程中，可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始视频数据可以进行视
- [自定义视频采集](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0018.md): 实时视频传输过程中，HWRtcEngine SDK通常会启动默认的视频模块进行采集和渲染。在以下场景中，您可能会发现默认的视频模块无法满足开发需求：app中已有自己的视频模块。需要使用自定义的采集或播放处理。某些视频采集设备被系统独占。加入房间前加入房间前，调用setExternalVideoCapture开启视频自采集。public v
- [自定义视频渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0019.md): 实时音视频传输过程中，上层应用可以不用SDK默认的渲染功能，选择对视频帧数据进行自定义渲染。加入房间前加入房间前，调用setExternalVideoFrameOutputEnable开启视频自渲染。public void openExternalVideoOutput() { mHwRtcEngine.setExternalVi
- [加入多频道（跨房）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0020.md): 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。如果使用connection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间
- [环境准备](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0072.md): 详情请参考开发前准备。
- [屏幕共享](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0069.md): 基于苹果的Replaykit方案，支持用户分享整个系统的屏幕内容，但需要App额外提供一个Extension扩展组件，可实现跨应用屏幕共享。由于华为云SparkRTC是通过App Goup进行进程间的数据通信的，所以需要创建一个App Group。使用您的APP ID账号登录https://developer.apple.com/ ，进行
- [通话质量监测](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0021.md): 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。onLocalAudioStatsNotify回调上报本地设备发送音频流的统计信息。您可以了解到当前通话声道数（单声
- [播放音效](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0022.md): 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放音效文件调用playAudioClip接口可以播放一个音效文件。可以同时播放多个音效文件
- [播放音乐](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0023.md): 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放
- [原始音频数据（音频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0024.md): 音视频传输过程中，可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以进行音
- [音频自采集和音频自渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0025.md): 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求：app中已有自己的音频模块。需要使用自定义的采集或播放处理。某些音频采集设备被系统独占。当前只支持PCM数据格式处理。加入房间前调用主引擎的setExternalAudioCapture加入房
- [原始视频数据（视频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0026.md): 音视频传输过程中，我们可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以进
- [自定义视频采集](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0027.md): 如果您需要使用自定义的美颜库或有前处理库，则需要自己采集和处理摄像头拍摄画面，您可以通过SparkRTC SDK的setExternalVideoCapture接口开启 自采集功能。然后使用pushExternalVideoFrame接口推送外部视频数据到SparkRTC SDK播放。加入房间前调用主引擎的setExternalVideo
- [自定义视频渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0028.md): 实时音视频传输过程中，上层应用可以不用SDK默认的渲染功能，选择对视频帧数据进行自定义渲染。加入房间前开启视频自渲染加入房间前调用接口setExternalVideoFrameOutputWithFormat 打开视频自渲染功能。//开启远端或者本地的视频自渲染 HwRtcImageBufferFormat * fileFormat = 
- [加入多频道（跨房）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0029.md): 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。如果使用connection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间
- [环境准备](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0073.md): 详情请参考开发前准备。
- [屏幕分享](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0050.md): 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面，也可以共享某一个程序窗口。共享程序窗口的时候还可以指定共享该程序窗口的矩形区域。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。共享桌面加入房间后可以调用getScreenSh
- [通话质量监测](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0051.md): 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。onLocalAudioStatsNotify回调上报本地设备发送音频流的统计信息。您可以了解到当前通话声道数（单声
- [播放音效](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0052.md): 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。支持播放wav、pcm和单声道mp3音频文件，支持本地或在线文件路径。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放音效文件调用playAudioClip接口可以播放一个音效文件。可以同时播放多个音效文件，不同音
- [播放音乐](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0053.md): 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放音乐文件
- [原始音频数据（音频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0054.md): 音视频传输过程中，可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以进行音
- [音频自采集和音频自渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0055.md): 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求：需要使用自定义的采集或播放处理。某些音频采集设备被系统独占。加入房间前调用主引擎的setExternalAudioCapture加入房间前调用此接口打开自采集功能。[_rtcEngine se
- [原始视频数据（视频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0056.md): 音视频传输过程中，我们可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK 提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以
- [自定义视频采集](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0057.md): 如果您需要使用自定义的美颜库或有前处理库，则需要自己采集和处理摄像头拍摄画面，您可以通过SparkRTC SDK的setExternalVideoCapture接口开启 自采集功能。然后使用pushExternalVideoFrame接口推送外部视频数据到SparkRTC SDK播放。加入房间前调用主引擎的setExternalVideo
- [自定义视频渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0058.md): 实时音视频传输过程中，上层应用可以不用SDK默认的渲染功能，选择对视频帧数据进行自定义渲染。加入房间前开启视频自渲染加入房间前调用接口setExternalVideoFrameOutputWithFormat 打开视频自渲染功能。//开启远端或者本地的视频自渲染 HwRtcImageBufferFormat * fileFormat = 
- [加入多频道（跨房）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0059.md): 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。如果使用connection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间
- [环境准备](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0074.md): 详情请参考开发前准备。
- [屏幕分享](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0030.md): 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面，也可以共享某一个程序窗口。共享程序窗口的时候还可以指定共享该程序窗口的矩形区域。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。共享桌面加入房间后可以调用getScreenSh
- [通话质量监测](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0031.md): 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。onLocalAudioStatsNotify回调上报本地设备发送音频流的统计信息。您可以了解到当前通话声道数（单声
- [播放音效](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0032.md): 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。播放音效文件调用playAudioClip接口可以播放一个音效文件。可以同时播放多个音效文件
- [播放音乐](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0033.md): 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。加入房间参考接口调用步骤中加入房间的时序图步骤加入房间。参考接口调用步骤中加入房间的时序图步骤加入房间。播放音乐文件
- [原始音频数据（音频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0034.md): 音视频传输过程中，我们可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK 提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以
- [音频自采集和音频自渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0035.md): 实时音频传输过程中，HWRtcEngine SDK 通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求：app中已有自己的音频模块。需要使用自定义的采集或播放处理。某些音频采集设备被系统独占。加入房间前调用主引擎的setExternalAudioCapture (true)加入房间前调用此接口
- [原始视频数据（视频前后处理）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0036.md): 音视频传输过程中，可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。对于有自行处理音视频数据需求的场景，HWRtcEngine SDK提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。原始音频数据可以进行视
- [自定义视频采集](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0037.md): 如果您需要使用自定义的美颜库或有前处理库，则需要自己采集和处理摄像头拍摄画面，您可以通过SparkRTC SDK的setExternalVideoCapture接口开启自采集功能。然后使用pushExternalVideoFrame接口推送外部视频数据到SparkRTC SDK播放。加入房间前调用主引擎的setExternalVideoC
- [自定义视频渲染](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0038.md): 实时音视频传输过程中，上层应用可以不用SDK默认的渲染功能，选择对视频帧数据进行自定义渲染。加入房间前开启视频自渲染加入房间前调用接口setExternalVideoFrameOutput打开视频自渲染功能。//开启远端或者本地的视频自渲染 HRTCImageBufferFormat fileFormat; fileFormat.form
- [加入多频道（跨房）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0039.md): 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。如果使用connection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间
- [环境准备](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0075.md): 详情请参考开发前准备。
- [屏幕分享](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0040.md): 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面，也可以共享某一个程序窗口。加入房间参考接口调用流程中加入房间的时序图步骤加入房间。参考接口调用流程中加入房间的时序图步骤加入房间。创建并播放共享流入会后调用isScreenShareSupported检测浏览器是否支持共享流。确认支
- [通话质量监测](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0041.md): 加入房间后，SDK上报通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。network-quality网络上下行质量报告事件，用户加入房间后，在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。示例代码如下：this.client.on('network-quality', (networkQua
- [播放音频文件（混音）](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0042.md): 混音是将音频文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音频文件，播放给房间内的其他用户听。支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。加入房间并发布本端主流参考接口调用流程中加入房间的时序图步骤加入房间，并发布本地主流。参考接口调用流程中加入房间的时序图步骤加入
- [切换音频模式](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0043.md): 用户在入会前可通过调用enableTopThreeAudioMode切换为音频最大三方模式。会中通过调用switchAudioMode(2)将音频切换为订阅模式。订阅模式下，本地用户必须通过主动订阅远端用户音频流，才可接收该用户音频。会中通过调用switchAudioMode(3)将音频切换为最大三方模式。最大三方模式下，本地用户不需要单
- [修订记录](https://support.huaweicloud.com/bestpractice-rtc/rtc_08_0070.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## API参考

- [使用前必读](https://support.huaweicloud.com/api-rtc/rtc_07_0001.md): 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应用管理、合流任务管理等。支持的全部操作请参见API概览。在调用华为云实时音
- [API概览](https://support.huaweicloud.com/api-rtc/rtc_07_0002.md): 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。
- [构造请求](https://support.huaweicloud.com/api-rtc/rtc_07_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。请求URI由如下部分组成：{URI-scheme}://{Endpoint}/{resource-pat
- [认证鉴权](https://support.huaweicloud.com/api-rtc/rtc_07_0005.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secr
- [返回结果](https://support.huaweicloud.com/api-rtc/rtc_07_0006.md): 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于管理员创建IAM用户接口，如果调用后返回状态码为201，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。对于管理员创建IAM用户接口，返回如图
- [示例1：创建单流录制任务](https://support.huaweicloud.com/api-rtc/rtc_07_0008.md): 若您需要对某一个房间的实时音视频进行录制，可以在加入房间后，调用录制接口创建单流录制任务。已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS 创建桶API进行创建，并在SparkRTC控制台中完成OBS桶授权。获取用
- [示例2：创建合流录制任务](https://support.huaweicloud.com/api-rtc/rtc_07_0009.md): 示例1：创建单流录制任务已介绍了如何将房间中的每一个用户的音视频流分别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。已创建用于存储录制文件的OBS桶，并完成OB
- [创建应用 - CreateApp](https://support.huaweicloud.com/api-rtc/CreateApp.md): 调用此接口创建应用。不支持同一租户创建多个app_name相同的应用。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求
- [查询应用列表 - ListApps](https://support.huaweicloud.com/api-rtc/ListApps.md): 调用此接口查询应用列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/apps状
- [查询单个应用 - ShowApp](https://support.huaweicloud.com/api-rtc/ShowApp.md): 调用此接口查询单个应用详情。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/app
- [删除应用 - DeleteApp](https://support.huaweicloud.com/api-rtc/DeleteApp.md): 调用此接口删除单个应用。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。DELETE /v2/ap
- [启用应用 - StartApp](https://support.huaweicloud.com/api-rtc/StartApp.md): 调用此接口启用单个应用。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。POST /v2/apps
- [停用应用 - StopApp](https://support.huaweicloud.com/api-rtc/StopApp.md): 调用此接口停用单个应用。应用停用后，新房间无法新增和加入，已加入的房间可以继续使用。合流、录制功能等也不可用。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户
- [创建或更新录制规则 - CreateRecordRule](https://support.huaweicloud.com/api-rtc/CreateRecordRule.md): 调用此接口创建或更新录制规则。若当前app在请求的location中无录制规则，则会创建新的录制规则若当前app在请求的location中无录制规则，则会创建新的录制规则若当前app在请求的location中已有录制规则，则会更新原来的录制规则若当前app在请求的location中已有录制规则，则会更新原来的录制规则一个app在一个loc
- [查询录制规则列表 - ListRecordRules](https://support.huaweicloud.com/api-rtc/ListRecordRules.md): 调用此接口查询录制规则列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/app
- [查询录制规则 - ShowRecordRule](https://support.huaweicloud.com/api-rtc/ShowRecordRule.md): 调用此接口查询指定录制规则。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/app
- [更新录制规则 - UpdateRecordRule](https://support.huaweicloud.com/api-rtc/UpdateRecordRule.md): 调用此接口更新录制规则。如果规则修改后，修改后的规则对正在录制的流无效。修改后对新的流有效，生效时间为5分钟，即修改规则5分钟后的录制任务会使用新规则进行录制。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果
- [删除录制规则 - DeleteRecordRule](https://support.huaweicloud.com/api-rtc/DeleteRecordRule.md): 调用此接口删除录制规则，对于正在使用的录制规则，不允许删除。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限
- [更新自动录制配置 - UpdateAutoRecord](https://support.huaweicloud.com/api-rtc/UpdateAutoRecord.md): 更新自动录制配置，租户可以开启自动单流录制或者停用自动单流录制（仅支持单流录制）。开启自动单流录制功能之后，只针对新创建的房间有效，对开启自动录制功能之前已经创建的房间不生效。单流自动录制任务的流名规则：{appid}_{roomid}_{userid}_{media_type}_{video_type}{media_type}可取值为v
- [查询自动录制配置 - ShowAutoRecord](https://support.huaweicloud.com/api-rtc/ShowAutoRecord.md): 调用此接口查询自动录制配置您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/apps
- [配置RTC增值（录制）事件回调 - UpdateRecordCallback](https://support.huaweicloud.com/api-rtc/UpdateRecordCallback.md): 调用此接口配置增值（录制）事件上报回调。当任务发生订阅了的事件时，通过该接口配置的回调地址通知。回调内容请参见增值（录制）事件回调通知内容。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用
- [查询增值（录制）事件回调配置 - ShowRecordCallback](https://support.huaweicloud.com/api-rtc/ShowRecordCallback.md): 调用此接口查询增值（录制）事件回调配置您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v
- [启动合流任务 - CreateMixJob](https://support.huaweicloud.com/api-rtc/CreateMixJob.md): 调用此接口创建合流转码任务。支持纯音频录制和音视频录制：纯音频录制encode_template填audio_only，音频合流会动态选择最大三方的声音。layout_template、layout_panes以及其他视频相关参数都不填，填就忽略。纯音频录制encode_template填audio_only，音频合流会动态选择最大三方的
- [查询合流任务 - ShowMixJob](https://support.huaweicloud.com/api-rtc/ShowMixJob.md): 调用此接口查询合流转码任务状态。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/a
- [修改合流任务 - UpdateMixJob](https://support.huaweicloud.com/api-rtc/UpdateMixJob.md): 调用此接口更新合流任务布局。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。PUT /v2/app
- [停止合流任务 - StopMixJob](https://support.huaweicloud.com/api-rtc/StopMixJob.md): 调用此接口停止已下发的合流转码任务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。DELETE 
- [启动单流任务 - CreateIndividualStreamJob](https://support.huaweicloud.com/api-rtc/CreateIndividualStreamJob.md): 调用此接口接口启动单流任务。API触发单流录制流名规则：{jobtype}_{jobid}_{roomid}_{userid}jobtype取值为's'代表单流录制。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限
- [查询单流任务状态 - ShowIndividualStreamJob](https://support.huaweicloud.com/api-rtc/ShowIndividualStreamJob.md): 调用此接口查询单流任务状态。租户的OBS桶内的情况，暂不支持查询。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参
- [停止单流任务 - StopIndividualStreamJob](https://support.huaweicloud.com/api-rtc/StopIndividualStreamJob.md): 调用此接口停止单流任务您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。DELETE /v2/app
- [更新单流任务 - UpdateIndividualStreamJobV2](https://support.huaweicloud.com/api-rtc/UpdateIndividualStreamJobV2.md): 调用此接口修改单流任务。仅部分场景支持修改。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。PUT
- [踢除在线用户 - RemoveUsersV2](https://support.huaweicloud.com/api-rtc/RemoveUsersV2.md): 调用此接口强制用户离开房间。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。POST /v2/ap
- [解散房间 - RemoveRoomV2](https://support.huaweicloud.com/api-rtc/RemoveRoomV2.md): 调用此接口解散房间，将该房间中所有用户踢出房间。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。P
- [查询OBS桶列表 - ListObsBuckets](https://support.huaweicloud.com/api-rtc/ListObsBuckets.md): 查询OBS桶列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/rtc-ops/
- [查询OBS桶下对象列表 - ListObsBucketObjects](https://support.huaweicloud.com/api-rtc/ListObsBucketObjects.md): 查询OBS桶下对象列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /v2/rtc-o
- [OBS桶授权及取消授权 - UpdateObsBucketAuthority](https://support.huaweicloud.com/api-rtc/UpdateObsBucketAuthority.md): OBS桶授权及取消授权。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。PUT /v2/rtc-o
- [查询房间列表 - ListRtcRoomList](https://support.huaweicloud.com/api-rtc/ListRtcRoomList.md): 指定时间范围查询这段期间创建的房间列表。最大查询跨度90天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限
- [查询用户列表 - ListRtcUserList](https://support.huaweicloud.com/api-rtc/ListRtcUserList.md): 指定时间范围查询这段期间加入房间的用户列表。最大查询跨度90天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见
- [查询实时规模 - ListRtcRealtimeScale](https://support.huaweicloud.com/api-rtc/ListRtcRealtimeScale.md): 获取规模相关的指标在某一时间段内每分钟的统计数据。最大查询跨度1天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请
- [查询实时规模分布 - ListRtcRealtimeScaleDimension](https://support.huaweicloud.com/api-rtc/ListRtcRealtimeScaleDimension.md): 对规模相关的数据，根据指定维度按在线用户数排名，获取规模相关的指标在指定维度下的统计数据您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的
- [查询实时质量数据 - ListRtcRealtimeQuality](https://support.huaweicloud.com/api-rtc/ListRtcRealtimeQuality.md): 获取实时质量数据的相关指标在某一时间段内每分钟的统计数据。最大查询跨度1天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权
- [查询实时网络 - ListRtcRealtimeNetwork](https://support.huaweicloud.com/api-rtc/ListRtcRealtimeNetwork.md): 获取实时网络数据相关指标在某一时间段内每分钟的统计数据。最大查询跨度1天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限
- [查询用量 - ListRtcHistoryUsage](https://support.huaweicloud.com/api-rtc/ListRtcHistoryUsage.md): 查询过去的某一时间段内各种业务的用量数据您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。GET /
- [查询历史规模 - ListRtcHistoryScale](https://support.huaweicloud.com/api-rtc/ListRtcHistoryScale.md): 查询指标过去每天的规模数量，可查询最近31天的数据。当天未结束，无法查到当天的房间数与用户数。最大查询跨度31天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM
- [查询历史质量 - ListRtcHistoryQuality](https://support.huaweicloud.com/api-rtc/ListRtcHistoryQuality.md): 查询质量指标过去每天的体验数据，可查询最近31天的数据。当天未结束，无法查询到当天的体验数据。最大查询跨度31天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM
- [查询用户通话指标 - ListRtcClientQosDetails](https://support.huaweicloud.com/api-rtc/ListRtcClientQosDetails.md): 查询用户通话质量指标数据。可查询5天内的数据，mid 不为null，查询实时数据时，查询起止时间不超过24个小时，每次查询单个用户时，支持跨天查询。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的
- [查询用户异常体验事件 - ListRtcAbnormalEvents](https://support.huaweicloud.com/api-rtc/ListRtcAbnormalEvents.md): 查询指定APP下通话的异常明细数据。最大查询跨度1天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权
- [查询异常事件用户分布 - ListRtcAbnormalEventDimension](https://support.huaweicloud.com/api-rtc/ListRtcAbnormalEventDimension.md): 查询指定APP下指定时间内的通话异常明细数据分布情况。最大查询跨度1天。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要
- [权限和授权项说明](https://support.huaweicloud.com/api-rtc/rtc_07_0023.md): 如果您需要对您所拥有的SparkRTC进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为账号账号所具备的权限功能已经能满足您的要求，您可以跳过本章节，不影响您使用SparkRTC服务的其他功能。通过IAM，您可以通过授权控制主体（IAM用户、用户组、IAM委
- [策略授权参考](https://support.huaweicloud.com/api-rtc/rtc_07_0024.md): 本章节介绍SparkRTC策略授权场景下支持的策略授权项。策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下：权限：允许或拒绝某项操作。对应API接口：自定义策略实际调用的API接口。授权项：自定义策略中支持
- [状态码](https://support.huaweicloud.com/api-rtc/rtc_07_0013.md): 调用实时音视频API时，可能返回的状态码如表1所示。
- [错误码](https://support.huaweicloud.com/api-rtc/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
- [获取项目ID](https://support.huaweicloud.com/api-rtc/rtc_07_0015.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。从控制台获取项目ID调用API获取项目ID在API凭证页面的项目列表中查看项目ID。获取项目ID您还能通过调用查询指定条件下的项目信息API获取项目ID。获取项目ID的接口为“GET https://{Endpoint}/v3/pr
- [获取账号ID](https://support.huaweicloud.com/api-rtc/rtc_07_0016.md): 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。具体获取步骤如下：在API凭证页面，即可获取对应的账号ID信息。获取账号ID
- [地区名称缩写](https://support.huaweicloud.com/api-rtc/rtc_07_0018.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [接收增值（录制）事件回调通知内容](https://support.huaweicloud.com/api-rtc/rtc_07_0021.md): SparkRTC服务回调用户提供的接口时，会附带以下信息。
- [修订记录](https://support.huaweicloud.com/api-rtc/rtc_07_0017.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 客户端SDK参考

- [主要功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0002.md): SparkRTC主要包含基本房间功能和跨房功能，各端主要功能框架，如图1所示。说明：图1中仅展示各端的统一功能，独属功能详见各端SDK指导。
- [文档基本使用技巧](https://support.huaweicloud.com/csdk-rtc/rtc_05_0003.md): 技巧1：基本使用逻辑说明用时序图展示各端接口使用顺序，单击相应接口可以快速查看相关接口使用方法。用时序图展示各端接口使用顺序，单击相应接口可以快速查看相关接口使用方法。技巧2：接口总览说明包括SparkRTC接口总体功能流程图和接口列表，根据功能分类可以快速查找具体功能单个接口，方便接口对接。包括SparkRTC接口总体功能流程图和接口列
- [常见问题分析解决办法](https://support.huaweicloud.com/csdk-rtc/rtc_05_0004.md): 问题1：调用setVideoEncoderConfig接口时，为什么有些参数直接报参数设置错误？设置分辨率时请使用华为SDK系统推荐的码表才能设置成功。设置分辨率时请使用华为SDK系统推荐的码表才能设置成功。问题2：有哪些原因会导致跨房不成功？可能原因1：同一时间不同房间最多只有一个Joiner角色才能跨房成功。可能原因2：同一时间最多只
- [SDK概述](https://support.huaweicloud.com/csdk-rtc/rtc_05_0001.md): 华为云实时音视频服务软件开发工具包是对SparkRTC服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用SparkRTC SDK提供的接口函数即可实现使用SparkRTC服务业务能力的目的。相关开发包请提交工单联系华为云技术客服获取。同时，针对不同平台的SDK提供了集成和接口参考。详细介绍了SDK的集成操作、接口参数
- [隐私声明](https://support.huaweicloud.com/csdk-rtc/rtc_05_0354.md): 华为云SparkRTCSDK是由华为云计算有限公司（以下简称“我们”或“华为云”）面向华为云客户提供，方便用户接入实时音视频。华为云客户根据开发文档和用户指南，在其应用中集成SparkRTCSDK后，我们将通过被集成的SparkRTC SDK向华为云客户面向的最终用户（以下简称“您”或“用户”）提供相关服务，处理华为云客户的应用相关的数据
- [合规使用指南](https://support.huaweicloud.com/csdk-rtc/rtc_05_0355.md): 华为云SparkRTC SDK开发者合规指南《中华人民共和国个人信息保护法》自2021年11月1日起正式施行后，监管部门、各行业参与方和终端消费者越来越关注用户的隐私保护问题。为了有效治理App、SDK违规收集使用个人信息的现象，监管部门也陆续出台相关标准规范。您作为开发者为最终用户提供服务，知悉并确认将遵守适用的法律法规和相关的标准规范
- [开发前准备](https://support.huaweicloud.com/csdk-rtc/rtc_05_0007.md): 已提交工单获取SDK包。OHOS SDK需要集成到APP工程中，建议您在如下推荐环境中进行集成开发。准备DevEco，推荐使用4.0.0(10) SDK及以上。准备Android运行环境：API 21、Android 5.0以上设备。支持的终端CPU架构：armeabi-v7a、arm64-v8a。手机的CPU架构可通过以下方式查询。手机
- [SDK使用](https://support.huaweicloud.com/csdk-rtc/rtc_05_0008.md): AppId获取方法请参见创建应用。设置本地窗口。SurfaceView surface = mHwRtcEngine.createRenderer(getApplicationContext()); // 不可使用new SurfaceView(context)创建 mHwRtcEngine.setupLocalView(surf
- [基本使用逻辑](https://support.huaweicloud.com/csdk-rtc/rtc_05_0009.md): 创建新的项目工程，导入SDK后，需要先创建引擎。您可以在入会前进行视频编码、声音播放模式等参数的配置。设置本地视图。用户加入房间后，将通过回调的方式通知房间内的其他用户，收到其他用户加入的回调后，可以为其设置远端视图。在会中，也可以进行切换摄像头等参数的配置。用户离开房间后，需销毁对应资源。在时序图中，单击相应接口名称可快速跳转到相应接口
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0012.md): 本章节介绍了Android SDK的HRtcEngine接口详情。HRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、屏幕共享、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0013.md): 【功能说明】创建SparkRTC引擎实例。【请求参数】config：引擎创建相关参数，具体请参见HRTCEngineConfig。eventHandler：引擎事件句柄，用于加入房间、离开房间等事件回调，具体请参见IHRTCEngineEventHandler。config：引擎创建相关参数，具体请参见HRTCEngineConfig。e
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0014.md): 【功能说明】加入房间。【请求参数】joinParam：入会参数，具体请参见HRTCJoinParam。【返回参数】0：成功。1：失败。具体请参见客户端错误码。2：上下文为空。0：成功。1：失败。具体请参见客户端错误码。2：上下文为空。该方法将会触发以下回调：onConnectionStateChangedNotify：连接状态发送改变。o
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0015.md): 【功能说明】设置是否发送本地音频流。【请求参数】mute：true表示不发送，false表示发送。【返回参数】0：成功。>0：失败。具体请参见客户端错误码。0：成功。>0：失败。具体请参见客户端错误码。成功加入房间发送音频流后才能调用，默认为发送本地音频流。【功能说明】设置是否接收对应远端用户的音频流。【请求参数】userId：用户ID。
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0016.md): 【功能说明】创建渲染视图。【请求参数】context：上下文。【返回参数】创建的渲染视图。【功能说明】设置本地窗口显示模式，镜像模式。【请求参数】displayMode：显示模式，具体请参见HRTCVideoDisplayMode。mirrorMode：镜像模式，具体请参见HRTCVideoMirrorType。【返回参数】0：成功。>0
- [屏幕共享](https://support.huaweicloud.com/csdk-rtc/rtc_05_0017.md): 【功能说明】开启屏幕共享。【返回参数】0：成功。> 0：失败。具体请参见客户端错误码。0：成功。> 0：失败。具体请参见客户端错误码。Android 5.0及以上版本支持此功能。使用时，在AndroidManifest.xml中需添加如下约束。<activity <activity android:name="com.huawei.al
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0018.md): 【功能说明】设置是否开启辅流的流畅度优先。【请求参数】enable：true表示辅流分辨率为720p，false表示辅流分辨率为1080p。【返回参数】0：成功。> 0：失败。具体请参见客户端错误码。SDK 1.7.1及以上版本支持。开启后，辅流发流分辨率为720p，否则发流分辨率为1080p。默认不开启。【功能说明】开始订阅辅流。【请求
- [音效文件播放管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0019.md): 【功能说明】开始播放音频文件。当前支持本端播放和在线播放。支持的格式包括：mp3、flac、mp4、m4a、aac、3gp、mkv、wav、amr、pcm、ogg。【请求参数】fullFilePath：音频文件的本地全路径，支持播放本地文件或网络文件。publish：播放模式，0表示只有本端能听到播放的音频，1表示远端也能听到播放的音频。
- [音频增强管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0020.md): 【功能说明】设置音量值上报回调函数(onUserVolumeStatsNotify)的回调周期。【请求参数】interval：音量值上报周期，默认关闭音量回调。0：关闭音量回调。[100，10000]：有效值范围，单位为毫秒，建议设置为2000ms，默认值为2000ms。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见客户端
- [检测功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0021.md): 【功能说明】启动入会前网络检测。【请求参数】networkTestConfig：检测配置信息，具体请参见HRTCNetworkTestConfig。【返回参数】0：表示调用启动命令成功。> 0：表示调用启动命令失败。具体请参见客户端错误码。0：表示调用启动命令成功。> 0：表示调用启动命令失败。具体请参见客户端错误码。【功能说明】停止入会
- [自定义音频采集和渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0022.md): 【功能说明】设置音频数据输出使能。【请求参数】localEnable：true表示输出本地音频数据，false表示不输出本地音频数据。remoteEnable：true表示输出远端音频数据，false表示不输出远端音频数据。localEnable：true表示输出本地音频数据，false表示不输出本地音频数据。remoteEnable：t
- [自定义视频采集和渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0023.md): 【功能说明】设置视频数据输出使能。【请求参数】localEnable：true表示输出本地视频数据，false表示不输出本地视频数据，默认值为false。remoteEnable：true表示输出远端视频数据，false表示不输出远端视频数据，默认值为false。format：自渲染输出的视频帧图片格式，在onRenderExternal
- [设备管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0024.md): 【功能说明】是否启用扬声器。【请求参数】无【返回参数】0：不使用扬声器。1：使用扬声器。仅支持iOS和Android。【功能说明】设置摄像头相关参数，开启摄像头前设置有效。【请求参数】config：摄像头的配置参数，具体请参见HRTCCameraConfig。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见客户端错误码。0：
- [事件回调（IHRTCEngineEventHandler）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0025.md): 本章节介绍了Android SDK的回调接口IHRTCEngineEventHandler的详情。【功能说明】错误回调。【回调参数】error：错误码，具体请参见HRTCErrorCode。msg：错误描述。error：错误码，具体请参见HRTCErrorCode。msg：错误描述。【功能说明】成功加入房间回调。【回调参数】roomId：
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0027.md): 本章节介绍了Android SDK的HRTCConnection接口详情。HRTCConnection按照其功能可分类为：初始化等基础接口、房间功能、音频管理、视频管理、屏幕共享。单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0028.md): 【功能说明】设置端到端加密方式。需要在加入房间前设置生效。其中sdk加密模式，需要设置16位加密密钥和加密算法，app加密模式需要先设置回调接口。【请求参数】encryptionParam：加密配置，具体请参见HRTCEncryptionConfig。【返回参数】0：成功。<0：失败。具体请参见客户端错误码。【功能说明】释放HRTCCon
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0029.md): 【功能说明】加入房间。【请求参数】joinParam：入会参数，具体请参见HRTCJoinParam。【返回参数】0：成功。1：失败。2：上下文为空。0：成功。1：失败。2：上下文为空。【注意事项】该方法将会触发以下回调：onConnectionStateChangedNotify：连接状态发送改变。onJoinRoomSuccess：加
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0030.md): 【功能说明】设置是否接收对应远端用户的音频流。【请求参数】userId：用户ID。mute：true表示取消音频流接收，false表示开启音频流接收，默认为false。userId：用户ID。mute：true表示取消音频流接收，false表示开启音频流接收，默认为false。【返回参数】0：成功。> 0：失败。具体请参见客户端错误码。0
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0031.md): 【功能说明】大小流模式，设置所有订阅的远端视频流类型。默认订阅大流，优先应用setRemoteVideoStreamType接口设置的用户流类型。【请求参数】type：订阅的视频流类型，分为大流和小流，具体请参见HRTCVideoStreamType。【返回参数】0：成功。>0：失败。具体请参见客户端错误码。0：成功。>0：失败。具体请参
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0032.md): 【功能说明】开始订阅辅流。【请求参数】userId：用户ID。view：窗口视图。【返回参数】0：成功。>0：失败。具体请参见客户端错误码。收到onUserAuxiliaryStreamAvailable通知后，获取对应的userId。多辅流场景下，一个用户只能同时订阅一条辅流。即当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需
- [自定义渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0033.md): 【功能说明】设置音频数据输出使能。【请求参数】localEnable：true表示输出本地音频数据，false表示不输出本地音频数据。remoteEnable：true表示输出远端音频数据，false表示不输出远端音频数据。localEnable：true表示输出本地音频数据，false表示不输出本地音频数据。remoteEnable：t
- [事件回调(IHRTCConnectionEventHandler)](https://support.huaweicloud.com/csdk-rtc/rtc_05_0034.md): 本章节介绍了Android SDK的回调接口IHRTCConnectionEventHandler的详情。【功能说明】错误回调。【回调参数】conn：回调对应的HRTCConnection实例。error：错误码，具体请参见HRTCErrorCode。msg：错误描述。conn：回调对应的HRTCConnection实例。error：错误
- [客户端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0035.md): 本章节介绍了SDK的客户端错误码HRtcErrorCode的详细信息。
- [服务端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0036.md): 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。
- [数据类型](https://support.huaweicloud.com/csdk-rtc/rtc_05_0037.md): 本章节列出了Android SDK的所有数据类型，您可以结合HRtcEngine接口和回调进行开发。网络质量级别的数值越大，信号越好。
- [注册回调（IHRTCMediaEngine）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0039.md): 【功能说明】注册原始视频媒体数据监听回调。【请求参数】conn：HRTCConnection引擎。observer：原始视频数据处理接口，具体请参见IHRTCVideoFrameObserver。【返回参数】0：表示调用命令成功。> 0：表示调用命令失败。0：表示调用命令成功。> 0：表示调用命令失败。【功能说明】注册原始音频媒体数据监听
- [事件回调（IHRTCVideoFrameObserver）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0040.md): 【功能说明】原始视频回调，从接口回调中取到原始视频数据以作前处理。【回调参数】videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。【功能说明】原始视频数据处理后回调。【回调参数】userid：用户ID。videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。【功能说明】是否需要开启前处理。【
- [事件回调（IHRTCAudioFrameObserver）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0041.md): 【功能说明】需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。【回调参数】audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。【功能说明】全部音频混音数据回调，包含上下行所有通道。【回调参数】audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。【功能说明】音频采集原始数据回调，
- [事件回调（IHRTCEncDecryptFrameObserver）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0042.md): 【功能说明】媒体数据回调到app层加密处理。【回调参数】frameBuffer：媒体数据格式 ，具体请参见HRTCFrameBuffer。【返回参数】无【功能说明】媒体数据回调到app层解密处理。【回调参数】frameBuffer：媒体数据格式 ，具体请参见HRTCFrameBuffer。【返回参数】无
- [常见问题](https://support.huaweicloud.com/csdk-rtc/rtc_05_0043.md): 初始化引擎时，countryCode应该如何填写？countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对照表。countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对
- [修订记录](https://support.huaweicloud.com/csdk-rtc/rtc_05_0044.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [iOS开发前准备](https://support.huaweicloud.com/csdk-rtc/rtc_05_0047.md): 已提交工单获取SDK包。准备XCODE集成开发。准备iOS 8.0及以上的iPhone真机。支持的终端CPU架构：arm64，arm32。若您需要使用屏幕共享功能，则需要导入HWRtcEngineReplayKit.framework。在导入HWRtcEngineReplayKit.framework前，您需要参考屏幕共享完成Broadc
- [macOS开发前准备](https://support.huaweicloud.com/csdk-rtc/rtc_05_0048.md): 已提交工单获取SDK包。准备XCODE集成开发环境。准备MAC设备，支持macOS 10.11以上的设备。支持的终端CPU架构：x86_64。支持dylib和framework两种包集成。若Header Search Paths和Library Search Paths中文件位置不对，可以将XCODE对应文件夹直接拖过来即可。
- [SDK使用](https://support.huaweicloud.com/csdk-rtc/rtc_05_0049.md): 域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。_rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig * cfg = [[HWRtcEngineConfig alloc]init]; cfg.appId = appid;// appId需在控制台中创建应用
- [基本使用逻辑](https://support.huaweicloud.com/csdk-rtc/rtc_05_0050.md): 创建新的项目工程，导入SDK后，需要先创建引擎。您可以在入会前进行视频编码、声音播放模式等参数的配置。设置本地视图。用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。在会中，也可以进行切换摄像头等参数的配置。离开房间后，需销毁对应资源。在时序图中，单击相应接口名称可快速跳转到相应接口位置查看
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0053.md): 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。HWRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0054.md): 【功能说明】创建连麦引擎实例。【请求参数】无【返回参数】返回引擎实例对象。【功能说明】注销引擎。【请求参数】无【返回参数】无【功能说明】初始化引擎配置信息。【请求参数】config：引擎配置，具体请参见HWRtcEngineConfig。【返回参数】 0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：方法
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0055.md): 【功能说明】加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。【请求参数】joinParam：用户信息，具体请参见HWRtcJoinParam。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：方法调用成功。> 0：方法调用失败
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0056.md): 【功能说明】设置是否关闭本地音频流发送。【请求参数】mute：YES表示关闭音频流发送，NO表示开启音频流发送。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。默认开启本地音频发流。关闭本地音频发流，不影响本地音频采
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0057.md): 【功能说明】设置是否开启摄像头采集视频。【请求参数】enable：YES表示开启，NO表示关闭。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。默认开启本地视频采集，关闭不会影响视频流发送。远端用户订阅了本端用户时，
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0058.md): 【功能说明】当远端开启屏幕共享，本地接收到远端屏幕共享开启并通过onUserAuxiliaryStreamAvailable回调得到消息后，设置屏幕辅流窗口视图并开始选看（发起辅流选看）。【请求参数】streamView：视图信息，具体请参见HWRtcVideoCanvas。streamType：编码类型，具体请参见HWRtcStream
- [屏幕共享](https://support.huaweicloud.com/csdk-rtc/rtc_05_0059.md): 【功能说明】开启屏幕共享功能。【请求参数】无【返回参数】0：成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。目前可支持多路辅流共享，若需开启多辅流，请提交工单联系技术支持处理。共享成功后会触发onScreenShareStarted回调。开启成功，
- [音效文件播放管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0060.md): 如不集成hwffmpeg.framework，接口则只有startAudioFile/stopAudioFile/pauseAudioFile/resumeAudioFile生效，回调则只有onStartAudioFile/onStopAudioFile/onPauseAudioFile/onResumeAudioFile生效，且star
- [检测功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0061.md): 【功能说明】会前网络质量开启测试，房间外调用，要等探测结束后才能加入房间。【请求参数】netWorkTestConfig：检测配置，具体请参见HWRtcNetworkTestConfig。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。会触发onNetworkTestQuality、onNetw
- [自定义音频采集和渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0062.md): 【功能说明】设置是否开启外部音频采集。需要在加入房间前调用。【请求参数】enable：YES表示开启，NO表示关闭。默认为NO。sampleRate：音频采样率，支持16k、24k、32k、44.1k、48k采样率。channels：音频声道数，1表示单声道，2表示双声道。enable：YES表示开启，NO表示关闭。默认为NO。sampl
- [自定义视频采集和渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0063.md): 【功能说明】设置是否开启外部视频采集。需要在加入房间前调用。【请求参数】enable：YES表示开启，NO表示关闭。默认为NO。format：设置外部采集的视频格式，默认为I420（即yuv420P）。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。加入房间前调用，不支持房间内切换。视频支持格式
- [设备管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0064.md): 【功能说明】设置声音播放模式。成功加入房间后才能调用。【请求参数】speakerModel：声音播放模式，具体请参见HWRtcSpeakerModel。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。只支持iphone。【功能说明】设置相机的相关参数，如默认使用的摄像头方向【请求参数】confi
- [事件回调（HWRtcEngine）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.md): 本章节介绍了iOS/Mac SDK的回调接口HWRtcEngineDelegate的详情。【功能说明】成功加入房间，触发此回调。【回调参数】roomId：新加入的房间ID。userId：新加入房间的用户ID。roomId：新加入的房间ID。userId：新加入房间的用户ID。【功能说明】加入房间失败，触发此回调。【回调参数】errorCo
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0067.md): 本章节介绍了iOS/macOS SDK的HWRtcConnection接口详情。HWRtcConnection按照其功能可分类为：初始化等基础接口、房间功能、视频管理、屏幕共享、音频管理。单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0068.md): 【功能说明】注销引擎。【请求参数】无【返回参数】无【功能说明】根据roomId获取connection实例。【请求参数】roomId：房间ID。【返回参数】返回对应的跨房对象。【功能说明】使能视频前后处理。【请求参数】observer：代码对象 要求实现HWRtcConnectionVideoDelegate协议。【返回参数】0：方法调用
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0069.md): 【功能说明】加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。【请求参数】joinParam：用户信息，具体请参见HWRtcJoinParam。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：方法调用成功。> 0：方法调用失败
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0070.md): 【功能说明】设置是否接收对应远端用户的音频流。【请求参数】userId：远端用户的userid，唯一标识。muted：YES表示取消订阅，NO表示订阅。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。【功能说明】设置是否接收所有用户的音频流。【请求参数】mute：YES表示取消订阅，NO表示订阅
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0071.md): 【功能说明】设置远端用户窗口，并开启收流。【请求参数】remote：远端预览视图，具体请参见HWRtcVideoCanvas。streamType：视频分辨率，具体请参见HWRtcStreamType。disableAdjustRes：禁用分辨率自适应，默认关闭。YES表示关闭，NO表示开启。若关闭，在网络环境较差情况下可能会出现卡顿现象
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0072.md): 【功能说明】开启辅流渲染视图（发起辅流选看）【请求参数】view: 具体请参见HWRtcVideoCanvas【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。收到onUserAuxiliaryStreamAvailable消息后，获取对应的userId。多辅流场景，一个用户同时只能订阅一条辅流；
- [媒体原始数据管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0073.md): 【功能说明】注册原始视频媒体数据监听回调。【请求参数】HWRtcConnectionVideoDelegate：原始视频数据处理接口代理。具体请参见HWRtcConnectionVideoDelegate 。【返回参数】0：成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：成功。> 0：方法调用失败。具体请参见HW
- [事件回调（HWRtcConnection）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0074.md): 本章节介绍了iOS/macOS SDK的回调接口HWRtcConnectionDelegate的详情。【功能说明】成功加入跨房房间，触发此回调。【回调参数】connection：跨房引擎。userId：新加入房间的用户ID。connection：跨房引擎。userId：新加入房间的用户ID。【功能说明】加入房间失败，触发此回调。【回调参数
- [注册回调（IHRTCMediaEngine）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0076.md): 【功能说明】注册原始视频媒体数据监听回调。【请求参数】HWRtcMediaEngineVideoDelegate：原始视频数据处理接口代理。具体请参见HWRtcMediaEngineVideoDelegate。【返回参数】0：成功。> 0：方法调用失败。具体请参见HWRtcErrorCode。0：成功。> 0：方法调用失败。具体请参见HW
- [事件回调（HWRtcMediaEngineVideoDelegate）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0077.md): 本章节介绍了iOS SDK的回调接口HWRtcMediaEngineVideoDelegate的详情。【功能说明】原始视频回调，从接口回调中取到原始视频数据以作前处理。【回调参数】HWRtcVideoFrame：视频数据格式 ，具体请参见HWRtcVideoFrame。【返回参数】YES：处理结果成功。NO：处理结果失败。YES：处理结果
- [事件回调（HWRtcMediaEngineAudioDelegate）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0078.md): 本章节介绍了iOS SDK的回调接口HWRtcMediaEngineAudioDelegate的详情。【功能说明】需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。【回调参数】HWRtcAudioFrame ：音频数据格式，具体请参见HWRtcAudioFrame。【返回参数】YES：处理结果成功。NO：处理结果失败。YES：处
- [HWRtcReplay](https://support.huaweicloud.com/csdk-rtc/rtc_05_0079.md): 【功能说明】生成HWRtcReplay单例对象。【请求参数】无。【返回参数】无【功能说明】通过appGroup启动HWrtcReplay。在sampleHandle类中的broadcastStartedWithSetupInfo:接口内调用。【请求参数】appGroup ：appGroupID。delegate：回调对象，具体请参见HWR
- [客户端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0080.md): 本章节介绍了iOS/macOS SDK的客户端错误码HWRtcErrorCode的详细信息。
- [服务端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0081.md): 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。
- [数据类型](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.md): 本章节列出了iOS/macOS SDK的所有数据类型，您可以结合HWRtcEngine接口和回调进行开发。设备信息，macOS SDK使用。设备类型，MAC SDK使用。设备状态，MAC SDK使用。
- [事件回调（HWRtcReplay）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0083.md): 本章节介绍了RtcEngineReplayKitExt SDK回调接口HWRtcReplayDelegate的详情。【功能说明】录屏结束回调。【回调参数】无
- [常见问题](https://support.huaweicloud.com/csdk-rtc/rtc_05_0084.md): iOS平台如何缩减安装包体积？对于iPhone 5s及以上版本的手机支持只打包arm64架构，可以在XCode的Build Setting < Build Active Architecture Only设置为YES，并将Valid Architectures只写arm64，则SparkRTC SDK可压缩一半的体积。对于iPhone 5
- [修订记录](https://support.huaweicloud.com/csdk-rtc/rtc_05_0085.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [Android](https://support.huaweicloud.com/csdk-rtc/rtc_05_0088.md): 已提交工单获取SDK包。OHOS SDK需要集成到APP工程中，建议您在如下推荐环境中进行集成开发。准备DevEco，推荐使用4.0.0(10) SDK及以上。准备Android运行环境：API 21、Android 5.0以上设备。支持的终端CPU架构：armeabi-v7a、arm64-v8a。手机的CPU架构可通过以下方式查询。手机
- [iOS](https://support.huaweicloud.com/csdk-rtc/rtc_05_0089.md): 已提交工单获取SDK包。准备XCODE集成开发。准备iOS 8.0及以上的iPhone真机。支持的终端CPU架构：arm64，arm32。
- [Mac](https://support.huaweicloud.com/csdk-rtc/rtc_05_0090.md): 已提交工单获取SDK包。准备XCODE集成开发环境。准备MAC设备，支持macOS 10.11以上的设备。支持的终端CPU架构：x86_64。支持dylib和framework两种包集成。若Header Search Paths和Library Search Paths中文件位置不对，可以将XCODE对应文件夹直接拖过来即可。
- [Windows](https://support.huaweicloud.com/csdk-rtc/rtc_05_0091.md): 已提交工单获取SDK包。准备集成开发环境，建议使用Microsoft Visual Studio 2015或以上版本。支持Windows 7或以上版本的Windows设备。支持的平台：x86 release。头文件目录lib文件目录
- [SDK使用](https://support.huaweicloud.com/csdk-rtc/rtc_05_0092.md): 以下为集成SDK进行实时音视频互动直播的基本流程：appId获取方法请参见创建应用。m_engineEventHandler：引擎回调句柄，指定一个回调事件。SDK通过指定的事件通知应用程序的运行事件，如加入或离开房间等，具体请参见事件回调（IHRTCEngine）。engineInfo：结构体具体请参见HRTCEngineConfig。
- [基本使用逻辑](https://support.huaweicloud.com/csdk-rtc/rtc_05_0093.md): 创建新的项目工程，导入SDK后，需要先创建引擎。您可以在入会前进行视频编码、声音播放模式等参数的配置。设置本地视图。加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。在会中，也可以进行切换摄像头等参数的配置。离开房间后，需销毁对应资源。在时序图中，单击相应接口名称可快速跳转到相应接口位置查看其使
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0096.md): 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
- [接口按功能说明](https://support.huaweicloud.com/csdk-rtc/rtc_05_0097.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0098.md): 【功能说明】创建IHRTCEngine对象。【返回参数】huawei::rtc::IHRTCEngine*：IHRTCEngine对象。NULL：创建失败。【功能说明】调用createHRtcEngine成功后，可通过该函数，获取IHRTCEngine对象。【返回参数】huawei::rtc::IHRTCEngine*：IHRTCEngi
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0099.md): 【功能说明】加入房间。该方法让用户加入通话房间。【请求参数】joinParam：加入房间信息。具体请参见HRTCJoinParam。【返回参数】0：方法调用成功。>0：方法调用失败。具体请参见HRTCErrorCode。会触发以下回调：onConnectStateChange：连接状态发送改变。onJoinRoomSuccess：加入房间
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0100.md): 【功能说明】设置是否开启本地麦克风音频采集。【请求参数】enable：true表示开启。false表示关闭。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。默认开启本地音频采集。远端用户会收到onRemoteAudioStateChangedNotify远端流状态变化回调。【功能说明】设置麦克风采
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0101.md): 【功能说明】设置是否开启摄像头采集视频。【请求参数】enable：true表示开启。false表示关闭。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。默认开启本地视频采集。远端用户订阅了本端用户时，会收到onRemoteVideoStateChangedNotify远端流状态变化回调。【功能说明
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0102.md): 【功能说明】设置远端辅流视图旋转角度。【请求参数】userId：用户ID。rotation：旋转角度信息（0°，90°，270°），具体请参见HRTCVideoRotation。默认为0°。【返回参数】0：方法调用成功。>0：方法调用失败。具体请参见HRTCErrorCode。0：方法调用成功。>0：方法调用失败。具体请参见HRTCErr
- [屏幕共享](https://support.huaweicloud.com/csdk-rtc/rtc_05_0103.md): 【功能说明】获取屏幕可共享对象列表。【请求参数】type：屏幕捕获图像类型，具体请参见HRTCScreenShareIconType。【返回参数】共享屏幕窗口对象列表，具体请参见共享屏幕资源管理。【功能说明】选择屏幕共享对象。【请求参数】info：共享对象信息，主要为采集源ID、名称等，具体请参见HRTCScreenShareSource
- [音频文件播放管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0104.md): 音频文件播放使用ffmpeg能力，在播放在线url时受windows平台自身特性影响，断网时会立刻停止播放（SparkRTC内部无缓存设计），若对该场景体验有要求，建议业务通过先下载到本地再播放的形式使用。【功能说明】播放音频文件，房间内调用。当前仅支持本端播放。【请求参数】filePath：音频文件的本地全路径。publish：播放模式
- [自采集自渲染](https://support.huaweicloud.com/csdk-rtc/rtc_05_0105.md): 【功能说明】设置是否开启外部视频采集。【请求参数】enable：true表示开启视频自采集，false表示取消视频自采集。默认值为false。format：设置外部采集的视频格式，默认为I420（即yuv420P）。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。加入房间前调用，不支持房间内切换。
- [其他接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0106.md): 【功能说明】开启网络质量测试，房间外调用，要等探测结束后才能加入房间。【请求参数】networkTestConfig：网络探测参数格式。具体请参见HRTCNetworkTestConfig。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。会触发onNetworkTestQuality和onNetw
- [事件回调（IHRTCEngine）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0107.md): 本章节介绍了全平台C++ SDK的回调接口IHRTCEngineEventHandler的详情。【功能说明】发生错误，触发此回调。返回客户端错误码或者服务端错误码。【回调参数】error：错误码，具体请参见HRTCErrorCode。msg：错误描述。【功能说明】成功加入房间，触发此回调。【回调参数】roomId：新加入的房间ID。use
- [接口总览](https://support.huaweicloud.com/csdk-rtc/rtc_05_0109.md): 本章节介绍了全平台C++ SDK的IHRTCConnection接口详情。
- [初始化等基础接口](https://support.huaweicloud.com/csdk-rtc/rtc_05_0110.md): 【功能说明】释放IHRTCConnection对象，如果未离会，会自动离会再释放连接，会触发onDestroyConnection回调。如果资源已经释放，不能继续使用该对象，需要重新调用createConnection。【功能说明】获取当前连接对应的房间ID。【请求参数】无【返回参数】roomId：返回当前连接对应的房间ID。【功能说明】
- [房间功能](https://support.huaweicloud.com/csdk-rtc/rtc_05_0111.md): 【功能说明】加入房间。该方法让用户加入通话房间。【请求参数】joinParam：入会参数。具体请参见HRTCJoinParam。【返回参数】0：方法调用成功。>0：方法调用失败。具体请参见HRTCErrorCode。会触发以下回调：onConnectStateChange：连接状态发送改变。onJoinRoomSuccess：加入房间成功
- [音频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0112.md): 【功能说明】设置是否接收对应远端用户的音频流。同一时间所有房间最多只能接收17路音频流。【请求参数】userId: 远端用户的userId，唯一标识。mute：true表示取消音频流接收。false表示开启音频流接收。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。【功能说明】设置是否接收当前房间
- [视频管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0113.md): 【功能说明】设置远端流渲染视图（新选看接口），该接口不影响收流。【请求参数】userId：远端用户的唯一标识。view：窗口句柄，view为NULL时，解除窗口绑定并结束选看。【返回参数】0：方法调用成功。> 0：方法调用失败。具体请参见HRTCErrorCode。【功能说明】设置远端用户视图渲染模式。【请求参数】userId：远端用户的
- [辅流管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0114.md): 【功能说明】设置远端辅流视图旋转角度。【请求参数】userId：用户ID。rotation：旋转角度信息（0°，90°，270°），具体请参见HRTCVideoRotation。【返回参数】0：方法调用成功。>0：方法调用失败。具体请参见HRTCErrorCode。0：方法调用成功。>0：方法调用失败。具体请参见HRTCErrorCode
- [事件回调（IHRTCConnection）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0115.md): 本章节介绍了全平台C++ SDK的回调接口IHRTCEngineEventHandler的详情。【功能说明】发生错误，触发此回调。返回客户端错误码或者服务端错误码。【回调参数】conn：连接对象。error：错误码，具体请参见HRTCErrorCode。msg：错误描述。【功能说明】发生错误，触发此回调。返回客户端错误码或者服务端错误码。
- [音频设备管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0116.md): 本章节介绍了全平台C++ SDK的IHRTCAudioDeviceManager接口详情。【功能说明】获取系统音频播放设备列表。【请求参数】deviceInfo：输出参数，获取系统设备详情，包括设备标识和设备名称。具体请参见HRTCDeviceInfo。counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceIn
- [视频设备管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0117.md): 本章节介绍了全平台C++ SDK的IHRTCVideoDeviceManager接口详情。【功能说明】获取系统视频设备列表。【请求参数】deviceInfo：输出参数，获取系统设备详情，包括设备标识和设备名称。具体请参见HRTCDeviceInfo。counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo
- [共享屏幕资源管理](https://support.huaweicloud.com/csdk-rtc/rtc_05_0118.md): 本章节介绍了全平台C++ SDK的IHRTCScreenShareSourceList类接口详情。【功能说明】获取屏幕共享窗口资源数量。【请求参数】无【返回参数】unsigned int：无符号整数，对象（屏幕或窗口）数量。【功能说明】获取屏幕共享窗口资源信息。【请求参数】index：资源句柄。【返回参数】捕获的共享资源对象，具体请参见H
- [注册回调（IHRTCMediaEngine）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0120.md): 本章节介绍了全平台C++ SDK的IHRTCMediaEngine类接口详情。【功能说明】注册原始视频媒体数据监听回调。【请求参数】conn：连接对象。IHRTCVideoFrameObserver* observer：原始视频数据处理接口代理。具体请参见IHRTCVideoFrameObserver。IHRTCConnectionVid
- [事件回调(IHRTCVideoFrameObserver)](https://support.huaweicloud.com/csdk-rtc/rtc_05_0121.md): 本章节介绍了全平台C++ SDK的回调接口IHRTCVideoFrameObserver的详情。【功能说明】原始视频回调，从接口回调中取到原始视频数据以作前处理。【回调参数】videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。【返回参数】true：处理结果成功。false：处理结果失败。【功能说明】原始视频数据处
- [事件回调(IHRTCAudioFrameObserver)](https://support.huaweicloud.com/csdk-rtc/rtc_05_0122.md): 本章节介绍了全平台C++ SDK的回调接口IHRTCAudioFrameObserver的详情。【功能说明】需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。【回调参数】audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。【返回参数】true：处理结果成功。false：处理结果失败。【功能说明】全部音频
- [事件回调(IHRTCConnectionVideoFrameObserver)](https://support.huaweicloud.com/csdk-rtc/rtc_05_0123.md): 本章节介绍了全平台C++ SDK的回调接口IHRTCConnectionVideoFrameObserver的详情。【功能说明】原始视频数据处理后回调【回调参数】conn：连接对象userid：用户IDvideoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。【返回参数】true：处理结果成功。false：处理结果失败
- [事件回调（IHRTCEncDecryptFrameObserver）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0124.md): 【功能说明】媒体数据的加密回调【回调参数】frameType：媒体类型。frameBuffer：媒体数据格式 ，具体请参见HRTCFrameBuffer。【功能说明】媒体数据的解密密回调【回调参数】frameType：媒体类型frameBuffer：媒体数据格式 ，具体请参见HRTCFrameBuffer。
- [客户端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0125.md): 本章节介绍了SDK的客户端错误码HRTCErrorCode的详细信息。当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要App干预或进行用户提示。
- [服务端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0126.md): 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。
- [HRTC码率帧率配置推荐](https://support.huaweicloud.com/csdk-rtc/rtc_05_0127.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [数据类型](https://support.huaweicloud.com/csdk-rtc/rtc_05_0128.md): 本章节列出了全平台C++ SDK的所有数据类型，您可以结合IHRTCEngine接口和回调进行开发。
- [常见问题](https://support.huaweicloud.com/csdk-rtc/rtc_05_0129.md): 调用加入房间接口成功后，再调用pushExternalVideoFrame返回90000001 SDK内部系统错误需要收到加入房间成功回调通知后，才能调用pushExternalVideoFrame。需要收到加入房间成功回调通知后，才能调用pushExternalVideoFrame。joiner和player都加入房间成功，joiner
- [修订记录](https://support.huaweicloud.com/csdk-rtc/rtc_05_0130.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [浏览器适配](https://support.huaweicloud.com/csdk-rtc/rtc_05_0132.md): 本章节介绍Web SDK支持的浏览器类型、版本以及使用限制。已集成Web SDK 1.0+版本（2.0+版本不涉及）的用户，请尽快升级至1.10.0+版本，否则在Chrome 96+浏览器上有可能出现无法使用的情况。Web SDK 2.0+版本是目前的主力构建版本，承载新功能及体验优化，建议您优先集成使用。Web SDK 1.0+版本仅做
- [开发前准备](https://support.huaweicloud.com/csdk-rtc/rtc_05_0133.md): 已提交工单获取SDK包。编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。如果客户端用Node.js开发， 推荐安装14.19.1或以上版本。支持的浏览器详情请参见Web浏览器适配详情。如果客户端用TypeScript开发，TypeScript的版本不低于3.8.3。由于浏览器安全策略限制，
- [SDK使用](https://support.huaweicloud.com/csdk-rtc/rtc_05_0134.md): domain：string[128]类型，服务器域名。该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。appId：string[128]类型，必填。应用ID，只有App ID相同的应用程序才能进入同一个房间进行互通。countryCode：string[2]类型，可选。国家码，如：CN表示中国大陆，US表示美国，HK表示
- [基本使用逻辑](https://support.huaweicloud.com/csdk-rtc/rtc_05_0135.md): 创建新的项目工程，导入 SDK 后，需要创建客户端并获取本地音视频设备信息。创建本地流并初始化。当用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以对音视频流进行订阅、取消订阅等其它操作。在会中，也可以对本地录音或播放设备等进行配置。用户离开房间后，房间内其他用户会收到该用户离开的回调信息，离开房间后，需销毁
- [主入口（HRTC）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0137.md): 本章节介绍了Web SDK的HRTC接口详情。如果Web SDK版本在2.0.2到2.0.9.300之间，需要在2023年10月29日前更新至2.0.9.301及之后的版本，否则会导致checkSystemRequirements接口不可用。影响范围为微信浏览器。【功能说明】加入房间前必须要调用，检测浏览器是否兼容SparkRTC Web
- [客户端对象（Client）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0138.md): 本章节介绍了Web SDK的Client接口详情。【功能说明】加入房间。该接口让用户加入一个房间，进行音频或视频通话。【请求参数】roomId：房间ID，房间唯一标识符。必选，string[64]类型。options：加入房间配置。必选，JoinConfig类型。JoinConfig 定义为：{userId：用户标识，userId需要保证
- [客户端事件通知（ClientEvent）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0139.md): 本章节介绍了Web SDK的ClientEvent事件。事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。【事件说明】远端用户加入房间事件，远端用户加入房间后会收到该事件通知。【回调参数】peerJoinEvent：必选，PeerJoin类型，用户信息。PeerJoin定义为：{userId：必选，string[6
- [流对象（Stream）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0140.md): 本章节介绍了Web SDK的Stream接口详情。【功能说明】播放音视频流。该方法会自动创建<audio>、<video>标签，并在指定的标签上播放音频和视频，同时该标签会被添加到页面中名为 elementId的div容器下。【请求参数】elementId：必选，string类型，HTML <div>标签ID。options：可选，Opt
- [本地流对象（LocalStream）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0141.md): 该对象继承自Stream对象，并有如下新增接口。【功能说明】根据createStream入参StreamConfig，初始化本地音视频流对象。流只有初始化完成后才可以播放。【请求参数】无【返回参数】流初始化结果：StreamInitializeResult类型。StreamInitializeResult表示流初始化的结果。对象继承自Rt
- [远端流对象（RemoteStream）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0142.md): 该对象继承自Stream对象。【功能说明】获取远端流所属用户的用户名【请求参数】无【返回参数】string类型，远端流所属用户的用户名。
- [流事件通知（RTCStreamEvent）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0143.md): 本章节介绍了Web SDK的RTCStreamEvent事件。事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。【事件说明】播放状态变更事件。在播放状态变更的时候触发。【回调参数】event：playState类型。字段定义如下：type：string类型，表示播放器类型，取值为video/audio。id：str
- [错误码（RtcError）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0144.md): 【功能说明】获取错误码。【请求参数】无【返回参数】number类型，错误码值。【功能说明】获取错误描述。【请求参数】无【返回参数】string类型，错误码描述。
- [客户端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0145.md): 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。
- [服务端错误码](https://support.huaweicloud.com/csdk-rtc/rtc_05_0146.md): 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。
- [授权浏览器摄像头/麦克风访问权限的方法](https://support.huaweicloud.com/csdk-rtc/rtc_05_0147.md): 打开谷歌浏览器，单击右上角设置图标。单击“设置”，打开设置页面。选择“隐私设置和安全性”，再单击“网站设置”。进入网站设置页面，分别单击“摄像头”和“麦克风”。进入摄像头、麦克风授权页面，选择网站可以请求使用您的摄像头、麦克风权限即可。完成以上设置后，浏览器在需要使用摄像头、麦克风时，就会在页面弹出设备询问框，选择“允许”即可。打开火狐浏
- [常见问题](https://support.huaweicloud.com/csdk-rtc/rtc_05_0148.md): 加入房间时，userName必须填吗？非必填。userName、userId由App自定义，但可以相同。userId：必填，string[64]类型，用户标识，userId需要保证应用内唯一。userId支持的字符包括：a-z、A-Z、0-9、连接符 '-'、下划线 '_'。userName：选填，string[128]类型，用户昵称。非
- [修订记录](https://support.huaweicloud.com/csdk-rtc/rtc_05_0149.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [接入鉴权](https://support.huaweicloud.com/csdk-rtc/rtc_05_0348.md): 为保证SparkRTC的通信安全，当用户加入房间时，华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在SDK加入房间时设置signature和ctime。signature为标识签名，由租户使用华为云Sp
- [Grs国家/地区码对照表](https://support.huaweicloud.com/csdk-rtc/rtc_05_0352.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [修订记录](https://support.huaweicloud.com/csdk-rtc/rtc_05_0353.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 常见问题

- [SparkRTC支持哪些平台？](https://support.huaweicloud.com/rtc_faq/rtc_06_0008.md): SparkRTC支持的平台有Android、iOS、MAC、Windows和Web。其中支持的各平台系统版本如下所示：Android：支持Android 5.0及以上版本。iOS：支持iOS 8.0及以上版本。MAC：支持MacOS10.11或以上版本，x86_64。Windows：支持Windows 7或以上版本，32位。Web：支持的
- [SparkRTC Demo怎么体验？](https://support.huaweicloud.com/rtc_faq/rtc_06_0035.md): 您可以提交工单联系华为云技术客服，获取各平台对应的Demo进行体验。
- [在进行Windows的Demo使用或集成SDK时，提示微软C++标准库缺失，该如何获取？](https://support.huaweicloud.com/rtc_faq/rtc_06_0088.md): 请下载对应平台的微软C++标准库，安装成功后，重新运行即可。
- [SparkRTC支持接入微信小程序吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0003.md): SparkRTC不支持微信小程序端SDK。
- [实时音视频是什么？](https://support.huaweicloud.com/rtc_faq/rtc_06_0060.md): 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。具体请参见《实时音视频 产品介绍》 。
- [实时音视频和直播有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0005.md): 直播时延3~5S，分为推流端、直播中心和播放端，推流端将采集的直播流推送到直播中心，直播中心可以对直播流进行处理然后分发。推流协议支持RTMP，播放协议支持RTMP、HTTP-FLV和HLS。实时音视频时延小于400ms，可适用于1对1或1对多的音视频通话，以及多人视频连麦和低时延视频直播。华为云SparkRTC服务提供了兼容全平台的SD
- [SparkRTC是否支持在国外使用？](https://support.huaweicloud.com/rtc_faq/rtc_06_0089.md): 支持。SparkRTC提供覆盖全球的高质量、大规模的实时音视频网络。
- [SparkRTC RoomID是什么？取值区间值是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0037.md): RoomID是房间ID，房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离；只有在同一个房间里的用户才可以相互接收音视频；房间ID的命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合；RoomID由租户自定义。
- [SparkRTC最多可以同时创建多少个房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0006.md): SparkRTC对同时并发存在的房间数暂未做限制。
- [SparkRTC UserID是什么？取值范围是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0038.md): UserID是实时音视频服务用来区分应用中用户的唯一标识。用户标识是用户在实时音视频服务中的一个表示，开发者按照规范自定义UserID。命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合。
- [怎么理解SparkRTC的角色Role？](https://support.huaweicloud.com/rtc_faq/rtc_06_0039.md): 角色Role是指用户在房间内的不同角色类型，不同角色类型有不同的权限模型。主要有如下三种角色类型：主播（publisher）：只发流不收流主播型角色。SparkRTC预留的角色类型。互动观众（joiner）：既能发流也能收流的互动型角色。普通观众（player）：只收流的观看型角色。SparkRTC示例Demo中的角色切换、上台/下台、上
- [SparkRTC最多可以支持多少个人同时视频通话？](https://support.huaweicloud.com/rtc_faq/rtc_06_0007.md): 单个房间最多支持500个人同时以主播角色加入，对观众人数未做相关限制。
- [实时音视频的时延是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0019.md): SparkRTC具备丰富的节点资源储备，保证端到端平均时延小于200ms。
- [SparkRTC是否支持连麦互动？](https://support.huaweicloud.com/rtc_faq/rtc_06_0040.md): SparkRTC支持加入同一房间的用户连麦互动。
- [SparkRTC是否支持双向的桌面推送？](https://support.huaweicloud.com/rtc_faq/rtc_06_0046.md): 不支持，目前是在1个房间内同一时刻可由1个人共享（屏幕、窗口或者区域）。
- [实时音视频支持私有化部署吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0020.md): 华为云实时音视频服务暂不支持私有化部署。如需使用请提交工单联系华为技术工程师。
- [PC端实时音视频支持USB摄像头吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0085.md): 支持，您可以直接将USB摄像头插入PC端即可。
- [SparkRTC支持哪些平台？](https://support.huaweicloud.com/rtc_faq/rtc_06_0008.md): SparkRTC支持的平台有Android、iOS、MAC、Windows和Web。其中支持的各平台系统版本如下所示：Android：支持Android 5.0及以上版本。iOS：支持iOS 8.0及以上版本。MAC：支持MacOS10.11或以上版本，x86_64。Windows：支持Windows 7或以上版本，32位。Web：支持的
- [SparkRTC Demo怎么体验？](https://support.huaweicloud.com/rtc_faq/rtc_06_0035.md): 您可以提交工单联系华为云技术客服，获取各平台对应的Demo进行体验。
- [在进行Windows的Demo使用或集成SDK时，提示微软C++标准库缺失，该如何获取？](https://support.huaweicloud.com/rtc_faq/rtc_06_0088.md): 请下载对应平台的微软C++标准库，安装成功后，重新运行即可。
- [SparkRTC支持接入微信小程序吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0003.md): SparkRTC不支持微信小程序端SDK。
- [实时音视频是什么？](https://support.huaweicloud.com/rtc_faq/rtc_06_0060.md): 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。具体请参见《实时音视频 产品介绍》 。
- [实时音视频和直播有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0005.md): 直播时延3~5S，分为推流端、直播中心和播放端，推流端将采集的直播流推送到直播中心，直播中心可以对直播流进行处理然后分发。推流协议支持RTMP，播放协议支持RTMP、HTTP-FLV和HLS。实时音视频时延小于400ms，可适用于1对1或1对多的音视频通话，以及多人视频连麦和低时延视频直播。华为云SparkRTC服务提供了兼容全平台的SD
- [SparkRTC是否支持在国外使用？](https://support.huaweicloud.com/rtc_faq/rtc_06_0089.md): 支持。SparkRTC提供覆盖全球的高质量、大规模的实时音视频网络。
- [SparkRTC RoomID是什么？取值区间值是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0037.md): RoomID是房间ID，房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离；只有在同一个房间里的用户才可以相互接收音视频；房间ID的命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合；RoomID由租户自定义。
- [SparkRTC最多可以同时创建多少个房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0006.md): SparkRTC对同时并发存在的房间数暂未做限制。
- [SparkRTC UserID是什么？取值范围是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0038.md): UserID是实时音视频服务用来区分应用中用户的唯一标识。用户标识是用户在实时音视频服务中的一个表示，开发者按照规范自定义UserID。命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合。
- [怎么理解SparkRTC的角色Role？](https://support.huaweicloud.com/rtc_faq/rtc_06_0039.md): 角色Role是指用户在房间内的不同角色类型，不同角色类型有不同的权限模型。主要有如下三种角色类型：主播（publisher）：只发流不收流主播型角色。SparkRTC预留的角色类型。互动观众（joiner）：既能发流也能收流的互动型角色。普通观众（player）：只收流的观看型角色。SparkRTC示例Demo中的角色切换、上台/下台、上
- [SparkRTC最多可以支持多少个人同时视频通话？](https://support.huaweicloud.com/rtc_faq/rtc_06_0007.md): 单个房间最多支持500个人同时以主播角色加入，对观众人数未做相关限制。
- [实时音视频的时延是多少？](https://support.huaweicloud.com/rtc_faq/rtc_06_0019.md): SparkRTC具备丰富的节点资源储备，保证端到端平均时延小于200ms。
- [SparkRTC是否支持连麦互动？](https://support.huaweicloud.com/rtc_faq/rtc_06_0040.md): SparkRTC支持加入同一房间的用户连麦互动。
- [SparkRTC是否支持双向的桌面推送？](https://support.huaweicloud.com/rtc_faq/rtc_06_0046.md): 不支持，目前是在1个房间内同一时刻可由1个人共享（屏幕、窗口或者区域）。
- [实时音视频支持私有化部署吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0020.md): 华为云实时音视频服务暂不支持私有化部署。如需使用请提交工单联系华为技术工程师。
- [PC端实时音视频支持USB摄像头吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0085.md): 支持，您可以直接将USB摄像头插入PC端即可。
- [SparkRTC有哪些计费项？](https://support.huaweicloud.com/rtc_faq/rtc_06_0002.md): 华为云实时音视频服务的计费项分为基础服务费用和增值服务费用两类。基础服务费用：包含语音通话和视频通话费用。增值服务费用：包含云端录制和云端合流转码费用，增值服务是基于基础服务之上额外提供的增值功能，无法脱离基础服务单独使用，使用增值服务需支付额外的增值费用。各计费项详情请参见SparkRTC产品价格详情。
- [SparkRTC中既订阅视频也有音频时，视频按分辨率收费还要加上音频费用吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0048.md): 用户进入房间且成功接收到视频，只统计视频分钟数，不再收取音频费用。只有当用户没有订阅视频时，才会统计语音时长。
- [纯音频场景下不同码率的音频计费有区别吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0049.md): 纯音频场景，不区分音频码率。
- [如何查看账单及扣费明细？](https://support.huaweicloud.com/rtc_faq/rtc_06_0052.md): 您可以在费用中心的“账单管理 > 费用账单”中查看具体账单及扣费明细。
- [能否直接开通后付费？](https://support.huaweicloud.com/rtc_faq/rtc_06_0054.md): 华为云实时音视频服务默认按需计费，您可以先使用后付费，不使用时不计费。
- [为什么房间里只有一个人且没有发生音视频通话也会产生费用？](https://support.huaweicloud.com/rtc_faq/rtc_06_0134.md): SparkRTC服务的计费方式为计算每个进入房间的用户观看其他用户的时长按分辨率级别计费，即下行计费。若只有一个人在房间，即使不推流（不产生上行数据），也会占用SparkRTC的云服务资源。当只有一个人在房间时无法订阅他人的音视频流，因此不会接收到视频画面，只按照语音时长统计服务用量。具体计费详情请参见计费说明。
- [SparkRTC有哪些计费项？](https://support.huaweicloud.com/rtc_faq/rtc_06_0002.md): 华为云实时音视频服务的计费项分为基础服务费用和增值服务费用两类。基础服务费用：包含语音通话和视频通话费用。增值服务费用：包含云端录制和云端合流转码费用，增值服务是基于基础服务之上额外提供的增值功能，无法脱离基础服务单独使用，使用增值服务需支付额外的增值费用。各计费项详情请参见SparkRTC产品价格详情。
- [SparkRTC中既订阅视频也有音频时，视频按分辨率收费还要加上音频费用吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0048.md): 用户进入房间且成功接收到视频，只统计视频分钟数，不再收取音频费用。只有当用户没有订阅视频时，才会统计语音时长。
- [纯音频场景下不同码率的音频计费有区别吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0049.md): 纯音频场景，不区分音频码率。
- [如何查看账单及扣费明细？](https://support.huaweicloud.com/rtc_faq/rtc_06_0052.md): 您可以在费用中心的“账单管理 > 费用账单”中查看具体账单及扣费明细。
- [能否直接开通后付费？](https://support.huaweicloud.com/rtc_faq/rtc_06_0054.md): 华为云实时音视频服务默认按需计费，您可以先使用后付费，不使用时不计费。
- [为什么房间里只有一个人且没有发生音视频通话也会产生费用？](https://support.huaweicloud.com/rtc_faq/rtc_06_0134.md): SparkRTC服务的计费方式为计算每个进入房间的用户观看其他用户的时长按分辨率级别计费，即下行计费。若只有一个人在房间，即使不推流（不产生上行数据），也会占用SparkRTC的云服务资源。当只有一个人在房间时无法订阅他人的音视频流，因此不会接收到视频画面，只按照语音时长统计服务用量。具体计费详情请参见计费说明。
- [什么是Signature？](https://support.huaweicloud.com/rtc_faq/rtc_06_0056.md): 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。signatu
- [如何获取密钥？](https://support.huaweicloud.com/rtc_faq/rtc_06_0057.md): app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取：登录实时音视频控制台。在左侧导航栏中，选择“应用管理”，进入应用管理页面。在目标应用行单击应用名称，进入应用详情页面。“鉴权私钥”可见状态下，复制应用的鉴权私钥。应用详情界面“鉴权私钥”可见状态下，复制应用的鉴权私钥。应用详
- [服务端如何计算Signature？](https://support.huaweicloud.com/rtc_faq/rtc_06_0058.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [什么是Signature？](https://support.huaweicloud.com/rtc_faq/rtc_06_0056.md): 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。signatu
- [如何获取密钥？](https://support.huaweicloud.com/rtc_faq/rtc_06_0057.md): app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取：登录实时音视频控制台。在左侧导航栏中，选择“应用管理”，进入应用管理页面。在目标应用行单击应用名称，进入应用详情页面。“鉴权私钥”可见状态下，复制应用的鉴权私钥。应用详情界面“鉴权私钥”可见状态下，复制应用的鉴权私钥。应用详
- [服务端如何计算Signature？](https://support.huaweicloud.com/rtc_faq/rtc_06_0058.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [SparkRTC如何实现云端录制？](https://support.huaweicloud.com/rtc_faq/rtc_06_0041.md): 具体操作步骤请参见云端录制管理。
- [SparkRTC云端录制文件存储在哪里？](https://support.huaweicloud.com/rtc_faq/rtc_06_0042.md): 录制内容不断上传至您预先设定的云存储中，具体请参见云端录制管理。
- [单流录制模式和合流录制模式有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0135.md): 单流和合流录制模式的主要区别如下：单流录制：支持将房间中的每一个用户的音视频流分别录制成独立的文件。例如，在线课堂场景中，若家长只想观看老师和自己孩子的视频，则可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。单流录制的具体实现方法请参见创建单流录制任务。合流录制：支持将房间中的多路音视频进行云端混
- [如何恢复已删除的录音文件？](https://support.huaweicloud.com/rtc_faq/rtc_06_0087.md): 由于录制文件是存储在OBS桶中的，若需要恢复已删除的录制文件，则需保证删除录制文件前OBS桶已开启多版本控制功能。若桶开启了多版本控制功能，则删除的对象会保存到“已删除对象”列表中，您可以在“已删除对象”列表中恢复对象。若桶没有开启多版本控制功能，则已删除的对象不可恢复。
- [如何对录制回调进行鉴权？](https://support.huaweicloud.com/rtc_faq/rtc_06_0144.md): 为保证录制回调通信安全，租户可以配置录制回调参数“回调秘钥”，对录制回调消息进行鉴权。本章节介绍录制回调鉴权签名的生成方法。将如下参数拼接为一个字符串。代码如下所示：String content = X-Rtc-Rand + X-Rtc-Timestamp + msg;代码如下所示：使用录制回调配置里面的回调秘玥“key”，通过HMAC-
- [SparkRTC如何实现云端录制？](https://support.huaweicloud.com/rtc_faq/rtc_06_0041.md): 具体操作步骤请参见云端录制管理。
- [SparkRTC云端录制文件存储在哪里？](https://support.huaweicloud.com/rtc_faq/rtc_06_0042.md): 录制内容不断上传至您预先设定的云存储中，具体请参见云端录制管理。
- [单流录制模式和合流录制模式有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0135.md): 单流和合流录制模式的主要区别如下：单流录制：支持将房间中的每一个用户的音视频流分别录制成独立的文件。例如，在线课堂场景中，若家长只想观看老师和自己孩子的视频，则可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。单流录制的具体实现方法请参见创建单流录制任务。合流录制：支持将房间中的多路音视频进行云端混
- [如何恢复已删除的录音文件？](https://support.huaweicloud.com/rtc_faq/rtc_06_0087.md): 由于录制文件是存储在OBS桶中的，若需要恢复已删除的录制文件，则需保证删除录制文件前OBS桶已开启多版本控制功能。若桶开启了多版本控制功能，则删除的对象会保存到“已删除对象”列表中，您可以在“已删除对象”列表中恢复对象。若桶没有开启多版本控制功能，则已删除的对象不可恢复。
- [如何对录制回调进行鉴权？](https://support.huaweicloud.com/rtc_faq/rtc_06_0144.md): 为保证录制回调通信安全，租户可以配置录制回调参数“回调秘钥”，对录制回调消息进行鉴权。本章节介绍录制回调鉴权签名的生成方法。将如下参数拼接为一个字符串。代码如下所示：String content = X-Rtc-Rand + X-Rtc-Timestamp + msg;代码如下所示：使用录制回调配置里面的回调秘玥“key”，通过HMAC-
- [移动端（Android/iOS）创建一个房间，是否支持PC端（MAC/Windows）接入？](https://support.huaweicloud.com/rtc_faq/rtc_06_0016.md): 支持，SparkRTC支持全平台互通。
- [iOS平台如何缩减安装包体积？](https://support.huaweicloud.com/rtc_faq/rtc_06_0064.md): 对于iPhone 5s及以上版本的手机只支持打包arm64架构，您可以将XCode的“Build Setting < Build Active Architecture Only”设置为“YES”，并将Valid Architectures填写为arm64 ，则可以将SparkRTC SDK安装包压缩到一半的体积。
- [Android平台如何缩减安装包体积？](https://support.huaweicloud.com/rtc_faq/rtc_06_0065.md): 根据目标设备架构，您可以选择只打包armeabi-v7a，或者只打包arm64-v8a。
- [iOS端是否可以监听远端离开房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0070.md): 可以使用onRemoteUserOffline监听用户离开房间事件。
- [背景音乐是否支持循环播放？](https://support.huaweicloud.com/rtc_faq/rtc_06_0096.md): 支持，调用startAudioFile接口，设置循环次数cycle为0，表示无限循环播放。
- [SparkRTC是否支持调整背景音乐的播放进度？](https://support.huaweicloud.com/rtc_faq/rtc_06_0097.md): 支持，播放进度可以通过setAudioFilePosition接口设置。
- [支持监听房间成员进出房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0098.md): 支持，可通过onRemoteUserOnline或onRemoteUserOffline监听房间成员进出房间信息。
- [如何监测断网和重连？](https://support.huaweicloud.com/rtc_faq/rtc_06_0099.md): 可通过onConnectionChangedNotify回调。
- [支持首帧渲染回调吗？能否监听画面开始渲染？](https://support.huaweicloud.com/rtc_faq/rtc_06_0100.md): 支持，可通过onFirstLocalVideoFrameNotify回调。
- [如何设置上行视频码率、分辨率和帧率？](https://support.huaweicloud.com/rtc_faq/rtc_06_0103.md): 建议您参考setVideoEncoderConfig，配置分辨率以达到更合适的画面质量。
- [有没有推荐的画面质量（码率、分辨率、帧率）相关参数配置？](https://support.huaweicloud.com/rtc_faq/rtc_06_0104.md): 华为SDK系统有默认的编码设置（720P+360P），可以不设置发流编码参数。若您需要自定义发流编码参数，请参考华为SDK系统推荐码表不同分辨率的码率和帧率配置推荐值和不同场景下帧率和码率的推荐值进行设置。
- [如何实现横屏视频通话？](https://support.huaweicloud.com/rtc_faq/rtc_06_0105.md): 调用setLayoutDirect接口，设置显示模式layoutDirect为0，表示设置为横屏模式。
- [是否支持网络测速？如何操作？](https://support.huaweicloud.com/rtc_faq/rtc_06_0106.md): 支持，可调用startNetworkTest接口，通过onNetworkTestQuality回调。
- [是否支持音量大小提示？](https://support.huaweicloud.com/rtc_faq/rtc_06_0107.md): 支持，可通过onUserVolumeStatsNotify接口回调。
- [自定义渲染支持哪些格式？](https://support.huaweicloud.com/rtc_faq/rtc_06_0108.md): 具体请参见setExternalVideoFrameOutputEnable接口。
- [SparkRTC支持iOS后台运行吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0109.md): 进入后台运行后，摄像头功能将暂停，音频功能正常工作。
- [移动端如何实现录屏（屏幕分享）？](https://support.huaweicloud.com/rtc_faq/rtc_06_0111.md): 具体实现方法请参见屏幕分享（Android）、屏幕分享（IOS）。
- [多人视频会议中，移动端和Web端可以进入同一房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0112.md): 可以，使用相同的appID和roomID即可进入同一房间。
- [SparkRTC的Web端、移动端、PC端是不是同步的？](https://support.huaweicloud.com/rtc_faq/rtc_06_0120.md): 是的，实时音视频支持全平台互通。
- [Android SDK是否支持自定义采集数据？](https://support.huaweicloud.com/rtc_faq/rtc_06_0127.md): 支持，具体请参见自定义音频采集和渲染和自定义视频采集和渲染实现。
- [SparkRTC支持旁路推流吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0129.md): 支持，具体请参见startPublishStream、updateTransCoding、stopPublishStream接口。
- [Windows端如何才能采集到被分享应用播放的声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0131.md): 通过调用setShareComputerSound接口，可打开系统声音采集。
- [SDK是否支持断线重连机制？](https://support.huaweicloud.com/rtc_faq/rtc_06_0133.md): 支持，您也可以通过disableRejoinRoom关闭重连房间功能。
- [如何创建房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0090.md): 房间是由SparkRTC后台在客户端进房时自动创建的，您无需手动创建房间，只需调用客户端的相关接口加入房间即可。具体接口详情请参见客户端SDK参考。
- [两台手机同时运行SparkRTC APP，为什么无法互通？](https://support.huaweicloud.com/rtc_faq/rtc_06_0015.md): 请确认两个手机设置的roomId是否相同，仅roomId相同才可进入同一房间进行互动，且userId不能相同，SparkRTC不支持同一个userId在两个不同设备上同时使用。
- [鉴权是如何生成的？在什么时候生成？](https://support.huaweicloud.com/rtc_faq/rtc_06_0061.md): 在加入房间时生成鉴权，并传入加入房间的参数中，鉴权的生成具体可参考接入鉴权。
- [onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃？](https://support.huaweicloud.com/rtc_faq/rtc_06_0067.md): 回调函数的入参localStats和remoteStats指针有可能为空，需要先判断不为空再使用，否则可能引发空指针错误。
- [为什么本端听筒能听到自己的声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0068.md): 调用muteRemoteAudio时，参数设置为自己的uid就会发生此类情况。
- [setExternalAudioCapture（音频自采集）、setExternalVideoCapture（视频自采集）、setExternalMediaFrameOutput（视频自渲染）能在进入房间后开启吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0069.md): 不可以，需要在加入房间前调用，在加入房间后不能修改。
- [SparkRTC是否支持设置镜像画面？](https://support.huaweicloud.com/rtc_faq/rtc_06_0071.md): 支持，通过updateLocalRenderMode接口设置本地摄像头预览画面的镜像模式。
- [SparkRTC音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取？](https://support.huaweicloud.com/rtc_faq/rtc_06_0072.md): 可以通过onRtcStats() 接口获取到上下行码率、分辨率、丢包率、音频采样率等统计信息。
- [SparkRTC是否支持设置本地采集音量？是否支持设置每个远端用户的播放音量？](https://support.huaweicloud.com/rtc_faq/rtc_06_0073.md): 支持，通过adjustRecordingVolume()接口可以设置SDK的采集音量，通过adjustPlaybackVolume()接口可以设置某个远端用户的播放音量。
- [enableLocalVideo和muteLocalVideo有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0074.md): 两者的主要区别如下：enableLocalVideo：是否开启本地视频采集，当关闭时，本地和远端画面都将是黑屏。muteLocalVideo：是否向后台发送自己的视频画面，当关闭时，其他用户的远端画面将变成黑屏，本地的预览还是能看到画面。
- [enableLocalAudioStream和muteLocalAudio有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0075.md): 两者的主要区别如下：enableLocalAudioStream：是否开启本地音频采集，默认开启，当关闭时，是关闭本地音频的采集和上行。muteLocalAudio：是否向后台发送自己的音频流，当关闭时，并不会停止发送音视频数据，而是会继续发送码率极低的静音包。
- [SparkRTC是否支持对房间进行权限校验？](https://support.huaweicloud.com/rtc_faq/rtc_06_0076.md): 支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。具体请参见接入鉴权。
- [接入PC端是否支持屏幕分享功能？](https://support.huaweicloud.com/rtc_faq/rtc_06_0091.md): 支持，您可以参考如下内容实现屏幕共享：屏幕分享（Windows）屏幕分享（Mac）屏幕分享（Web）
- [SparkRTC是否支持将本地视频文件分享到实时音视频中？](https://support.huaweicloud.com/rtc_faq/rtc_06_0092.md): 支持，可以通过以下两种实现方式：直接共享屏幕让房间内的其他用户看到本地视频。通过自采集的方式，采集本地视频文件的数据，让房间内的其他用户看到。具体请参见各端接口参考。
- [SparkRTC是否支持单纯的实时音频？](https://support.huaweicloud.com/rtc_faq/rtc_06_0093.md): 支持，对端不看视频画面即可。
- [一个房间里可以同时有多路屏幕分享吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0094.md): 目前一个房间只能有一路辅流的屏幕分享。
- [SparkRTC是否支持1080P？](https://support.huaweicloud.com/rtc_faq/rtc_06_0095.md): 根据视频流是主流或辅流有以下两种情况：主流：主要指摄像头采集的视频流，SparkRTC对同一视频源支持最多同时编码和收发720P/360P/180P/90P四种档位的数据类型。辅流：也称共享流，指共享屏幕或窗口的视频流。默认1080P，开启辅流流畅优先指切换为720P。
- [是否支持视频画面截图功能？](https://support.huaweicloud.com/rtc_faq/rtc_06_0101.md): 暂不支持，您可以使用PC、Android或iOS自带的截图API。
- [播放背景音乐是否支持在线音乐？](https://support.huaweicloud.com/rtc_faq/rtc_06_0102.md): 暂不支持。
- [同一个页面中，可以创建N个RTC对象，通过N个UserID，分别登录到N个房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0113.md): 可以。
- [Web端用宽高设置的推流分辨率适用于所有浏览器吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0114.md): 由于设备和浏览器的限制，视频分辨率不一定能够完全匹配，在这种情况下，浏览器会自动调整分辨率使其接近Profile对应的分辨率，具体请参见setVideoProfile。
- [Web端SDK在使用过程中拔掉摄像头，摄像头列表里面的数据如何清除？](https://support.huaweicloud.com/rtc_faq/rtc_06_0115.md): 可以通过调用getCameras接口看是否能获取到新的设备列表，如果仍然能获取到已拔掉的摄像头信息，说明浏览器没有刷新此列表信息，Web端SDK也无法获取新的设备列表信息。
- [Web端SDK可以获取当前音量大小吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0116.md): 可以调用getAudioLevel接口获取当前音量大小。
- [Web端支持监听远端离开房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0117.md): 支持监听远端退房事件，建议使用客户端事件中的client.on('peer-leave') 事件实现远端用户退房通知。
- [Web端通话过程中为什么会出现回声、杂音、噪声、声音小？](https://support.huaweicloud.com/rtc_faq/rtc_06_0118.md): 通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点。当其他端听到Web端的声音存在回声、噪声、杂音等情况时，说明Web端的3A处理没有生效。若您使用了浏览器原生getUserMedia接口进行自定义采集，则需要手动设置3A参数，详细设置请参见媒体追踪约束。echoCancellation：回声消除开关noiseSuppre
- [Web端如何切换摄像头和麦克风？](https://support.huaweicloud.com/rtc_faq/rtc_06_0119.md): 音视频输入设备通过设备ID（deviceId）标识，每个音视频设备均有一个唯一的设备ID，您可以通过getDevices方法获取。设备ID是随机生成的，部分情况下同一个设备的ID可能会改变，因此建议您每次切换设备时都先调用getDevices获取设备ID。您可以先通过getDevices获取到系统的摄像头和麦克风设备后，调用switchD
- [SparkRTC支持白板功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0121.md): 不支持，白板功能是为APP层级的应用。
- [相同UserID支持同时进入多个房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0122.md): 可以。
- [SparkRTC房间的生命周期是多久？](https://support.huaweicloud.com/rtc_faq/rtc_06_0123.md): 主要有以下几种情况：第一个加入房间的用户为当前房间的所有者，但该用户无法主动解散房间。所有用户都主动退房时，后台立即解散房间。如果房间内的单个用户异常掉线，超过保活时间后服务端会将该用户清理出当前房间。如果房间内的所有用户都异常掉线，超过保活时间后服务端会自动解散当前房间。当用户要加入的房间不存在时，后台会自动创建一个房间。
- [SparkRTC多人视频通话支持蓝牙耳机吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0124.md): 支持。
- [SparkRTC多人视频通话支持仅订阅2/3/4人音频吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0125.md): 支持，SparkRTC提供音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用请参见切换音频模式。
- [指定窗口分享，当窗口大小变化时，视频流的分辨率会跟着变化吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0126.md): 会发生变化。
- [视频通话支持悬浮窗、大小画面切换功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0128.md): 此类功能属于UI布局逻辑，SDK并不限制UI上的展示处理。
- [发送自定义消息接口能实现聊天室、弹幕等功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0130.md): 不支持。
- [支持查询所有的UserID吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0132.md): 暂不支持统计所有UserID。
- [Web SDK中的checkSystemRequirements接口为什么会调用异常？](https://support.huaweicloud.com/rtc_faq/rtc_06_0137.md): 请排查Web SDK版本号是否在2.0.2到2.0.9.300之间。这些版本支持strictCheckBrowser参数，该参数用于强校验微信浏览器白名单功能，存在兼容性风险。请务必在2023年10月29日前，更新至2.0.9.301及之后的版本。影响范围为微信浏览器。
- [移动端（Android/iOS）创建一个房间，是否支持PC端（MAC/Windows）接入？](https://support.huaweicloud.com/rtc_faq/rtc_06_0016.md): 支持，SparkRTC支持全平台互通。
- [iOS平台如何缩减安装包体积？](https://support.huaweicloud.com/rtc_faq/rtc_06_0064.md): 对于iPhone 5s及以上版本的手机只支持打包arm64架构，您可以将XCode的“Build Setting < Build Active Architecture Only”设置为“YES”，并将Valid Architectures填写为arm64 ，则可以将SparkRTC SDK安装包压缩到一半的体积。
- [Android平台如何缩减安装包体积？](https://support.huaweicloud.com/rtc_faq/rtc_06_0065.md): 根据目标设备架构，您可以选择只打包armeabi-v7a，或者只打包arm64-v8a。
- [iOS端是否可以监听远端离开房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0070.md): 可以使用onRemoteUserOffline监听用户离开房间事件。
- [背景音乐是否支持循环播放？](https://support.huaweicloud.com/rtc_faq/rtc_06_0096.md): 支持，调用startAudioFile接口，设置循环次数cycle为0，表示无限循环播放。
- [SparkRTC是否支持调整背景音乐的播放进度？](https://support.huaweicloud.com/rtc_faq/rtc_06_0097.md): 支持，播放进度可以通过setAudioFilePosition接口设置。
- [支持监听房间成员进出房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0098.md): 支持，可通过onRemoteUserOnline或onRemoteUserOffline监听房间成员进出房间信息。
- [如何监测断网和重连？](https://support.huaweicloud.com/rtc_faq/rtc_06_0099.md): 可通过onConnectionChangedNotify回调。
- [支持首帧渲染回调吗？能否监听画面开始渲染？](https://support.huaweicloud.com/rtc_faq/rtc_06_0100.md): 支持，可通过onFirstLocalVideoFrameNotify回调。
- [如何设置上行视频码率、分辨率和帧率？](https://support.huaweicloud.com/rtc_faq/rtc_06_0103.md): 建议您参考setVideoEncoderConfig，配置分辨率以达到更合适的画面质量。
- [有没有推荐的画面质量（码率、分辨率、帧率）相关参数配置？](https://support.huaweicloud.com/rtc_faq/rtc_06_0104.md): 华为SDK系统有默认的编码设置（720P+360P），可以不设置发流编码参数。若您需要自定义发流编码参数，请参考华为SDK系统推荐码表不同分辨率的码率和帧率配置推荐值和不同场景下帧率和码率的推荐值进行设置。
- [如何实现横屏视频通话？](https://support.huaweicloud.com/rtc_faq/rtc_06_0105.md): 调用setLayoutDirect接口，设置显示模式layoutDirect为0，表示设置为横屏模式。
- [是否支持网络测速？如何操作？](https://support.huaweicloud.com/rtc_faq/rtc_06_0106.md): 支持，可调用startNetworkTest接口，通过onNetworkTestQuality回调。
- [是否支持音量大小提示？](https://support.huaweicloud.com/rtc_faq/rtc_06_0107.md): 支持，可通过onUserVolumeStatsNotify接口回调。
- [自定义渲染支持哪些格式？](https://support.huaweicloud.com/rtc_faq/rtc_06_0108.md): 具体请参见setExternalVideoFrameOutputEnable接口。
- [SparkRTC支持iOS后台运行吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0109.md): 进入后台运行后，摄像头功能将暂停，音频功能正常工作。
- [移动端如何实现录屏（屏幕分享）？](https://support.huaweicloud.com/rtc_faq/rtc_06_0111.md): 具体实现方法请参见屏幕分享（Android）、屏幕分享（IOS）。
- [多人视频会议中，移动端和Web端可以进入同一房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0112.md): 可以，使用相同的appID和roomID即可进入同一房间。
- [SparkRTC的Web端、移动端、PC端是不是同步的？](https://support.huaweicloud.com/rtc_faq/rtc_06_0120.md): 是的，实时音视频支持全平台互通。
- [Android SDK是否支持自定义采集数据？](https://support.huaweicloud.com/rtc_faq/rtc_06_0127.md): 支持，具体请参见自定义音频采集和渲染和自定义视频采集和渲染实现。
- [SparkRTC支持旁路推流吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0129.md): 支持，具体请参见startPublishStream、updateTransCoding、stopPublishStream接口。
- [Windows端如何才能采集到被分享应用播放的声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0131.md): 通过调用setShareComputerSound接口，可打开系统声音采集。
- [SDK是否支持断线重连机制？](https://support.huaweicloud.com/rtc_faq/rtc_06_0133.md): 支持，您也可以通过disableRejoinRoom关闭重连房间功能。
- [如何创建房间？](https://support.huaweicloud.com/rtc_faq/rtc_06_0090.md): 房间是由SparkRTC后台在客户端进房时自动创建的，您无需手动创建房间，只需调用客户端的相关接口加入房间即可。具体接口详情请参见客户端SDK参考。
- [两台手机同时运行SparkRTC APP，为什么无法互通？](https://support.huaweicloud.com/rtc_faq/rtc_06_0015.md): 请确认两个手机设置的roomId是否相同，仅roomId相同才可进入同一房间进行互动，且userId不能相同，SparkRTC不支持同一个userId在两个不同设备上同时使用。
- [鉴权是如何生成的？在什么时候生成？](https://support.huaweicloud.com/rtc_faq/rtc_06_0061.md): 在加入房间时生成鉴权，并传入加入房间的参数中，鉴权的生成具体可参考接入鉴权。
- [onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃？](https://support.huaweicloud.com/rtc_faq/rtc_06_0067.md): 回调函数的入参localStats和remoteStats指针有可能为空，需要先判断不为空再使用，否则可能引发空指针错误。
- [为什么本端听筒能听到自己的声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0068.md): 调用muteRemoteAudio时，参数设置为自己的uid就会发生此类情况。
- [setExternalAudioCapture（音频自采集）、setExternalVideoCapture（视频自采集）、setExternalMediaFrameOutput（视频自渲染）能在进入房间后开启吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0069.md): 不可以，需要在加入房间前调用，在加入房间后不能修改。
- [SparkRTC是否支持设置镜像画面？](https://support.huaweicloud.com/rtc_faq/rtc_06_0071.md): 支持，通过updateLocalRenderMode接口设置本地摄像头预览画面的镜像模式。
- [SparkRTC音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取？](https://support.huaweicloud.com/rtc_faq/rtc_06_0072.md): 可以通过onRtcStats() 接口获取到上下行码率、分辨率、丢包率、音频采样率等统计信息。
- [SparkRTC是否支持设置本地采集音量？是否支持设置每个远端用户的播放音量？](https://support.huaweicloud.com/rtc_faq/rtc_06_0073.md): 支持，通过adjustRecordingVolume()接口可以设置SDK的采集音量，通过adjustPlaybackVolume()接口可以设置某个远端用户的播放音量。
- [enableLocalVideo和muteLocalVideo有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0074.md): 两者的主要区别如下：enableLocalVideo：是否开启本地视频采集，当关闭时，本地和远端画面都将是黑屏。muteLocalVideo：是否向后台发送自己的视频画面，当关闭时，其他用户的远端画面将变成黑屏，本地的预览还是能看到画面。
- [enableLocalAudioStream和muteLocalAudio有什么区别？](https://support.huaweicloud.com/rtc_faq/rtc_06_0075.md): 两者的主要区别如下：enableLocalAudioStream：是否开启本地音频采集，默认开启，当关闭时，是关闭本地音频的采集和上行。muteLocalAudio：是否向后台发送自己的音频流，当关闭时，并不会停止发送音视频数据，而是会继续发送码率极低的静音包。
- [SparkRTC是否支持对房间进行权限校验？](https://support.huaweicloud.com/rtc_faq/rtc_06_0076.md): 支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。具体请参见接入鉴权。
- [接入PC端是否支持屏幕分享功能？](https://support.huaweicloud.com/rtc_faq/rtc_06_0091.md): 支持，您可以参考如下内容实现屏幕共享：屏幕分享（Windows）屏幕分享（Mac）屏幕分享（Web）
- [SparkRTC是否支持将本地视频文件分享到实时音视频中？](https://support.huaweicloud.com/rtc_faq/rtc_06_0092.md): 支持，可以通过以下两种实现方式：直接共享屏幕让房间内的其他用户看到本地视频。通过自采集的方式，采集本地视频文件的数据，让房间内的其他用户看到。具体请参见各端接口参考。
- [SparkRTC是否支持单纯的实时音频？](https://support.huaweicloud.com/rtc_faq/rtc_06_0093.md): 支持，对端不看视频画面即可。
- [一个房间里可以同时有多路屏幕分享吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0094.md): 目前一个房间只能有一路辅流的屏幕分享。
- [SparkRTC是否支持1080P？](https://support.huaweicloud.com/rtc_faq/rtc_06_0095.md): 根据视频流是主流或辅流有以下两种情况：主流：主要指摄像头采集的视频流，SparkRTC对同一视频源支持最多同时编码和收发720P/360P/180P/90P四种档位的数据类型。辅流：也称共享流，指共享屏幕或窗口的视频流。默认1080P，开启辅流流畅优先指切换为720P。
- [是否支持视频画面截图功能？](https://support.huaweicloud.com/rtc_faq/rtc_06_0101.md): 暂不支持，您可以使用PC、Android或iOS自带的截图API。
- [播放背景音乐是否支持在线音乐？](https://support.huaweicloud.com/rtc_faq/rtc_06_0102.md): 暂不支持。
- [同一个页面中，可以创建N个RTC对象，通过N个UserID，分别登录到N个房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0113.md): 可以。
- [Web端用宽高设置的推流分辨率适用于所有浏览器吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0114.md): 由于设备和浏览器的限制，视频分辨率不一定能够完全匹配，在这种情况下，浏览器会自动调整分辨率使其接近Profile对应的分辨率，具体请参见setVideoProfile。
- [Web端SDK在使用过程中拔掉摄像头，摄像头列表里面的数据如何清除？](https://support.huaweicloud.com/rtc_faq/rtc_06_0115.md): 可以通过调用getCameras接口看是否能获取到新的设备列表，如果仍然能获取到已拔掉的摄像头信息，说明浏览器没有刷新此列表信息，Web端SDK也无法获取新的设备列表信息。
- [Web端SDK可以获取当前音量大小吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0116.md): 可以调用getAudioLevel接口获取当前音量大小。
- [Web端支持监听远端离开房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0117.md): 支持监听远端退房事件，建议使用客户端事件中的client.on('peer-leave') 事件实现远端用户退房通知。
- [Web端通话过程中为什么会出现回声、杂音、噪声、声音小？](https://support.huaweicloud.com/rtc_faq/rtc_06_0118.md): 通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点。当其他端听到Web端的声音存在回声、噪声、杂音等情况时，说明Web端的3A处理没有生效。若您使用了浏览器原生getUserMedia接口进行自定义采集，则需要手动设置3A参数，详细设置请参见媒体追踪约束。echoCancellation：回声消除开关noiseSuppre
- [Web端如何切换摄像头和麦克风？](https://support.huaweicloud.com/rtc_faq/rtc_06_0119.md): 音视频输入设备通过设备ID（deviceId）标识，每个音视频设备均有一个唯一的设备ID，您可以通过getDevices方法获取。设备ID是随机生成的，部分情况下同一个设备的ID可能会改变，因此建议您每次切换设备时都先调用getDevices获取设备ID。您可以先通过getDevices获取到系统的摄像头和麦克风设备后，调用switchD
- [SparkRTC支持白板功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0121.md): 不支持，白板功能是为APP层级的应用。
- [相同UserID支持同时进入多个房间吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0122.md): 可以。
- [SparkRTC房间的生命周期是多久？](https://support.huaweicloud.com/rtc_faq/rtc_06_0123.md): 主要有以下几种情况：第一个加入房间的用户为当前房间的所有者，但该用户无法主动解散房间。所有用户都主动退房时，后台立即解散房间。如果房间内的单个用户异常掉线，超过保活时间后服务端会将该用户清理出当前房间。如果房间内的所有用户都异常掉线，超过保活时间后服务端会自动解散当前房间。当用户要加入的房间不存在时，后台会自动创建一个房间。
- [SparkRTC多人视频通话支持蓝牙耳机吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0124.md): 支持。
- [SparkRTC多人视频通话支持仅订阅2/3/4人音频吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0125.md): 支持，SparkRTC提供音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用请参见切换音频模式。
- [指定窗口分享，当窗口大小变化时，视频流的分辨率会跟着变化吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0126.md): 会发生变化。
- [视频通话支持悬浮窗、大小画面切换功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0128.md): 此类功能属于UI布局逻辑，SDK并不限制UI上的展示处理。
- [发送自定义消息接口能实现聊天室、弹幕等功能吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0130.md): 不支持。
- [支持查询所有的UserID吗？](https://support.huaweicloud.com/rtc_faq/rtc_06_0132.md): 暂不支持统计所有UserID。
- [Web SDK中的checkSystemRequirements接口为什么会调用异常？](https://support.huaweicloud.com/rtc_faq/rtc_06_0137.md): 请排查Web SDK版本号是否在2.0.2到2.0.9.300之间。这些版本支持strictCheckBrowser参数，该参数用于强校验微信浏览器白名单功能，存在兼容性风险。请务必在2023年10月29日前，更新至2.0.9.301及之后的版本。影响范围为微信浏览器。
- [SparkRTC通话出现无声、黑屏、卡顿等如何排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0047.md): SparkRTC视镜产品提供端到端链路质量分析和用量质量查看，具体请参见通话调查和数据洞察。
- [企业类客户加入房间失败、无声、黑屏问题如何排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0138.md): 由于企业类用户内部一般都有网络安全设置，可能会导致使用SparkRTC通话失败。首先应排查内部网络问题，保证客户网络和公网互通，或防火墙需要放开下述限制：解除所有IP访问的限制。在客户端防火墙配置SparkRTC端口和域名白名单。配置SparkRTC端口的防火墙白名单，如表1所示。防火墙端口白名单端口类型端口TCP端口443、6447UD
- [为什么入会的时候没有声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0080.md): 可能是由于以下原因导致：入会前没有订阅。服务端出现问题。远端没有开启视频流。
- [为什么视频会出现卡顿？](https://support.huaweicloud.com/rtc_faq/rtc_06_0081.md): 网络、设备性能等原因都可能导致视频出现卡顿。若出现视频播放卡顿问题，您可以先参考如下方法进行初步排查。自检操作，您可以从以下几方面进行排查。判断是持续性的还是一次性的卡顿。一次性的卡顿是由网络和设备的随机性导致，属于正常现象。检查网络状态，判断连接是否正常。如果网络连接正常但依然卡顿，请尝试更换网络连接，检查在网络状态良好的条件下是否依然
- [如何处理视频黑屏问题？](https://support.huaweicloud.com/rtc_faq/rtc_06_0082.md): 常见的视频黑屏问题有以下三种情况：本地视频黑屏远端视频正常。本地视频正常远端视频黑屏。本地远端视频都黑屏。可能导致出现视频黑屏的原因如下：本地网络信号差或者信号中断。通话中有一方的网络出现问题，其他人也会看不到此用户的视频。用户主动关闭了视频。您可以通过视镜功能进行端到端链路检查。若问题仍未解决，建议您提交工单，申请华为云技术客服协助解决
- [为什么无法打开摄像头？](https://support.huaweicloud.com/rtc_faq/rtc_06_0083.md): 摄像头打开失败有多种原因，建议您参照如下方面进行初步排查：确认摄像头权限是否已打开。Android和iOS系统都有权限管理，请在系统设置中进行检查。同时Android的部分安全软件也会进行权限管理。检查是否有其他应用占据了摄像头。若有请关闭后，重启手机再打开摄像头。摄像头硬件问题。打开系统自带的拍摄视频程序看是否可以录像。若上述方法均无法
- [什么原因导致跨房不成功？](https://support.huaweicloud.com/rtc_faq/rtc_06_0084.md): 可能由于以下原因导致：同一时间不同房间最多只有一个Joiner角色才能跨房成功。同一时间最多只能跨4个房间，跨房对应的房间ID必须互不相同。当前的远端音频模式（setRemoteAudioMode）设置为HWRtcRemoteAudioTopOfAll模式时，不支持跨房。
- [SparkRTC启动云端录制但没有生成录制文件怎么排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0043.md): 用户的obs桶云资源授权、obs冻结、obs设置加密等因素都可能导致下发录制保存obs桶失败，建议您参照如下方面初步排查录制保存obs桶失败的原因。检查是否给桶授权。检查obs桶是否欠费。检查是否给obs桶设置加密。
- [集成SparkRTC加入房间失败是什么原因？](https://support.huaweicloud.com/rtc_faq/rtc_06_0136.md): 请确认是否已接入鉴权，SparkRTC要求所有应用以鉴权方式接入，具体鉴权方法请参见接入鉴权。
- [SparkRTC通话出现无声、黑屏、卡顿等如何排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0047.md): SparkRTC视镜产品提供端到端链路质量分析和用量质量查看，具体请参见通话调查和数据洞察。
- [企业类客户加入房间失败、无声、黑屏问题如何排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0138.md): 由于企业类用户内部一般都有网络安全设置，可能会导致使用SparkRTC通话失败。首先应排查内部网络问题，保证客户网络和公网互通，或防火墙需要放开下述限制：解除所有IP访问的限制。在客户端防火墙配置SparkRTC端口和域名白名单。配置SparkRTC端口的防火墙白名单，如表1所示。防火墙端口白名单端口类型端口TCP端口443、6447UD
- [为什么入会的时候没有声音？](https://support.huaweicloud.com/rtc_faq/rtc_06_0080.md): 可能是由于以下原因导致：入会前没有订阅。服务端出现问题。远端没有开启视频流。
- [为什么视频会出现卡顿？](https://support.huaweicloud.com/rtc_faq/rtc_06_0081.md): 网络、设备性能等原因都可能导致视频出现卡顿。若出现视频播放卡顿问题，您可以先参考如下方法进行初步排查。自检操作，您可以从以下几方面进行排查。判断是持续性的还是一次性的卡顿。一次性的卡顿是由网络和设备的随机性导致，属于正常现象。检查网络状态，判断连接是否正常。如果网络连接正常但依然卡顿，请尝试更换网络连接，检查在网络状态良好的条件下是否依然
- [如何处理视频黑屏问题？](https://support.huaweicloud.com/rtc_faq/rtc_06_0082.md): 常见的视频黑屏问题有以下三种情况：本地视频黑屏远端视频正常。本地视频正常远端视频黑屏。本地远端视频都黑屏。可能导致出现视频黑屏的原因如下：本地网络信号差或者信号中断。通话中有一方的网络出现问题，其他人也会看不到此用户的视频。用户主动关闭了视频。您可以通过视镜功能进行端到端链路检查。若问题仍未解决，建议您提交工单，申请华为云技术客服协助解决
- [为什么无法打开摄像头？](https://support.huaweicloud.com/rtc_faq/rtc_06_0083.md): 摄像头打开失败有多种原因，建议您参照如下方面进行初步排查：确认摄像头权限是否已打开。Android和iOS系统都有权限管理，请在系统设置中进行检查。同时Android的部分安全软件也会进行权限管理。检查是否有其他应用占据了摄像头。若有请关闭后，重启手机再打开摄像头。摄像头硬件问题。打开系统自带的拍摄视频程序看是否可以录像。若上述方法均无法
- [什么原因导致跨房不成功？](https://support.huaweicloud.com/rtc_faq/rtc_06_0084.md): 可能由于以下原因导致：同一时间不同房间最多只有一个Joiner角色才能跨房成功。同一时间最多只能跨4个房间，跨房对应的房间ID必须互不相同。当前的远端音频模式（setRemoteAudioMode）设置为HWRtcRemoteAudioTopOfAll模式时，不支持跨房。
- [SparkRTC启动云端录制但没有生成录制文件怎么排查？](https://support.huaweicloud.com/rtc_faq/rtc_06_0043.md): 用户的obs桶云资源授权、obs冻结、obs设置加密等因素都可能导致下发录制保存obs桶失败，建议您参照如下方面初步排查录制保存obs桶失败的原因。检查是否给桶授权。检查obs桶是否欠费。检查是否给obs桶设置加密。
- [集成SparkRTC加入房间失败是什么原因？](https://support.huaweicloud.com/rtc_faq/rtc_06_0136.md): 请确认是否已接入鉴权，SparkRTC要求所有应用以鉴权方式接入，具体鉴权方法请参见接入鉴权。