适用版本：main 分支已上架版本（1.0.0） 适用设备：HarmonyOS 手机

小樱桃电话（鸿蒙版）是一款面向 SIP 音视频通信场景的应用，提供 XSwitch 账号登录、SIP 分机管理、音频与视频通话、通话记录、联系人和黑名单管理等功能。

登录后，底部可切换以下三个页面：

• 拨号盘
• 通话记录
• 通讯录

在拨号盘和通讯录页面顶部，可打开个人侧边栏或进入设置。

使用前请确认：

1. 设备已连接可用网络。
2. 已准备好 XSwitch 账号，或已从管理员处获取 SIP 账号信息。
3. 需要语音通话时，请允许麦克风权限；需要视频通话时，请同时允许相机权限。
4. 建议在系统提示时开启通知，以便及时收到来电和未接来电提醒。

首次登录或以游客身份进入时，需阅读并同意《隐私政策》。未同意时，应用不会继续登录或进入游客模式。

1. 在登录页输入账号和密码。账号通常采用 分机号@域名 的形式，例如 1001@demo.xswitch.com,如果是正式环境xyt的账号，直接输入账号即可，如881
2. 点击“登录”。
3. 登录成功后，应用会获取并保存当前账号关联的 SIP 配置，并尝试恢复或注册可用分机。

如需使用非默认平台地址，点击“高级模式”，填写服务器地址后再登录。

点击“游客登录”可直接进入主界面。游客模式不包含平台账号关联的 SIP 配置；如需通话，请在“设置 > SIP账号”中手动新增并注册 SIP 账号。

点击顶部左侧头像或用户名打开侧边栏，可查看当前用户及号码，并点击“退出登录”。退出登录后会返回登录页。

非游客账号可在侧边栏点击头像上的“编辑”按钮设置本地头像；游客模式不支持自定义头像。

SIP 分机必须处于“已注册”状态，才能发起或接听正常通话。

进入路径：顶部设置 > SIP账号。

SIP 账号列表显示账号名称、账号号码和注册状态。拨号盘会显示当前选择的分机号；点击分机号可在已注册账号之间切换。

1. 在 SIP 账号页面点击右上角“新增”。
2. 按管理员提供的信息填写：账号名称、账号号码、账号密码、域、SIP 服务器和 SIP 端口号。
3. 点击“确定”保存。
4. 点击刚新增的账号进入详情页，再点击“重新注册”。

当状态显示为“已注册”时，该分机即可用于通话。

在 SIP 账号详情页可修改账号信息并点击“保存”，也可执行：

• 重新注册：用于首次注册或注册异常后的重试。
• 取消注册：停止当前分机注册。
• 删除账号：从本机移除该 SIP 账号。

修改服务器、域、号码或密码后，建议保存后重新注册，并确认状态变为“已注册”。

1. 在拨号盘输入目标号码。
2. 确认页面中显示的分机号正确；如有多个分机，可点击分机号切换。
3. 点击绿色电话按钮发起音频通话，或点击蓝色视频按钮发起视频通话。

号码为空时，呼叫按钮不会发起通话。若提示“SIP 账号未注册”，请前往 SIP 账号页面完成注册后再试。

在通讯录或通话记录中点击某项可进入详情页，选择“音频”或“视频”即可呼叫。详情页也可选择用于本次呼叫的已注册分机。

来电时，前台会显示来电界面；开启通知后，后台来电也会提供系统来电提醒。点击接听按钮接通，点击红色挂断按钮拒接或结束通话。

接听或发起视频通话时，如系统请求相机权限，请选择允许；未允许相机权限时，仍可使用音频通话。

接通后支持：

• 静音/取消静音
• 听筒与免提切换
• 打开“键盘”并发送 DTMF 按键，例如用于 IVR 菜单
• 挂断

视频通话除上述操作外，还支持：

• 打开或关闭本地视频
• 切换前后摄像头
• 点击画面切换大、小视频窗口

视频通话受网络、对端能力及相机权限影响。画面异常时，可先确认网络稳定、相机未被其他应用占用，并重新发起通话。

进入底部“通话记录”页，可查看当前分机的本地通话记录。

• “所有通话”：显示该分机的全部本地通话记录。
• “未接通话”：显示未成功接通的通话记录。

点击记录可查看号码、通话方向、时间、时长及该号码的历史记录，也可从详情页再次发起音频或视频通话。

通讯录包含云端联系人和系统联系人两类入口。

1. 进入底部“通讯录”。
2. 点击“新增云端联系人”。
3. 填写姓名、性别、公开范围和电话后点击“确定”。

新增操作需要当前平台账号具有联系人权限；如提示无权限，请联系管理员开通。

点击“拨打系统联系人”，根据系统提示选择联系人。选中联系人后可进入详情页并发起 SIP 音频或视频通话。

此入口用于选择本机联系人拨号，不会将系统联系人自动上传为云端联系人。

点击云端联系人或系统联系人可查看其名称、号码、通话记录，并可：

• 选择分机后发起音频或视频通话
• 加入或移出黑名单
• 删除云端联系人

系统联系人仅用于拨号，详情页不提供删除操作。

进入路径：顶部设置 > 黑名单设置。

黑名单用于拦截匹配地址的来电。点击“新增”后填写备注名称和 SIP 地址；支持分机号、完整 SIP 地址和 tel: 地址，例如：

• 1001
• 1001@demo.xswitch.com
• sip:1001@demo.xswitch.com
• tel:1001

联系人详情页也可直接加入或移出黑名单。需要恢复接听时，在黑名单列表中点击“删除”，或在联系人详情页点击“移出黑名单”。

进入路径：顶部设置。

• 关于我们：查看应用所属公司的介绍。
• 查看隐私政策：在内置网页中打开《隐私政策》。
• 语言切换：每次点击会在简体中文、English、繁體中文之间切换。
• 主题模式：每次点击会在跟随系统、日间模式、夜间模式之间切换。

请依次检查：

1. 网络是否正常。
2. 是否已在 SIP 账号详情页完成“重新注册”，且状态为“已注册”。
3. 拨号盘或联系人详情页中选择的分机是否正确。
4. 是否已允许麦克风权限；视频通话还需允许相机权限。
5. 来电号码或 SIP 地址是否被加入黑名单。

平台登录与 SIP 注册是两个独立步骤。请进入 设置 > SIP账号，确认当前分机已注册；若没有可用分机，请按管理员提供的信息手动新增并重新注册。

请在鸿蒙系统设置中确认已允许本应用发送通知，并避免限制应用在后台运行。应用重新回到前台后会尝试恢复 SIP 注册。

请确认已授予相机权限、相机未被其他应用占用，且网络稳定。若对端不支持视频或网络条件不足，可改用音频通话。

请确认姓名和电话均已填写；如果提示当前账号没有新增联系人权限，请联系平台管理员。