实时音视频 SparkRTC-房间功能:createConnection

时间：2025-02-12 14:55:01

实时音视频 SparkRTC IHRTCEngine

createConnection

virtual IHRTCConnection* createConnection(const char* roomId, IHRTCConnectionEventHandler* eventHandler) = 0)

【功能说明】

通过此接口可以创建一个与房间关联的IHRTCConnection连接对象，可多次调用以创建多个IHRTCConnection连接对象。调用每个连接对象中的joinRoom方法等接口，可以实现同时加入到多个房间，完成订阅和选看多个连接房间中的用户等功能。具体请参见IHRTCConnection和事件回调（IHRTCConnectionEventHandler）目录下的有关接口和回调。

【请求参数】

roomId：房间ID。
eventHandler：IHRTCConnectionEventHandler，引擎回调句柄，指定一个回调事件。SDK通过指定的事件通知应用程序的运行事件，如加入或离开房间等。具体请参见5.3.4-事件回调（IHRTCConnectionEventHandler）。

【返回参数】

IHRTCConnection：成功返回连接对象指针，失败返回内容为空。

同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。加上IHRTCEngine对象，即同时最多可加入5个房间，且在这5个房间中最多只能同时有一个joiner角色，其他只能为player角色。如果使用IHRTCEngine对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。

上一篇：实时音视频 SparkRTC-接口总览:辅流管理

下一篇：实时音视频 SparkRTC-修订记录