检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
表1 功能说明 类别 功能分类 功能说明 基本功能 初始化等基础接口 主要功能包括创建/销毁RTC引擎、设置日志保存位置等。 房间功能 主要功能包括进入/离开房间操作、设置角色、创建跨房引擎等。 音频管理 主要功能包括是否采集/发送本地音频流、是否接收远端音频流、调整录制/播放音量值、设置远端音频模式等。
SDK使用 创建引擎。 AppId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 HRTCEngineConfig config = new HRTCEngineConfig(); config.setAppId(appId); // AppId需在控制台中创建应用后获取
删除录制规则 功能介绍 调用此接口删除录制规则，对于正在使用的录制规则，不允许删除。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v2/apps/
查询录制规则 功能介绍 调用此接口查询指定录制规则。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/record-rules/{rule_id}
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后，修改后的规则对正在录制的流无效。 修改后对新的流有效，生效时间为5分钟，即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API E
其使用方法。 初始化等基础接口 表1 初始化等基础接口 接口 描述 sharedEngine 创建连麦引擎实例 destroy 注销引擎 initWithConfig 初始化引擎配置信息 logUpload 上传日志 setEnableRtcStats 打点开关 getVersion
创建或更新录制规则 功能介绍 调用此接口创建或更新录制规则。 若当前app在请求的location中无录制规则，则会创建新的录制规则 若当前app在请求的location中已有录制规则，则会更新原来的录制规则 接口约束 一个app在一个location最多创建一个录制规则。 调试
onJoinRoomFailure：加入房间失败。 onRemoteUserOnline：远端用户收到当前用户加入房间的通知。 音频的自动订阅策略设置只在音频订阅模式下生效。 leaveRoom virtual int leaveRoom() 【功能说明】 离开房间。 【返回参数】 0：方法调用成功。
查询录制规则列表 功能介绍 调用此接口查询录制规则列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/record-rules
onFirstRemoteVideoDecoded 引擎收到第一帧远端视频流并解码成功回调 onFirstRemoteVideoDecoded 引擎收到第一帧远端视频流并解码成功回调 onFirstRemoteAuxiliaryStreamDecoded 引擎收到第一帧远端辅流并解码成功回调 o
还可以调用setAuxiliaryVideoEncodeSmooth来切换屏幕共享的分辨率，从默认的1080p切换为720p。 示例代码如下： //获取引擎 IHRTCEngine* engine = CRtcEngineMgr::GetInstance()->GetEngine(); // 定义屏幕共享区域参数
单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。 初始化等基础接口 表1 初始化等基础接口 接口 描述 destroyConnection 注销引擎 initWithRoomId 根据房间ID获取connection setVideoFrameObserver 使能视频前后处理 renewAuthorization
接口位置查看其使用方法。 初始化等基础接口 表1 初始化等基础接口 接口 描述 create 创建SparkRTC引擎实例 destroy 销毁SparkRTC引擎 logUpload 上传日志 disableRejoinRoom 设置是否禁用房间重连功能。 enableStats
录制规则管理 创建或更新录制规则 查询录制规则列表 查询录制规则 更新录制规则 删除录制规则
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
SDK使用 创建引擎并初始化。 域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 12 _rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig
areTarget设置共享桌面参数。桌面共享不支持区域共享。 然后调用startScreenShare开始共享。 示例代码如下： //获取引擎 rtcEngine = [HWRtcEngine sharedEngine]; // 定义屏幕共享区域参数 HWRtcScreenShareParam
HRTCEngineContext &context); 【功能说明】 IHRtcEngine对象初始化函数。 【请求参数】 context：引擎初始化参数, 具体请参见HRTCEngineContext。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。
undefined，无法获取到媒体源。 可能有以下原因： 原因1：系统未允许应用访问摄像头等媒体源，解决方法请参见授权浏览器摄像头/麦克风访问方法。 原因2：由于浏览器的策略，仅允许通过https://方式或者localhost的方式访问用户的摄像头和麦克风权限。 原因3：检查摄像头等设备是否被其他应用占用了。
具体请参见事件回调(IHRTCConnectionEventHandler)中相关接口和回调。 【请求参数】 roomId：房间ID。 eventHandler：引擎事件句柄，用于加入房间、离开房间等事件回调，具体请参见事件回调(IHRTCConnectionEventHandler)。 【返回参数】 不为null：成功。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
