通话信息
在 CallLib SDK 中,RCCallSession 用于表示一个通话实例。无论是主叫方还是被叫方,通话过程中都持有一个 RCCallSession
实例。
- 主叫方:在成功调用通话发起接口(如
call
或callInGroup
)后,会获得一个 RCCallSession 实例 - 被叫方:在初始化 CallLib 客户端时,通过
onSession
回调获取来电对应的 RCCallSession 实例
获取通话 ID(加入的房间 ID)
调用 getSessionId 方法,获取当前通话 ID。
提示
getSessionId
方法返回的是房间 ID,并不是当前通话的唯一标识getRTCSessionId
方法返回的才是通话唯一标识
接口
JavaScript
session.getSessionId()
参数说明
无
示例代码
typescript
/**
* 返回 string 类型
*/
session.getSessionId()
获取人员状态
调用 getUserState 方法,获取人员状态。
接口
JavaScript
session.getUserState(userId)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
userId | string | 是 | 用户 ID |
示例代码
typescript
/**
* 返回 RCCallUserState 枚举值:0 表示用户不存在于通话中,1 表示等待接听,2 表示通话中
* @param {string} userId
*/
session.getUserState(userId)
获取 session 的状态
调用 getState 方法,获取 session 的状态。
接口
JavaScript
session.getState()
参数说明
无
示例代码
typescript
/**
* 返回枚举值,表示 session 的当前状态:0 等待建立连接,1 会话维持中,2 会话已结束
*/
session.getState()
获取当前通话唯一标识
调用 getRTCSessionId 方法,获取当前通话唯一标识。
接口
JavaScript
session.getRTCSessionId()
参数说明
无
示例代码
typescript
/**
* 返回 string 类型
*/
session.getRTCSessionId()
获取目标 ID
调用 getTargetId 方法,获取当前通话目标 ID。
- 单呼:为对方人员 ID
- 群呼:为群组 ID
接口
JavaScript
session.getTargetId()
参数说明
无
示例代码
typescript
/**
* 返回 string 类型
*/
session.getTargetId()
获取会话类型
调用 getConversationType 方法,获取当前通话会话类型。
接口
JavaScript
session.getConversationType()
参数说明
无
示例代码
typescript
/**
* 返回 number 类型:1 表示单聊,3 表示群组
*/
session.getConversationType()
获取组织 ID
调用 getChannelId 方法,获取当前通话会话的频道 ID。