检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
客户端对象（Client） 本章节介绍了Web SDK的Client接口详情。 表1 Client接口 接口 描述 join 加入房间。调用该接口让用户加入指定房间，进行音频/视频通话。 leave 离开房间。用户结束通话后须调用该接口离开房间。 publish 加入房间后，发布本地流。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 Token认证：通过Token认证调用请求。
事件回调（IHRTCAudioFrameObserver） 表1 音频事件回调说明 接口 描述 onAudioFramePlayback 音频播放回调（后处理） onAudioFrameMixed 音频混音处理回调 onAudioFrameRecord 音频采集回调（前处理） r
Web端通话过程中为什么会出现回声、杂音、噪声、声音小？ 通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点。当其他端听到Web端的声音存在回声、噪声、杂音等情况时，说明Web端的3A处理没有生效。 若您使用了浏览器原生getUserMedia接口进行自定义采集，
音频自采集和音频自渲染 功能描述 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求： app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 接口调用流程
音频自采集和音频自渲染 功能描述 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求： 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 接口调用流程 实现过程 加入房间
什么是Signature？ 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“use
自定义视频采集 功能描述 实时视频传输过程中，HWRtcEngine SDK通常会启动默认的视频模块进行采集和渲染。在以下场景中，您可能会发现默认的视频模块无法满足开发需求： app中已有自己的视频模块。 需要使用自定义的采集或播放处理。 某些视频采集设备被系统独占。 接口调用流程
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 -
音频自采集和音频自渲染 功能描述 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求： app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 注意事项
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 void
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 -
音频自采集和音频自渲染 功能介绍 实时音频传输过程中，HWRtcEngine SDK 通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求： app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 接口调用流程
如何获取密钥？ app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取： 登录实时音视频控制台。 在左侧导航栏中，选择“应用管理”，进入应用管理页面。 在目标应用行单击应用名称，进入应用详情页面。 “鉴权私钥”可见状态下，复制应用的鉴权私钥。
用量统计 您可以根据应用名称查询近90天的音视频互动时长。 注意事项 “用量统计”非实时刷新，每5分钟统计一次，数据展示可能会有5分钟左右的延迟。 查询说明 支持最大查询跨度31天，最大查询周期90天。 操作步骤 登录实时音视频控制台。 在左侧导航树中选择“用量统计”，进入用量统计页面。
示例2：创建合流录制任务 场景描述 示例1：创建单流录制任务已介绍了如何将房间中的每一个用户的音视频流分别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api
单流录制 场景说明 将房间中的每一个用户的音视频流分别录制成独立的文件。 录制机制 SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。 图1 单流录制 图2 单流自动录制 实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
实时音视频和直播有什么区别？ 直播时延3~5S，分为推流端、直播中心和播放端，推流端将采集的直播流推送到直播中心，直播中心可以对直播流进行处理然后分发。推流协议支持RTMP，播放协议支持RTMP、HTTP-FLV和HLS。 实时音视频时延小于400ms，可适用于1对1或1对多的音
如何处理视频黑屏问题？ 常见的视频黑屏问题有以下三种情况： 本地视频黑屏远端视频正常。 本地视频正常远端视频黑屏。 本地远端视频都黑屏。 可能导致出现视频黑屏的原因如下： 本地网络信号差或者信号中断。 通话中有一方的网络出现问题，其他人也会看不到此用户的视频。 用户主动关闭了视频。
合流录制 场景说明 将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。 合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
