检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK使用 创建引擎。 AppId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 HRTCEngineConfig config = new HRTCEngineConfig(); config.setAppId(appId); // AppId需在控制台中创建应用后获取
辅流管理 setAuxiliaryVideoEncodeSmooth public abstract int setAuxiliaryVideoEncodeSmooth(boolean enabled); 【功能说明】 设置是否开启辅流的流畅度优先。 【请求参数】 enable：
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明】
自采集自渲染 setExternalVideoCapture virtual int setExternalVideoCapture(bool enable, HRTCVideoFrameFormat format) 【功能说明】 设置是否开启外部视频采集。 【请求参数】 ena
自定义视频采集 功能描述 如果您需要使用自定义的美颜库或有前处理库，则需要自己采集和处理摄像头拍摄画面，您可以通过SparkRTC SDK的setExternalVideoCapture接口开启自采集功能。然后使用pushExternalVideoFrame接口推送外部视频数据到SparkRTC
查询历史规模 功能介绍 查询指标过去每天的规模数量，可查询最近31天的数据。当天未结束，无法查到当天的房间数与用户数。 最大查询跨度31天。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
本地流对象（LocalStream） 该对象继承自Stream对象，并有如下新增接口。 表1 LocalStream接口 接口 描述 initialize 本地流初始化。 setAudioProfile 设置音频流配置。 setVideoProfile 设置视频流配置。 setScreenProfile
查询单流任务状态 功能介绍 调用此接口查询单流任务状态。 租户的OBS桶内的情况，暂不支持查询。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/ap
示例1：创建单流录制任务 场景描述 若您需要对某一个房间的实时音视频进行录制，可以在加入房间后，调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
客户端事件通知（ClientEvent） 本章节介绍了Web SDK的ClientEvent事件。 表1 ClientEvent事件 接口 描述 peer-join 远端用户进入房间事件。 peer-leave 远端用户退出房间事件。 stream-added 远端流添加事件。 stream-removed
启动合流任务 功能介绍 调用此接口创建合流转码任务。 支持纯音频录制和音视频录制： 纯音频录制 encode_template填audio_only，音频合流会动态选择最大三方的声音。 layout_template、layout_panes以及其他视频相关参数都不填，填就忽略。
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明】
自定义视频采集和渲染 setExternalVideoCapture - (int)setExternalVideoCapture:(BOOL)enabled format:(HWRtcVideoImageFormat)format; 【功能说明】 设置是否开启外部视频采集。需要在加入房间前调用。
pFailure 关闭采集失败 HWRtcLocalAudioReasonErrorAccessDenied 音频设备API无法访问，可能是设备隐私权限设置问题 HWRtcLocalAudioReasonErrorOnExclusiveMode 音频设备处于独占模式，且被其他应用独占
客户端对象（Client） 本章节介绍了Web SDK的Client接口详情。 表1 Client接口 接口 描述 join 加入房间。调用该接口让用户加入指定房间，进行音频/视频通话。 leave 离开房间。用户结束通话后须调用该接口离开房间。 publish 加入房间后，发布本地流。
屏幕共享 功能描述 基于苹果的Replaykit方案，支持用户分享整个系统的屏幕内容，但需要App额外提供一个Extension扩展组件，可实现跨应用屏幕共享。 创建App Group 由于华为云SparkRTC是通过App Goup进行进程间的数据通信的，所以需要创建一个App
客户端错误码 本章节介绍了SDK的客户端错误码HRTCErrorCode的详细信息。 当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要App干预或进行用户提示。 枚举 错误码 描述 错误原因 HRTC_ERR_CODE_SUCCESS 0 成功 - HRTC_ER
支持连麦互动，观众可自由通过角色切换进行上下麦，切换过程平滑。 在线教育-小班课、互动直播 云端录制 提供云端录制功能，支持单流/混流的模式将录制下来的文件存储到OBS或者点播服务中。 存储、录制审核、视频双录等。 文件混音 支持将本地或在线的音频和用户声音混音，发送给房间内其他用户。 在线教育、语聊房、在线合唱等。
创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到其他用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 用户离开房间后，需销毁对应资源。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
