检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
ID相同的应用程序才能进入同一个房间进行互动。应用的appId请参考应用管理进行获取。 domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 countryCode: 可选，string[2]类型，需要满足ISO
同一个页面中，可以创建N个RTC对象，通过N个UserID，分别登录到N个房间吗？ 可以。 父主题： SDK使用
= 0) 【功能说明】 通过此接口可以创建一个与房间关联的IHRTCConnection连接对象，可多次调用以创建多个IHRTCConnection连接对象。调用每个连接对象中的joinRoom方法等接口，可以实现同时加入到多个房间，完成订阅和选看多个连接房间中的用户等功能。具体
语音通话、视频通话、语聊房、FM电台、K歌房、人声检测等。 跨房连麦 支持主播跨房间连麦互动，观众可自由通过角色切换进行上下麦。 在线教育-子母课、连麦PK。 互动连麦 支持连麦互动，观众可自由通过角色切换进行上下麦，切换过程平滑。 在线教育-小班课、互动直播 云端录制 提供云端录制功能，支
0：方法调用失败。具体请参见HRTCErrorCode。 加入房间前，可以通过joinRoom的userRole参数确认角色信息。 加入指定房间后才可以在指定房间内进行角色切换，当前仅支持joiner和player角色切换。跨房场景下，通过对应connection连接下的changeUserRole接口实现在跨入房间中的角色类型切换。
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token 使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String
述的两个接口及其对应的回调在1.8.0版本中予以废弃。新的跨房通过创建HRTCConnection与对应房间先建立连接，然后通过调用该对象的joinRoom和leaveRoom接口实现跨房和退房功能，对应回调处理通过事件回调(IHRTCConnectionEventHandler
Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 终端节点 终端节点即调用API的请求地址，SparkRTC部署时不区分物理区域，为全局服务。因此，SparkRTC的终端节点如表1所示。 表1 SparkRTC的终端节点 区域名称 区域 终端节点（Endpoint）
herRoom、onDisconnectOtherRoom：新跨房通过与对应房间先建立连接HWRtcConnection，再通过连接调用其下的joinRoom和leaveRoom接口实现跨房和退房功能，回调亦通过HWRtcConnection下属回调OnJoinRoomSucce
TC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。 加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。
userId：必填，string[64]类型，用户标识，userId需要保证应用内唯一。userId支持的字符包括：a-z、A-Z、0-9、连接符 '-'、下划线 '_'。 userName：选填，string[128]类型，用户昵称。 microphoneId跟cameraId在哪获取？为什么是必填的？
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String
【功能说明】 根据房间ID，创建HRTCConnection对象，为跨房做准备。 通过此接口创建一个与房间关联的HRTCConnection连接对象。 该方法支持多次调用，创建多个HRTCConnection连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个房间中，可以分别订阅和选看房间中的用户。
表33 网络连接状态 枚举值 描述 HRTC_CONN_DISCONNECTED 连接断开。 HRTC_CONN_CONNECTING 建立网络连接中。 HRTC_CONN_CONNECTED 网络连接成功。 HRTC_CONN_RECONNECTING 重新建立网络连接中。 HRTC_CONN_FAILED
【返回参数】 HWRtcConnection：成功返回连接对象指针，失败返回为空。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。 如果使用HWRtcConnection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。 同一时间只能以JOINER角色加入某一个房间。
0：成功。 1：失败。 2：上下文为空。 【注意事项】 该方法将会触发以下回调： onConnectionStateChangedNotify：连接状态发送改变。 onJoinRoomSuccess：加入房间成功时回调。 onJoinRoomFailure: 加入房间失败时回调。 on
description) 【功能说明】 连接状态改变回调。 【回调参数】 conn：连接对象。 state：连接状态类型，具体请参见HRTCConnStateTypes。 reason：连接状态改变原因，具体请参见HRTCConnChangeReason。 description：连接状态改变描述。 o
String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 否 String 域名 app_id 是 String 应用id room_id 是 String 房间ID user_id 否 String 发送端用户 peer_id
IHRTCConnectionVideoFrameObserver* observer) 【功能说明】 注册原始视频媒体数据监听回调。 【请求参数】 conn：连接对象。 IHRTCVideoFrameObserver* observer：原始视频数据处理接口代理。具体请参见IHRTCVideoFrameObserver。
char* userId, HRTCVideoFrame& videoFrame) 【功能说明】 原始视频数据处理后回调 【回调参数】 conn：连接对象 userid：用户ID videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。 【返回参数】 true：处理结果成功。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
