会中邀请

1. 配置邀请模式

setCustomInviteType

会议中邀请分三种模式:呼叫邀请模式、 自定义邀请UI模式、 自定义邀请数据模式
在会议主程序界面底部工具条上,“主持人/联席主持人”身份时,可以看到邀请按钮;
通过setCustomInviteType接口,可配置sdk使用哪种邀请模式。不配置的情况下,将使用:呼叫邀请模式;
如果想完全不显示邀请按钮,可使用自定义配置, 将邀请按钮隐藏;

2. 呼叫邀请模式

使用会议内置的呼叫邀请功能,用户在会议中点击邀请按钮,将从会议系统的企业架构选择被邀请人并发起邀请后,会议系统会对在线的被邀请人发起呼叫,被邀请方将收到SDK的回调通知。
因为只能对会议系统内的用户发起呼叫邀请,所以需要先把用户从业务系统同步到会议系统,详见后端WEB API用户管理接口。

在会议中呼叫邀请:
Image text

SDK将收到“邀请通知”:
Image text

接听后加入会议, 邀请方将显示对方已入会:
Image text

notifyCallIn

被邀请时将收到通知消息

// 呼入通知  callID —— 呼叫ID | caller —— 主叫人员ID | meetInfo —— 会议详细信息
meetingSDK.on("notifyCallIn", (callID: string, caller: string, meetInfo: string) => {
		//meetInfo格式:{"meetID":12345678, "pswd":"abcd"}
		//弹出被邀请提供界面;
});

acceptCall

收到被邀请消息时,可以接受邀请并进入会议

// 接受呼叫 callID:呼叫ID
meetingSDK.acceptCall(callID)

// 进入对应会议   meetID:会议号   meetPswd:会议密码
meetingSDK.joinMeeting(meetID, meetPswd);

declineCall

收到被邀请消息时,可以拒绝邀请

// 拒接呼叫 callID:呼叫ID
meetingSDK.declineCall(callID);

notifyCallInCanceled

收到被邀请消息时,但长时间不做出响应, 或邀请方撤消了邀请, 将收到“邀请被取消”通知:

// 取消呼叫  callID —— 呼叫ID
meetingSDK.on("notifyCallInCanceled", (callID: string) => {
	//销毁之前弹出的“收到邀请通知”界面;
});

3. 自定义邀请UI模式

通常是配合IM使用,用户在会议SDK界面中点击邀请按钮,会议SDK会通过notifyInvite回调业务系统;
业务系统可以高度定制邀请界面,并通过业务系统自已的信令通道或离线push通道完成邀请处理;
被邀请方在收到邀请消息后,调用sdk的joinMeeting或joinMeetingWithoutLogin加入被邀请会议即可;

notifyInvite

自定义邀请UI模式下,用户在会议SDK界面中点击"邀请按钮"时, 将通过notifyInvite回调业务层;

4. 自定义邀请数据模式

通常是配合IM使用,用户在会议SDK界面中点击邀请按钮,会议SDK会显示从业务系统查询得到的企业架构和用户;
邀请选择确认时,会议SDK回调业务系统选择内容,由业务系统自已的信令通道或离线push通道完成邀请处理;
被邀请方在收到邀请消息后,调用sdk加入会议即可;

会议中邀请选人界面:
Image text

业务收到邀请人员时,可向对应人发送一条会议通知:
Image text

notifyQueryOrgInfo

自定义邀请模式下, 会议程序进入“邀请界面”时, 将通过notifyQueryOrgInfo回调业务层请求获得“企业组织结构”数据;


// 请求自定义组织结构
meetingSDK.on("notifyQueryOrgInfo", () => {
	//应尽快将最新的数据送给SDK
	meetingSDK.setCustomOrgInfo(orgInfo)
});

setCustomOrgInfo

自定义邀请模式下,收到notifyQueryOrgInfo回调时,应尽快将最新的”企业组织结构“数据送给SDK

const orgInfo = {
    "contactData": [
        {
            "departId": 1,
            "userId": "100",
            "userName": "test"
        }
    ],
    "contactDepartsData": [
        {
            "departName": "测试部门",
            "id": 1,
            "pId": 0
        }
    ]
};
meetingSDK.setCustomOrgInfo(JSON.stringify(orgInfo));

notifyInviteUsers

自定义邀请模式下, 用户选择了邀请人员后, SDK将通过notifyInviteUsers通知选择人员:

// 通知邀请的人员信息[{"id":xxx}]  users —— 人员信息JSON字符串
meetingSDK.on("notifyInviteUsers", (users: string) => {
	// users格式:"[{"id":"xxx"}]"
});