检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
保存录制文件所在的桶信息 record_formats 是 Array of strings 录制格式：支持HLS格式和MP4格式（HLS和MP4为大写）。 若配置HLS则必须携带HLSRecordConfig参数 若配置MP4则需要携带MP4RecordConfig hls_config
保存录制文件所在的桶信息 record_formats 是 Array of strings 录制格式：支持HLS格式和MP4格式（HLS和MP4为大写）。 若配置HLS则必须携带HLSRecordConfig参数 若配置MP4则需要携带MP4RecordConfig hls_config
RecordObsFileAddr object 保存录制文件所在的桶信息 record_formats Array of strings 录制格式：HLS格式或者MP4格式 hls_config HLSRecordConfig object hls格式录制规则管理 mp4_config MP4RecordConfig
支持自启动录制，开启后对房间内每一个流进行录制。 录制指定的媒体类型，支持仅录制音频、仅录制视频、同时录制音视频。 支持录制MP4、HLS文件，音频编码类型支持AAC。 支持获取回调消息中的播放URL进行回放，回调消息中的downloadurl字段为OBS播放地址，使用该URL播放将会在OBS中产生对应的下载流量或者带宽费用。
RecordObsFileAddr object 保存录制文件所在的桶信息 record_formats Array of strings 录制格式：HLS格式或者MP4格式 hls_config HLSRecordConfig object hls格式录制规则管理 mp4_config MP4RecordConfig
的录制文件。以下情况会触发该事件： 录制开始，开始创建第一个录制文件。 断流恢复后，若“最大断流合并时长”配置为“断流后生成新文件”，则开始创建新的录制文件。 当前录制时长超过了配置的录制周期，则开始新的录制文件生成。 RECORD_FILE_COMPLETE：表示录制文件生成完成。以下情况会触发该事件：
推流端将采集的直播流推送到直播中心，直播中心可以对直播流进行处理然后分发。推流协议支持RTMP，播放协议支持RTMP、HTTP-FLV和HLS。 实时音视频时延小于400ms，可适用于1对1或1对多的音视频通话，以及多人视频连麦和低时延视频直播。华为云SparkRTC服务提供了兼容全平台的SDK。
播放音效文件 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音效文件 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用
getAudioClipDuration(String filePath); 【功能说明】 获取音效的文件时长。 【请求参数】 filePath：音效文件路径，支持本地文件和网络文件。 【返回参数】 > 0：音效文件时长，单位为ms。 <= 0：方法调用失败。具体请参见客户端错误码。 preloadAudioClip
startPos:(int)startPos; 【功能说明】 播放音效文件并启动混音，需要在有joiner加入房间后调用。 【请求参数】 soundId：音效ID，取值>= 0。 filePath：音效文件路径，支持本地文件和网络文件。 loop：音效文件播放次数，0为循环播放。 pitch：音调大小，（当前不支持）。
获取项目ID 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。具体获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 在“API凭证”页面，即可获取对应的账号ID信息。 图1 获取账号ID 父主题： 附录
播放音乐文件 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 可以播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音乐文件
getAudioClipDuration(const char *filePath) 【功能说明】 获取音效的文件时长。 【请求参数】 filePath：音效文件路径，支持本地文件和网络文件。 【返回参数】 > 0：音效文件时长，单位为ms。 <= 0：方法调用失败。具体请参见HRTCErrorCode。
存储-桶 存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式：
如何获取密钥？ app_key为华为云SparkRTC针对每个app生成的鉴权密钥，需要安全保存，谨防泄漏。您可以通过以下方式获取： 登录实时音视频控制台。 在左侧导航栏中，选择“应用管理”，进入应用管理页面。 在目标应用行单击应用名称，进入应用详情页面。 “鉴权私钥”可见状态下，复制应用的鉴权私钥。
存储-桶 存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式：
(volume) 获取音频文件总时长 音频文件播放成功后，可以调用getAudioMixingDuration获取音频文件总时长，用于刷新界面进度条的总时长。 localStream.getAudioMixingDuration() 获取音频文件播放进度 音频文件播放成功后，可以调
RECORD_NEW_FILE_START：录制模块开始创建新的文件。 RECORD_FILE_COMPLETE：录制模块生成文件完成。 CLOUD_RECORD_SERVER_OVER：云端录制任务结束。 record_format 否 String 录制格式，取值如下。 HLS MP4 download_url
别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
