检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
C SDK的个人信息，您应通过华为云客户的应用提供的路径实现您的个人信息主体权利。 为保障您访问、复制、更正或删除个人信息的权利实现，我们在与华为云客户的协议中，明确要求华为云客户承诺根据法律法规要求，向您提供便捷的权利实现方式。同时，我们的开放能力也向华为云客户提供了相关的接口
事件回调（IHRTCEngine） 本章节介绍了全平台C++ SDK的回调接口IHRTCEngineEventHandler的详情。 表1 事件回调说明 接口 描述 onError 错误回调。 onJoinRoomSuccess 成功加入房间回调。 onJoinRoomFailure
uffer:(CMSampleBufferRef)sampleBuffer; 【功能说明】 发送录屏数据。需要在sampleHandle的实现类中的processSampleBuffer: 方法中调用。 【请求参数】 sampleBuffer：录屏数据。 【返回参数】 无 父主题：
注册回调（IHRTCMediaEngine） 表1 IHRTCMediaEngine 接口 描述 setVideoFrameObserver 注册原始视频媒体数据监听回调 setAudioFrameObserver 注册原始音频媒体数据监听回调 setEncDecryptFrameObserver
已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS 创建桶API进行创建，并在SparkRTC控制台中完成OBS桶授权。 总体流程 获取Token 创建应用 创建录制规则 配置录制回调 终端用户加入房间 创建合流录制任务 操作步骤 获取用户Token，用于调用SparkRTC接口时进行认证鉴权。
常见问题 初始化引擎时，countryCode应该如何填写？ countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对照表。 初始化引擎时，domain应该如何填写？ 该字段已废弃，不需要再传值。
这是正常现象，SDK会定时回调onPlaybackAudioFrame，里面是空白语音包。 自渲染没有图像 onVideoFrameRender回调函数实现中，y、u、v分量需要按如下方式获取： virtual bool onVideoFrameRender(const char* userId
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到其他用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。
加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。 切换成功触发onUserRoleChangedNotify回调。切换失败会触发onError回调，返回HRT
SparkRTC UserID是什么？取值范围是多少？ UserID是实时音视频服务用来区分应用中用户的唯一标识。 用户标识是用户在实时音视频服务中的一个表示，开发者按照规范自定义UserID。 命名规则：可自定义，支持64个字节的大小写字母、数字、下划线（_）中划线（-）随机组合。
更新自动录制配置 功能介绍 更新自动录制配置，租户可以开启自动单流录制或者停用自动单流录制（仅支持单流录制）。 接口约束 开启自动单流录制功能之后，只针对新创建的房间有效，对开启自动录制功能之前已经创建的房间不生效。 单流自动录制任务的流名规则： {appid}_{roomid}
本端离开房间。具体接口详情请参见leave。 1 client.leave() 当音视频通话结束时，调用此接口离开房间。 至此，音视频通话基本流程可以成功运行。 父主题： Web SDK
云资源授权 您可以将OBS桶授权给SparkRTC服务，允许录制文件存储在OBS桶中。 注意事项 授权的OBS桶所在区域必须为华北-北京四。 前提条件 因录制生成的视频文件是存储在OBS服务中的，因此，您需要先开通OBS服务，具体请参见OBS快速入门。 已在OBS服务中创建用于存
SparkRTC RoomID是什么？取值区间值是多少？ RoomID是房间ID，房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。 SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离； 只有在同一个房间里的用户才可以相互接收音视频； 房间ID的
常用概念 应用标识 应用标识或应用ID，简称appID，是SparkRTC用来区分不同应用的唯一标识，在SparkRTC控制台中创建应用时自动生成。 房间 房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。 SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离。
SDK使用 创建引擎。 AppId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 HRTCEngineConfig config = new HRTCEngineConfig(); config.setAppId(appId); // AppId需在控制台中创建应用后获取
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RTC.00001001 OperationUnauthorized: get DomainID fail please check X-Auth-Token
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
