此用例描述了使用API与Web应用程序的登录用户启动屏幕共享调用的示例步骤。

1. 将标记代码添加到应用程序

在用户已登录的页面上,使用您的应用程序中可用的用户数据将调用添加到标记方法。 这会将用户信息添加到现有的浏览器会话中。

CV.user.tag({
    "email": "[email protected]",
    "firstname": "John",
    "lastname": "Doe",
    "labels": []
})

2. 创建用于屏幕共享的页面

在应用程序内创建一个UI元素,该UI元素仅对支持代理或具有特殊权限的其他用户可用,这些用户应能够与该应用程序的用户启动屏幕共享调用。

需要根据Chatvisor API进行身份验证才能获取有关活动用户的信息。 这是通过在请求信息之前向CV.rest.auth方法提供用户令牌来完成的。

CV.rest.auth("[email protected]", "my-user-token")

可以使用 REST API 获取用户令牌

3. 选择要进行屏幕共享的用户

在屏幕共享页面上,添加UI以选择要进行屏幕共享的用户。 您可以选择以下选项之一:

选项 A: 用户名单

在此页面上,请请求活动用户列表,并在应用程序的用户界面内显示该列表,例如 如表:

活跃用户

E-Mail[email protected]Start[email protected]Start

CV.user.list(result => {
  result.forEach(user => addTableRow(user))
})

选项 B: 现有的用户个人资料

如果您的应用程序内部已有一个现有用户(例如用户个人资料),则您可能希望获取有关单个用户的浏览器会话的信息。

John Doe

屏幕共享:开始

然后使用JavaScript API使用给定的信息搜索用户。

CV.user.status("[email protected]", status => {
  if(status.visitorId) {
    startButton.show();
  }
})

4. 开始屏幕共享

结果对象包含创建标记时提供的信息以及访问者ID。 可以使用此访客ID来使用呼叫API启动屏幕共享会话。

function onClickStart(result) {
  var visitorId = result["visitorId"];
  CV.calling.startScreen(visitorId);
}

5. 开始会议

成功标记用户后(登录后并有选择地分配给座席),如果在标记功能中设置了id属性,则可以在没有ID的情况下开始会议。

CV.conference.start();