HowTo文档
如何在 XSwitch 中使用视频会议？
本文介绍 XSwitch 视频会议中最常用的操作，让您快速上手。
快速开始
- 用 Chrome 或 Edge 浏览器打开 XSwitch 的 xTalk-Web 页面（需 HTTPS）。
- 输入默认会议室号码
3000。 - 点击【视频呼叫】，浏览器会请求摄像头和麦克风权限，点击“允许”。
- 成功进入会议，您会看到自己的视频画面。
- 可以打开另一个浏览器标签页，同样呼入
3000，体验多人视频效果。
视频相关的基本操作
开关自己的摄像头
进入会议后，画面下方有摄像头图标，点击即可关闭/开启自己的视频。
关闭后别人看不到您的画面，但音频依然可以传输。
屏幕共享
点击【共享屏幕】按钮，选择要共享的窗口或整个桌面，点击“共享”。
其他人会立即看到您共享的内容（适用于演示 PPT、文档或软件操作）。
调整视频布局（主持人操作）
在会议控制界面，点击布局选项。
可选：2x2、3x3 宫格，或“演讲者视图”（当前说话的人画面放大）。
最大支持 10×10 宫格，同屏显示 100 路视频。
关闭他人视频（管理员）
在参会者列表中，找到某人，点击摄像头图标可强制关闭其视频画面。
SIP 视频话机入会
- 在 XSwitch 中为话机注册一个分机（如
1001）。 - 话机上直接拨打会议室号码，如
3000。 - 通话建立后，话机会自动发送视频流，对方可以看到您的画面（需确认话机摄像头已开启）。
临时召开视频会议
在 Web 界面右下角点击电话图标 → 立即会议，系统生成一个临时会议号。
将会议号发给其他人，他们用网页或话机呼入即可。
常见视频问题处理
| 现象 | 解决方法 |
|---|---|
| 网页看不到自己画面 | 检查浏览器地址栏左侧的摄像头权限是否已允许；刷新页面重新授权 |
| 别人看不到我的画面 | 确认会议中自己没有关闭摄像头图标；SIP 话机需按下摄像头按键 |
| 画面卡顿 | 降低视频分辨率（在模板或会议室配置中设置为 720p 或 480p）；检查网络上行带宽 |
| 只有语音没有视频 | 确保您使用的是【视频呼叫】而非语音呼叫；会议模式建议为“融屏” |
高级功能
如何呼入会议后自动呼叫其他用户入会？
如果已经设置了呼叫路由，目的地为“会议”，那么在“目的地控制”→“动作”中，添加如下变量信息即可，根据需求不同，设置不同变量即可。如：
<!-- 自动呼叫 1000 和 1001 时显示的主叫号码、超时时长 --> <action application="set" data="conference_auto_outcall_caller_id_name=${caller_id_name}"/> <action application="set" data="conference_auto_outcall_caller_id_number=${caller_id_number}"/> <!-- 自动呼叫 1000 和 1001 时呼叫超时时间，单位秒 --> <action application="set" data="conference_auto_outcall_timeout=60"/> <!-- 自动呼叫 1000 和 1001 时呼叫时会议模版 --> <action application="set" data="conference_auto_outcall_profile=default"/> <!-- 当呼叫会议时自动呼叫 1000 和 1001成员加入会议 --> <action application="conference_set_auto_outcall" data="user/1000"/> <action application="conference_set_auto_outcall" data="user/1001"/> <!-- 当有成员加入会议时播放的音频消息文件 --> <action application="set" data="conference_auto_outcall_announce=sounds/soundfile.wav"/> <!-- 当有成员加入会议时 flag 设置 --> <action application="set" data="conference_auto_outcall_flags=mute"/> <!-- 在会议接通时执行的动作 --> <action application="set" data="conference_auto_outcall_prefix={sip_auto_answer=true,execute_on_answer='bind_meta_app 2 a s transfer::intercept:${uuid} inline'}"/>
小结
- 网页端：xTalk-Web → 输入会议室号 → 点【视频呼叫】即可。
- SIP 话机：注册分机后直接拨会议室号。
- 控制视频：摄像头图标开关、屏幕共享、布局调整。
- 管理员权限：可关闭任意参会者的视频。