检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
客户端对象（Client） 本章节介绍了Web SDK的Client接口详情。 表1 Client接口 接口 描述 join 加入房间。调用该接口让用户加入指定房间，进行音频/视频通话。 leave 离开房间。用户结束通话后须调用该接口离开房间。 publish 加入房间后，发布本地流。
创建应用 功能介绍 调用此接口创建应用。 接口约束 不支持同一租户创建多个app_name相同的应用。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2/apps
房间功能 joinRoom - (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam; 【功能说明】 加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。 【请求参数】
合流录制 场景说明 将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。 合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面
屏幕分享 功能描述 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。 接口调用流程 实现屏幕共享 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 共享桌面 加入房间后可以调用setAuxiliaryVideoEncoderConfig
播放音乐 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。 接口调用步骤 实现过程 加入房间
常见问题分析解决办法 问题1：调用setVideoEncoderConfig接口时，为什么有些参数直接报参数设置错误？ 设置分辨率时请使用华为SDK系统推荐的码表才能设置成功。 问题2：有哪些原因会导致跨房不成功？ 可能原因1：同一时间不同房间最多只有一个Joiner角色才能跨房成功。
播放音乐文件 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 可以播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音乐文件
播放音乐 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间
播放音乐 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。 接口调用流程 实现过程 加入房间
SDK使用 移动端（Android/iOS）创建一个房间，是否支持PC端（MAC/Windows）接入？ iOS平台如何缩减安装包体积？ Android平台如何缩减安装包体积？ iOS端是否可以监听远端离开房间？ 背景音乐是否支持循环播放？ SparkRTC是否支持调整背景音乐的播放进度？
播放音频文件（混音） 功能描述 混音是将音频文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音频文件，播放给房间内的其他用户听。 支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间并发布本端主流
SDK使用 以下为集成SDK进行实时音视频互动直播的基本流程： 创建引擎。 appId获取方法请参见创建应用。 m_pRtcEngine = createHRtcEngine(); // 创建引擎 HRTCLogConfig logConfig; logConfig.level =
SDK使用 检测浏览器是否兼容 SDK。具体接口详情请参见checkSystemRequirements。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 async isBrowserSupport() { let check =
如何对录制回调进行鉴权？ 为保证录制回调通信安全，租户可以配置录制回调参数“回调秘钥”，对录制回调消息进行鉴权。本章节介绍录制回调鉴权签名的生成方法。 参数说明 表1 参数说明 参数 说明 X-Rtc-Rand 消息请求头中的随机数。 X-Rtc-Timestamp 消息请求头中的时间戳。
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持播放wav、pcm和单声道mp3音频文件，支持本地或在线文件路径。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playAudio
示例1：创建单流录制任务 场景描述 若您需要对某一个房间的实时音视频进行录制，可以在加入房间后，调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现流程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playA
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playA
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
