检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
示例1：创建单流录制任务已介绍了如何将房间中的每一个用户的音视频流分别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 否 String 域名 app_id 是 String 应用id room_id 是 String 房间ID user_id 否 String 发送端用户 peer_id
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
服务端错误码 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要APP干预或进行用户提示。该错误码由服务端产生，通过onError返回。 表1 服务端错误码 错误码 描述 错误原因 RTC.10000001 内部错误 程序或环境问题 RTC.31000000 节点不存在
setDefaultSpeakerModel：设置默认的声音播放模式。 onMediaConnectStateChangedNotify：增加与媒体服务器连接状态变化的通知回调。 onFirstRemoteAuxiliaryStreamDecoded：引擎收到第一帧远端辅流并解码成功的回调。
e。 该接口限制在房间外调用，在房间内设置不生效，需要调用stopLocalPreview关闭预览，否则将一直处于预览状态。 在房间内预览：可调用setupLocalView设置有效view开启预览，设置为0表示关闭预览，不需要调用startLocalPreview和stopLocalPreview。
Mode：经setRemoteAudioMode整合后已废弃。 参数变更的接口及回调： changeUserRole：不再需要roomId参数，跨房所在房间用HWRtcConnection连接调用角色切换接口，HWRtcEngine只作其所在房间的角色切换。 2021-01-28
API概览 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 应用管理接口 表1 应用管理接口 接口 说明 POST /v2/apps 创建应用 GET
调用跨房连接的joinRoom接口加入房间，其中HWRtcUserInfo的signature鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HWRtcRoleJoiner，否则可以设为HWRtcRolePlayer，只收流不发流。
间，其中HRTCJoinParam的authorization鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HRTC_ROLE_TYPE_JOINER，否则可以设为HRTC_ROLE
调用跨房连接的joinRoom接口加入房间，其中HWRtcUserInfo的signature鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HWRtcRoleJoiner，否则可以设为HWRtcRolePlayer，只收流不发流。
SparkRTC多人视频通话支持仅订阅2/3/4人音频吗？ 支持，SparkRTC提供音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用请参见切换音频模式。 父主题： SDK使用
replace:(int)replace startPos:(unsigned int)startPos; 【功能说明】 接口一：设置播放的音频文件，需要入会调用才生效。 接口二：启动音频混音。 接口三：开始播放音频文件。当前只支持本地播放。若角色为“publisher”，不支持调用。 【请求参数】
有没有推荐的画面质量（码率、分辨率、帧率）相关参数配置？ 华为SDK系统有默认的编码设置（720P+360P），可以不设置发流编码参数。若您需要自定义发流编码参数，请参考华为SDK系统推荐码表不同分辨率的码率和帧率配置推荐值和不同场景下帧率和码率的推荐值进行设置。 父主题： SDK使用
SparkRTC是否支持对房间进行权限校验？ 支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接
释放IHRTCConnection对象，如果未离会，会自动离会再释放连接，会触发onDestroyConnection回调。 如果资源已经释放，不能继续使用该对象，需要重新调用createConnection。 getRoomId virtual const char* getRoomId() 【功能说明】
udioFrame; 【功能说明】 是否需要开启音频后处理。 【返回参数】 YES：开启。 NO：不开启。 requireMixedAudioFrame - (BOOL)requireMixedAudioFrame; 【功能说明】 是否需要开启全部音频混音数据回调。 【返回参数】
0：方法调用失败。具体请参见HRTCErrorCode。 华为SDK系统有默认的编码设置（720P+360P），一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数，请参考华为SDK系统推荐码表：表7 不同分辨率的码率和帧率配置推荐和不同场景下帧率和码率的推荐值，否则可能设置失败。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
