检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口参考 主入口（HRTC） 客户端对象（Client） 客户端事件通知（ClientEvent） 流对象（Stream） 本地流对象（LocalStream） 远端流对象（RemoteStream） 流事件通知（RTCStreamEvent） 错误码（RtcError） 客户端错误码
播放音效文件 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音效文件 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现流程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playAudioClip
SparkRTC有哪些计费项？ 华为云实时音视频服务的计费项分为基础服务费用和增值服务费用两类。 基础服务费用：包含语音通话和视频通话费用。 增值服务费用：包含云端录制和云端合流转码费用，增值服务是基于基础服务之上额外提供的增值功能，无法脱离基础服务单独使用，使用增值服务需支付额外的增值费用
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持播放wav、pcm和单声道mp3音频文件，支持本地或在线文件路径。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playAudioClip
示例1：创建单流录制任务 场景描述 若您需要对某一个房间的实时音视频进行录制，可以在加入房间后，调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS
音频管理 muteRemoteAudio public abstract int muteRemoteAudio(String userId, boolean mute); 【功能说明】 设置是否接收对应远端用户的音频流。 【请求参数】 userId：用户ID。 mute：true
加入多频道（跨房） 功能描述 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。 注意事项 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同
加入多频道（跨房） 功能描述 跨房间连麦，指主播的媒体流可以同时转发进多个（目前最多支持四个）房间频道，实现主播跨频道与其他主播实时互动的场景。房间中的所有主播可以看见彼此，房间中的观众可以看到所有主播。 注意事项 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同
如何对录制回调进行鉴权？ 为保证录制回调通信安全，租户可以配置录制回调参数“回调秘钥”，对录制回调消息进行鉴权。本章节介绍录制回调鉴权签名的生成方法。 参数说明 表1 参数说明 参数 说明 X-Rtc-Rand 消息请求头中的随机数。 X-Rtc-Timestamp 消息请求头中的时间戳
流对象（Stream） 本章节介绍了Web SDK的Stream接口详情。 表1 Stream接口 接口 描述 play 播放该音视频流。 stop 停止播放视频流。 resume 恢复播放音视频。 close 关闭音视频。 muteAudio 禁用音频轨道。 muteVideo
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 Token认证：通过Token认证调用请求
切换音频模式 功能描述 用户在入会前可通过调用enableTopThreeAudioMode切换为音频最大三方模式。 会中通过调用switchAudioMode(2)将音频切换为订阅模式。订阅模式下，本地用户必须通过主动订阅远端用户音频流，才可接收该用户音频。 会中通过调用switchAudioMode
云资源授权 您可以将OBS桶授权给SparkRTC服务，允许录制文件存储在OBS桶中。 注意事项 授权的OBS桶所在区域必须为华北-北京四。 前提条件 因录制生成的视频文件是存储在OBS服务中的，因此，您需要先开通OBS服务，具体请参见OBS快速入门。 已在OBS服务中创建用于存储录制文件的
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
SparkRTC支持哪些平台？ SparkRTC支持的平台有Android、iOS、MAC、Windows和Web。其中支持的各平台系统版本如下所示： Android：支持Android 5.0及以上版本。 iOS：支持iOS 8.0及以上版本。 MAC：支持MacOS10.11或以上版本
播放音乐文件 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 可以播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音乐文件
接收增值（录制）事件回调通知内容 SparkRTC服务回调用户提供的接口时，会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号，可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id
屏幕共享 startScreenShare - (int)startScreenShare; 【功能说明】 开启屏幕共享功能。 【请求参数】 无 【返回参数】 0：成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 目前可支持多路辅流共享，若需开启多辅流，请提交工单联系技术支持处理
为什么房间里只有一个人且没有发生音视频通话也会产生费用？ SparkRTC服务的计费方式为计算每个进入房间的用户观看其他用户的时长按分辨率级别计费，即下行计费。若只有一个人在房间，即使不推流（不产生上行数据），也会占用SparkRTC的云服务资源。当只有一个人在房间时无法订阅他人的音视频流
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
