本软件是一款专为 Windows 平台打造的 SIP 软终端，符合 SIP 规范。

主要特点：

• 免安装版本，轻量高效，即开即用
• 友好的用户界面，简洁直观
• 支持语音通话
• 支持多账号管理
• 可接入 XSwitch 平台实现音频会议

在 Xswitch 官网平台 上下载最新版本。

本软件为免安装版本，下载后解压即可使用。双击 CherryCall.exe 启动程序。

主界面包含以下元素：

• 双击 CherryCall.exe 启动程序
• 程序启动后，由于应用是绿色免安装版且没有签名信息，会弹出安全警告，当弹出提示时，不用担心，直接点击“更多信息”，再选择“仍要运行”即可。

• 添加账号：点击 "⚙" 按钮，弹出设置窗口

  参考示例常见问题增加 sip 账号信息

• 查看账号状态：主界面左上角显示当前账号状态

  • ● 在线：账号注册成功
  • ● 连接中：正在注册
  • ● 不可用：注册失败或未连接

• 切换账号：点击账号下拉框，选择要使用的账号

  • 切换后，呼叫将使用新账号发起
  • 每个账号独立管理通话

基本操作：

1. 在号码输入框中输入对方号码
2. 点击「📞 呼叫」按钮发起呼叫
3. 系统自动在号码后补全域名（使用当前账号的域名）

URI 直接拨打： 如果输入中包含 @（如 8008@192.168.1.100），系统直接使用该地址，不进行补全。

呼叫按钮状态：

• 无账号或账号未连接时：按钮禁用
• 有活跃通话时：按钮禁用（防止重复呼叫）

发起呼叫后，会弹出通话窗口，显示：

• 通话状态（来电中/正在呼叫/已接通）
• 通话号码

通话控制按钮：

• 挂断：结束当前通话
• 静音：切换静音状态（来电窗口）
• 保持：将来电保持（来电窗口）
• 接听：接听来电（来电窗口）

当有来电时，会自动弹出来电窗口，显示来电号码。

• 点击「接听」：接听来电
• 点击「挂断」：拒接来电

挂断电话后，在主界面会显示历史记录信息：包含呼叫方向（呼入/呼出）、时间、及对方的账号信息；

其中方向图标含义如下：

○ ： 表示应用启动时间
← ： 表示呼出
→ ： 表示呼入/接听

历史记录中选中某行数据，右键可复制对方号码信息、呼叫、删除当前记录等功能。

• 如果存在活跃通话，无法关闭主窗口
• 需先挂断所有通话后才能关闭主程序

点击设置按钮可打开设置窗口，设置窗口中包含如下功能：

• 语言切换：支持中文、English、Auto（跟随系统）三种语言模式，切换后即时生效

1. 点击「⚙」按钮，打开设置窗口
2. 在「通用」页签中，找到「语言」下拉框
3. 可选择三种语言模式：
   • Auto（自动）：自动跟随操作系统语言
   • English：英文界面
   • Chinese：中文界面
4. 选择后，界面语言立即生效，无需重启应用
5. 语言设置会自动保存，下次启动时保持

• 账号页签可以添加、删除和管理多个 sip 账号

• 开发中

• 开发中

• 打开配置目录：在文件管理器中打开配置文件所在目录
• 打开日志目录：在文件管理器中打开日志文件所在目录

关于界面显示应用信息，包括简介，版本号，版权信息等。

• 调试模式：在关于面板中双击版本号，可切换调试模式
  • 开启后版本号显示 (调试模式) 后缀
  • 调试模式开启后，程序会记录详细的运行日志到文件

CherryCall 内置 WebRTC 回声消除（AEC） 模块，可自动消除扬声器声音被麦克风回采产生的回声，提升双向通话质量。

• 参考信号：接收到的远端音频会同步送入 AEC 作为回声参考
• 回声消除：麦克风采集的音频在发送前，AEC 会将其中与扬声器播放内容相似的部分（回声）滤除
• 处理参数：单声道，10ms 处理块，20ms 声卡缓冲延迟

在 .baresip\config 中可配置：

module                webrtc_aec.dll

程序运行过程中会记录详细的运行日志，用于问题排查和调试。

CherryCall 内置两层日志系统：

baresip 引擎日志分为以下级别：

• 文件命名：cherry-call-YYYYMMDD.log（按日期自动滚动）
• 自动清理：程序启动时自动删除 7 天前 的旧日志文件

在「设置 > 高级」中点击「打开日志目录」可直接打开日志文件夹。

默认情况下，程序不会将日志写入文件。如需启用文件日志，有以下方式：

关于面板切换：在「设置 > 关于」面板中双击版本号，即可开启/关闭调试模式

• 开启后版本号显示为 V0.0.x (调试模式)
• 重启后状态保持

注意：调试模式开启后会增加一定的性能开销，正常使用建议关闭。

Q：如何添加账号？

A: 账号添加针对不同的版本有不同的配置方式，请参照您的版本进行配置。

版本号查看方法：在文件 cherrycall.exe 上右键，选择"属性" -> "详细信息"，查看"产品版本"信息。

v0.0.3 及以上版本：

如果你之前使用过 v0.0.1 及 v0.0.2 版本，请先删除配置目录下的 config 文件，然后按照以下方式进行配置：

打开设置界面，选择账号页签，点击「新增」按钮，输入账号信息，点击「保存」按钮即可。这里的账号信息指的是 sip 账号信息，具体字段配置示例参照 V0.0.1 版本中的示例。

V0.0.1 版本、V0.0.2 版本：

请在设置界面打开配置目录，在 accounts 文件末尾增加账号信息，参考示例如下。注意账号编辑完成后，需要重启应用才会生效。

以 demo.xswitch.cn 为例，账号信息如下：

用户名: 1001
密码: Hkdq@246
SIP 服务器: 101.42.177.243:10160
SIP 代理: 101.42.177.243:10160
域: demo.xswitch.cn

那么需要在 accounts 文件中最后一行添加如下内容：

<sip:1001@demo.xswitch.cn>;auth_user="1001";auth_pass="Hkdq@246";outbound="sip:101.42.177.243:10160;transport=tcp"

Q: 呼叫按钮不可用？

A: 请检查账号是否已成功注册（状态应为 ● 在线）。切换到已注册的账号后即可使用。

Q: 呼叫失败？

A: 请检查：

1. 对方号码是否正确
2. 网络连接是否正常
3. SIP 服务器是否可达
4. 查看日志文件了解详细错误信息

Q: 无法关闭程序？

A: 程序检测到存在活跃通话时不允许关闭。请先挂断所有通话后再尝试关闭。

Q: 如何切换界面语言？

A: 在「设置 > 通用」中找到「语言」下拉框，选择 中文、English 或 Auto（跟随系统语言）即可，切换后立即生效。

Q: 如何开启调试日志？

A: 在「设置 > 关于」面板中双击版本号，版本号显示 (调试模式) 即表示已开启。开启后程序会将运行日志写入日志目录。再次双击版本号可关闭调试模式。