HowTo文档
如何在 XSwitch 中开启视频通信？
访问地址与登录
后台管理地址
打开浏览器，访问 XSwitch 后台管理页面： https://demo.xswitch.cn
获取登录账号
用户名和密码可通过关注小樱桃科技微信公众号，在聊天区输入 demo 免费获取。
注意：演示环境会不定期重置，测试数据不会被保留，用户名和密码也可能定期更换。
内置 Web 电话的入口
登录后台后，点击左侧菜单 更多 → xTalk-Web，浏览器将打开内置的软电话面板。
补充说明：如果通过 HTTPS 访问后台，页面右下角也会自动出现一个 电话 快捷按钮，点击后可直接使用当前登录账号发起呼叫。
完成以上任一入口的访问后，即可用该内置 Web 电话拨打视频通话。
直接使用内置 Web 电话
XSwitch 后台自带的 xTalk-Web 就是一个基于 WebRTC 的软电话，无需额外安装任何软件。
发起视频呼叫
- 在 xTalk-Web 面板的“号码”输入框中，输入目标分机号（如另一个 SIP 软电话的号码）。
- 点击 〖视频呼叫〗 按钮，浏览器会请求摄像头和麦克风权限，请允许。
- 对方接听后，即可看到双方视频画面。
回声测试（快速检测设备）
在 xTalk-Web 中输入 9196 并拨打，接通后可看到自己的视频并听到回声，用于确认摄像头和麦克风均工作正常。
结合 SIP 软电话互通
如果想验证内置 Web 电话与 SIP 软电话之间的视频互通，可在另一台设备或电脑上安装标准 SIP 软电话（如 Linphone、MicroSIP），并按以下方式配置：
以 Linphone 为例，添加 SIP 账户时填写：
- 用户名：分机号码（如 1001）
- 密码：创建分机时设置的密码
- 域/服务器：XSwitch 服务器的 IP 地址
- 传输协议：UDP 或 TCP
- 服务器端口：10160（或 10180）
保存后若显示注册成功，即可在软电话与 xTalk-Web 之间互拨分机号进行视频通话验证。
常见问题排查
| 现象 | 原因与解决方法 |
|---|---|
| 无法访问后台 | 确认地址输入正确：https://demo.xswitch.cn；检查网络是否连通 |
| xTalk-Web 无法获取摄像头 | 浏览器是否已授权摄像头/麦克风；是否使用 HTTPS 访问后台 |
| 网页右下角没有“电话”按钮 | 通常表示未使用 HTTPS，或浏览器不支持 WebRTC |
| 视频无法显示 | 双方是否都支持 H.264 编码；RTP 端口范围 (16384-32768 UDP) 是否开放 |
| SIP 软电话注册失败 | 核对分机号、密码、服务器 IP 和端口 (10160)；检查防火墙是否放行 |
| 回声测试无画面/声音 | 检查系统摄像头/麦克风是否被其他应用占用，浏览器权限是否已授权 |
如需启用 SIP 日志深度排查：
- 进入 维护 → 终端
- 点击 日志指令 → SIP 日志 → 开
- 重现问题后，下载日志查看或提交技术支持