此用例描述了使用API与Web应用程序的登录用户启动屏幕共享调用的示例步骤。
1. 将标记代码添加到应用程序
在用户已登录的页面上,使用您的应用程序中可用的用户数据将调用添加到标记方法。 这会将用户信息添加到现有的浏览器会话中。
CV.user.tag({
"email": "john.doe@chatvisor.com",
"firstname": "John",
"lastname": "Doe",
"labels": []
})
2. 创建用于屏幕共享的页面
在应用程序内创建一个UI元素,该UI元素仅对支持代理或具有特殊权限的其他用户可用,这些用户应能够与该应用程序的用户启动屏幕共享调用。
需要根据Chatvisor API进行身份验证才能获取有关活动用户的信息。 这是通过在请求信息之前向CV.rest.auth方法提供用户令牌来完成的。
CV.rest.auth("an-agent@example.org", "my-user-token")
可以使用 REST API 获取用户令牌
3. 选择要进行屏幕共享的用户
在屏幕共享页面上,添加UI以选择要进行屏幕共享的用户。 您可以选择以下选项之一:
选项 A: 用户名单
在此页面上,请请求活动用户列表,并在应用程序的用户界面内显示该列表,例如 如表:
活跃用户
E-Mailjohn.doe@example.orgStartjane.doe@example.orgStart
CV.user.list(result => {
result.forEach(user => addTableRow(user))
})
选项 B: 现有的用户个人资料
如果您的应用程序内部已有一个现有用户(例如用户个人资料),则您可能希望获取有关单个用户的浏览器会话的信息。
John Doe
屏幕共享:开始
然后使用JavaScript API使用给定的信息搜索用户。
CV.user.status("john.doe@chatvisor.com", 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();