此用例描述了使用API与Web应用程序的登录用户启动屏幕共享调用的示例步骤。
在用户已登录的页面上,使用您的应用程序中可用的用户数据将调用添加到标记方法。 这会将用户信息添加到现有的浏览器会话中。
CV.user.tag({ "email": "[email protected]", "firstname": "John", "lastname": "Doe", "labels": [] })
在应用程序内创建一个UI元素,该UI元素仅对支持代理或具有特殊权限的其他用户可用,这些用户应能够与该应用程序的用户启动屏幕共享调用。
需要根据Chatvisor API进行身份验证才能获取有关活动用户的信息。 这是通过在请求信息之前向CV.rest.auth方法提供用户令牌来完成的。
CV.rest.auth("[email protected]", "my-user-token")
可以使用 REST API 获取用户令牌
在屏幕共享页面上,添加UI以选择要进行屏幕共享的用户。 您可以选择以下选项之一:
在此页面上,请请求活动用户列表,并在应用程序的用户界面内显示该列表,例如 如表:
活跃用户
E-Mail[email protected]Start[email protected]Start
CV.user.list(result => { result.forEach(user => addTableRow(user)) })
如果您的应用程序内部已有一个现有用户(例如用户个人资料),则您可能希望获取有关单个用户的浏览器会话的信息。
John Doe
屏幕共享:开始
然后使用JavaScript API使用给定的信息搜索用户。
CV.user.status("[email protected]", status => { if(status.visitorId) { startButton.show(); } })
结果对象包含创建标记时提供的信息以及访问者ID。 可以使用此访客ID来使用呼叫API启动屏幕共享会话。
function onClickStart(result) { var visitorId = result["visitorId"]; CV.calling.startScreen(visitorId); }
成功标记用户后(登录后并有选择地分配给座席),如果在标记功能中设置了id属性,则可以在没有ID的情况下开始会议。
CV.conference.start();