检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SparkRTC的入门操作流程说明如表1所示。 表1 入门流程说明 序号 操作方法 操作说明 1 获取App ID和域名 在SparkRTC控制台中创建应用后获取App ID和域名。 2 获取SparkRTC SDK 目前产品已转维，不再对外开放提供SDK开发包，如有疑问，请提交工单处理。
第二十次正式发布 本次变更如下： 新增OBS桶管理接口组。 新增查询详情事件接口和查询指定项目用户异常体验事件接口。 2023-07-06 第十九次正式发布 本次变更如下： 删除启动单流任务、更新单流任务和启动合流任务接口中的“publish_param”参数。 2023-05-24
2。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。 图1 导入HWRTCEngine动态库和RTC.bundle文件 在“General”页面将SDK中HWRTCEngine.fram
//认证用的app_key和app_id硬编码至代码中或以明文形式存储会有极大风险。建议密文形式配置存储在文件或者环境变量中，使用时解密，以确保安全。本例以app_key和app_id存放至环境变量为例，运行前请先在本地环境中设置完成环境变量APP_KEY和APP_ID。 app_key
背景音乐是否支持循环播放？ SparkRTC是否支持调整背景音乐的播放进度？ 支持监听房间成员进出房间吗？ 如何监测断网和重连？ 支持首帧渲染回调吗？能否监听画面开始渲染？ 如何设置上行视频码率、分辨率和帧率？ 有没有推荐的画面质量（码率、分辨率、帧率）相关参数配置？ 如何实现横屏视频通话？ 是否支持网络测速？如何操作？
2。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。 图1 导入HWRTCEngine动态库和RTC.bundle文件 在“General”页面将SDK中HWRTCEngine.fram
HWRtcEngine 接口总览 初始化等基础接口 房间功能 音频管理 视频管理 辅流管理 屏幕共享 音效文件播放管理 检测功能 自定义音频采集和渲染 自定义视频采集和渲染 设备管理 父主题： 接口参考
接口总览 初始化等基础接口 房间功能 音频管理 视频管理 屏幕共享 辅流管理 音效文件播放管理 音频增强管理 检测功能 自定义音频采集和渲染 自定义视频采集和渲染 设备管理 父主题： 接口参考
第十一次正式发布 本次发布版本为1.8.0版本，整合了之前若干版本和分支的一个全新版本，主要变更内容为跨房功能重构，结合服务端升级，可以支持2W人超大型会议和最多同时跨5个房间互动等场景。此外，管控面和用户体验上也新增了部分功能和优化。 本次变更如下： 新增的接口及回调： changeU
14.2和macOS Safari 14.0.1上音频可能断断续续。 Safari 15.1发布流时会发生异常，导致页面崩溃。 Safari不支持获取输出设备信息，因此，不支持getSpeakers和setAudioOutput接口。 Safari不支持调用addTrack和removeTrack接口。
通过“audioSource”和“videoSource”设置音频和视频主流。这种模式下不支持大小流。 通过“audio/microphoneId”和“video/cameraId/facingMode”设置音频和视频主流。 如果未指定任何的音频源和视频源，则创建的流对象不包含音频流和视频流，无法播放。
一个直播间最多支持500人同时通话。 Android SDK 系统版本：支持Android 5.0及以上版本。 终端架构：armeabi-v7和arm64-v8a。 iOS SDK 系统版本：支持iOS 8.0及以上版本。 终端CPU架构：arm64，arm32。 MAC SDK 系统版本：支持macOS
本次发布版本为1.10.0版本，整合了之前若干版本和分支的一个全新版本。 本次变更如下： 新增joinRoom、adjustPlaybackVolume接口。 2021-06-10 第十一次正式发布 本次发布版本为1.8.0版本，整合了之前若干版本和分支的一个全新版本。 本次变更如下： 新增的接口及回调：
inRoom方法等接口，可以实现同时加入到多个房间，完成订阅和选看多个连接房间中的用户等功能。具体请参见IHRTCConnection和事件回调（IHRTCConnectionEventHandler）目录下的有关接口和回调。 【请求参数】 roomId：房间ID。 eventH
源支持最多同时编码和收发四挡数据类型（720P/360P/180P/90P）。 辅流 也称共享流，指共享屏幕或窗口的视频流。默认1080P，开启辅流流畅优先指切换为720P。 混流 是指将发布的多路音视频流混合转码成一个单流。 大小流模式 也称新模式，指编码和收发两路视频流的模式
连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个房间中，可以分别订阅和选看房间中的用户。 具体请参见事件回调（HWRtcConnection）有关接口和回调。 【请求参数】 roomid：房间ID。 【返回参数】 HWRtcConnection：成功返回连接对象指针，失败返回为空。
同一端大小流或多流模式多路流设置的分辨率需保持一致，否则会设置失败。 多终端发流和选看的分辨率不一致时，sdk默认自适应并匹配最接近的分辨率（以实际发流分辨率优先），可能会导致选看时设置的分辨率和实际收到的流分辨率不一致。 调用接口一设置编码参数的分辨率发生变化时，需要先ena
60P），一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数，请参考华为SDK系统推荐码表：表7 不同分辨率的码率和帧率配置推荐和不同场景下帧率和码率的推荐值，否则可能设置失败。 两重构接口针对不同使用方式并不通用，如果您使用的新选看系列接口setupRemoteVie
joinRoom:joinParam ]; joinParam：入会参数，包含用户ID、用户名、房间号、认证信息、ctime、是否自动订阅音频和视频、SFU类型、场景和用户角色，具体请参见HWRtcJoinParam。 监听远端用户加入房间，并设置远端窗口。 1 2 3 4 5 6
修订记录 发布日期 修订说明 2023-11-30 实时音视频所有客户端类型均增加“环境准备”章节。 2022-09-30 更新“单流录制”和“合流录制”章节的操作内容。 2021-10-30 第一次正式发布。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
