视频客服
视频客服用于在网页或应用内与客服进行实时音视频沟通，适合需要远程演示、身份确认、产品指导或面对面服务的场景。
功能概览
当前微语视频客服页面已支持以下能力：
- 支持访客手动发起视频呼叫，也支持在嵌入式页面中自动拉起视频客服。
- 发起前自动检测麦克风、摄像头和扬声器状态，未通过检测时会提示原因。
- 支持来电接听、拒绝、呼出取消和通话中挂断。
- 接通后同时展示本地预览画面和远端视频画面。
- 支持静音、开启/关闭本地视频，以及在多摄像头设备上切换前后摄像头。
- 支持双向视频和单向视频模式，单向模式下访客端会收到明确提示。
- 在 iframe 嵌入 场景下，支持最小化、放大、关闭窗口，以及来电提示音开关。
- 当客服不在线时，页面会自动切换到离线留言面板，支持录制语音留言，并可配合文字留言表单一起提交。
使用前准备
- 访客设备已连接稳定网络。
- 浏览器或 App 已授予摄像头、麦克风权限。
- 当前设备具备可用的扬声器输出。
- 客服已登录工作台并处于可接待状态。
如果客服暂时不在线，视频客服页面会自动切换为离线留言模式，访客仍可留下语音或文字信息。
访客端：发起视频会话
- 在会话页面点击视频通话入口。
- 页面会先检测麦克风、摄像头和扬声器状态。
- 首次使用时，按提示允许浏览器访问摄像头和麦克风。
- 设备通过检测后，系统向客服发起视频呼叫。
- 等待客服接听期间，访客可随时取消本次呼叫。
自动拉起视频客服
如果业务系统将微语视频客服页面作为独立浮窗或 iframe 接入，可以在打开页面时直接指定视频呼叫意图。页面会在完成访客、会话和设备准备后自动发起视频客服。
这种方式常用于：
- 在商品页、工单页、设备支持页中一键进入视频客服。
- 在 App 或 H5 中缩短访客从点击到通话的路径。
- 在嵌入式客服条、侧边栏或弹层中快速拉起可视化服务。
客服端：接收并接听请求
- 客服工作台收到视频会话请求提醒。
- 点击接听后建立实时音视频连接。
- 如暂时无法处理，可直接拒绝；访客端会同步收到状态反馈。
- 若访客主动取消或一方挂断，双方页面都会结束本次视频会话。
客服离线时：语音留言与文字留言
如果当前客服线程已经变为离线状态，视频客服页面会自动退出正常通话流程，改为展示离线留言面板。
在该面板中，访客可以：
- 点击“开始语音留言”后进行录音，录音前系统会先播放一声短提示音。
- 结束录音后，页面会自动上传语音文件，并显示可试听的回放控件。
- 录音上传成功后，点击“提交语音留言”即可完成离线语音留言。
- 点击“文字留言”按钮可打开表单，补充标题、留言内 容和联系方式。
- 如果已经上传了语音，再提交文字留言时，系统会自动把该语音一起附带提交。
这意味着即使视频客服没有接通，访客也依然可以把问题、联系方式和语音描述完整留给客服，等待后续回访。
通话中：访客端界面说明
视频客服接通后，访客端会展示完整的视频通话界面，包含以下能力：
- 远端画面区域：用于显示客服视频画面。
- 本地预览窗口：用于显示访客自己的摄像头画面。
- 静音/取消静音：控制本地麦克风状态。
- 开启/关闭视频：临时关闭或恢复本地摄像头。
- 切换摄像头：在检测到多个摄像头时，支持切换前置或后置摄像头，尤其适合手机端。
- 挂断：主动结束当前视频会话。
- 通话状态提示：页面会根据阶段显示“收到视频来电”“正在等待对方接听视频”“视频通话中”等状态。
通话中：客服端界面说明
客服可在工作台持续视频沟通，并同步查看会话信息，提升处理效率。
嵌入式窗口能力
当音频客服页面以内嵌窗口方式打开时，顶部工具栏还支持以下操作：
- 开启或关闭来电/呼叫提示音。
- 最小化当前通话窗口。
- 放大当前通话窗口。
- 关闭窗口并回收当前会话。
结束通话
任意一方点击结束后，音频会话立即结束，双方返回普通会话状态。
视频模式说明
双向视频
默认场景下，双方都可发送和接收视频流。访客可看到客服画面，同时保留自己的本地预览窗口。
单向视频
在单向视频模式下，访客端不会显示客服画面，页面会明确提示“当前为单向视频”。这类模式适合只上传访客视频、由客服查看现场画面的业务场景。
嵌入式窗口能力
当视频客服页面以内嵌窗口方式打开时，顶部工具栏还支持以下操作：
- 开启或关闭来电/呼叫提示音。
- 最小化当前窗口。
- 放大当前窗口。
- 关闭窗口并同步结束当前通话。
常见问题
客服不在线时还能继续发起视频通话吗？
当前页面会优先切换到离线留言模式。此时无法继续建立实时视频通话，但可以提交语音留言和文字留言，等待客服后续联系。
无法发起视频客服怎么办？
- 检查摄像头、麦克风和扬声器是否都已连接并通过检测。
- 检查浏览 器站点权限是否允许访问摄像头和麦克风。
- 如页面仍在执行初始化或自动呼叫流程，请稍候后再试。
为什么没有“切换摄像头”按钮？
- 当前设备只检测到一个摄像头。
- 当前本地视频未开启。
- 浏览器或设备未返回可切换的视频输入列表。
为什么看不到客服画面？
- 当前可能处于单向视频模式，页面会显示对应提示。
- 对方尚未接通或远端视频流还未建立完成。
- 建议检查网络状态后重新发起通话。
为什么离线留言里没有成功录到语音？
- 浏览器未获取麦克风权限。
- 当前浏览器不支持录音或音频编码能力不足。
- 录音后上传失败，建议检查网络并重新录制。