EVCC Mini 使用手册¶
最后更新：
面向使用 EVCC Mini 小窗快控的用户。
PCHCC mini（SaaS 版）¶
PCHCC 主应用内置配套的 PCHCC mini。在主应用的小窗入口安装或更新；只有主应用当前具有有效 SaaS 授权时才可使用，无需另外试用或输入 Mini 激活码。主应用授权失效、撤销或通信失败时，小窗停止显示车辆数据和执行动作。标准 EVCC Mini 继续使用下文的独立增值服务规则。
PCHCC mini 的应用标识为 com.pch.pchcc.mini，与旧 EVCC Mini 分开安装，不会自动迁移旧应用的私有数据。更新时使用主应用内置的同版本安装包；不能通过该入口安装其它 APK。
小窗控制台由管理员配置，目前推荐音乐、车内温度、剩余电量与空调四项，按窗口可用高度显示在一屏内，无需上下滚动。控制台组件和布局不可编辑，主控制台与 Mini 分别配置。应用页可以添加、删除、排序常用应用并调整显示和启动方式；可选择用户安装的应用和 Spotify，其它系统或预装应用不会出现在可启动列表中。音乐播放、暂停、切歌等控制保持可用，实际启动模式取决于车机能力。
后台的主控制台、自动化和 Mini 预设分别使用全局默认；管理员增加车型及匹配名称后，可分别覆盖，未设置的类别继续继承全局。更新后保留应用列表、显示偏好和已有自动化的启停选择。小窗界面、实车通信和第三方音乐运行效果需在对应车机上确认。
1. EVCC Mini 是什么¶
EVCC Mini 是独立安装的小窗 APK，用于在 Flyme Auto 小窗中快速查看车辆数据、控制组件、操作音乐或启动常用 App。
两个 APK 的分工：
- 主 EVCC：负责激活、车辆数据、RootService、自动化、音乐桥接和所有配置；
- EVCC Mini：负责小窗界面、页面切换和用户操作展示。
EVCC Mini 不能替代主 EVCC。主 EVCC 未安装、未激活或后台能力不可用时，Mini 的数据和动作会受到影响。
更新时建议主 EVCC 与 EVCC Mini 使用同一次发布的配套版本。
2. 安装与入口¶
- 安装主 EVCC；
- 安装 EVCC Mini；
- 打开主 EVCC；
- 顶部页面栏的
+旁会显示 Mini 圆形入口； - 点击入口进入 Mini 编辑器。
只有检测到独立 Mini APK 已安装时才显示入口。卸载 Mini 后入口会自动隐藏。
3. 试用与激活¶
EVCC Mini 是独立增值服务。首次进入编辑器时可以：
- 开始 7 天试用；
- 输入已有激活码；
- 已激活用户直接进入编辑器。
3.1 开始试用¶
试用从点击“开始 7 天试用”时起算。没有主动开始试用不会提前消耗时间。试用结束后，Mini 会显示授权提示，主 EVCC 本体不受影响。
3.2 激活码激活¶
- 点击“我已有激活码”；
- 输入
XXXXX-XXXXX格式激活码； - 核对设备 ID 和激活码；
- 确认激活；
- 成功后编辑器立即放行。
激活码会绑定当前设备。换机时应使用主 EVCC 的设备迁移功能，不要在新设备上重复尝试旧码。
3.3 离线使用¶
- 正式激活后可在允许的离线周期内使用，超时需联网重新校验；
- 试用按真实时间计算，不因离线暂停；
- 长期离线前建议先联网打开一次主 EVCC 和 Mini。
3.4 常见激活提示¶
| 提示 | 处理方法 |
|---|---|
| 激活码无效 | 检查字符、横杠和多余空格 |
| 激活码已使用 | 联系发放者核对绑定设备 |
| 激活码已撤销 | 联系管理员 |
| 设备未注册 | 先完成主 EVCC 激活并保持联网 |
| 失败次数过多 | 按提示等待后再试，不要连续提交 |
| 未知错误 | 同时更新主 EVCC 和 Mini，并上传当前日志 |
4. 页面类型¶
Mini 支持多个页面左右滑动切换。新用户通常会看到控制台、音乐和应用菜单三类页面。
| 页面 | 用途 |
|---|---|
| 控制台/仪表 | 显示车辆数据和操作组件 |
| 音乐 | 显示封面、歌词、进度和播放控制 |
| 应用菜单 | 启动常用 App，支持多种启动方式 |
4.1 添加和管理页面¶
在 Mini 编辑器顶部：
- 点击
+添加页面； - 点击页面标签切换；
- 长按标签可重命名、删除、上移或下移；
- 至少保留一个普通页面；
- 保存后 Mini 小窗会自动刷新。
老版本已有控制台组件会迁移到默认仪表页，不会主动覆盖用户原布局。
5. 控制台/仪表页¶
5.1 网格与组件¶
- 每页可以单独设置行列；
- 支持信息卡、开关、按钮、滑块、下拉、按钮组、图表和音乐组件；
- 不支持只用于大屏排版的分区标题；
- 可从主控制台复制组件，复制后会生成独立组件，不会和原组件共用布局位置；
- 组件仍使用主 EVCC 的车辆属性、变量、自动化和动作能力。
5.2 DPI¶
Mini DPI 用于统一放大或缩小该页文字、按钮和间距，不改变网格结构。
- 字太小：适当提高 DPI；
- 内容拥挤：降低 DPI 或增加网格；
- 调整后检查按钮是否仍能完整点击；
- DPI 过高可能让文字或弹窗超出小窗。
5.3 模板¶
Mini 编辑器可以：
- 保存本地小窗模板；
- 加载本地模板；
- 浏览模板商店和组件商店；
- 上传当前布局。
小窗生成的模板会带小窗标识。应用他人模板前，建议先保存当前布局。
6. 音乐页¶
音乐页使用主 EVCC“服务 → 音乐桥接”的数据，不需要单独选择音乐源。
可显示：
- 歌曲封面；
- 歌名和歌手；
- 当前歌词；
- 播放进度和时间；
- 上一首、播放/暂停、下一首；
- 支持时可拖动进度条跳转。
6.1 开始使用¶
- 在主 EVCC 打开音乐桥接；
- 播放一首歌曲并确认主 EVCC 能识别；
- 在 Mini 编辑器添加“音乐”页面；
- 保存并打开 Mini；
- 左右滑动到音乐页。
点击标题区域可打开上次使用的音乐 App。Flyme 小窗放大按钮会尝试全屏打开当前正在播放的音乐 App。
6.2 没有音乐内容¶
- 车机重启后音乐桥接可能需要等待约一分钟；
- 确认音乐 App 已产生真实媒体会话；
- 先在主 EVCC 音乐桥接卡片检查状态；
- 未连接时点击 Mini 的启动提示可尝试拉起音乐 App；
- 封面或歌词是否存在取决于音乐 App 和当前歌曲。
7. 应用菜单页¶
应用菜单只显示用户手动添加的 App，不会默认列出系统全部应用。
7.1 添加和排序¶
- 进入应用菜单页；
- 点击最后一个“添加”图标；
- 搜索并选择目标 App；
- 长按 App 可进入单项设置；
- 长按并拖动可调整顺序；
- 可设置列数、行数和图标大小。
7.2 三种启动方式¶
| 模式 | 行为 | 适合场景 |
|---|---|---|
| 虚拟屏幕 | 在 Mini 内增加临时页面显示 App | 希望留在 Mini 小窗内操作 |
| 直开 | 直接从 Mini 启动目标 App，并尽量继承小窗 | 地图、音乐、设置等兼容小窗的 App |
| 全屏开启 | 由主 EVCC 全屏启动 App | 不适合小窗或需要完整界面的 App |
不是所有 App 都支持虚拟屏幕或小窗。显示异常时先切换其他启动方式。
7.3 虚拟屏幕设置¶
每个 App 可单独设置：
- DPI；
- 是否使用沉浸式状态栏；
- 启动方式；
- 从菜单删除。
Mini 同时复用一个应用菜单虚拟屏。再次打开同一 App 会返回已有页面；打开另一个 App 会在同一虚拟屏上切换。手动关闭或空闲一段时间后，临时页面会被移除。
7.4 虚拟屏幕常见问题¶
- 画面太大或太小：调整该 App 的 DPI；
- 顶部被遮挡：关闭沉浸式状态栏；
- 触控位置不准：关闭页面重开，或换直开模式；
- App 黑屏：该 App 可能不支持虚拟显示，改用直开或全屏；
- 无法启动：检查主 EVCC 的 RootService。
8. MC 卡片直开 Mini¶
在 Mini 编辑器的“EVCC Mini 设置”中，可开启“MC 卡片直开 EVCC Mini”。
- 首次点击 Flyme 音乐控制卡片时打开 Mini；
- 短时间内再次点击会保留 Flyme 官方音乐窗；
- 默认使用无障碍识别；
- 部分旧车型可切换到 Log 监测兼容方式；
- 两种方式只需选择一种。
如果完全没有反应，先检查相应权限，再尝试另一种方式。
9. 数据和动作为什么依赖主 EVCC¶
Mini 只负责显示和接收操作。以下能力来自主 EVCC：
- VHAL、APVP、AIDL、CAPI、AdaptAPI、SOA 数据；
- 全局变量与自动化；
- 音乐桥接；
- RootService 高权限动作；
- 模板、组件和页面配置。
因此，Mini 页面正常但数值不刷新时，应先检查主 EVCC 的对应数据源；按钮显示正常但动作失败时，应检查主 EVCC 的连接状态和执行日志。
10. 配置保存与迁移¶
- Mini 页面和组件配置保存在主 EVCC；
- 页面修改保存后会自动通知 Mini 刷新；
- 完整配置备份会包含 Mini 相关设置；
- 主 EVCC 设备迁移成功后，Mini 权益会按规则一同迁移；
- 重装前建议备份主 EVCC，而不是只保留 Mini APK。
11. 常见问题¶
主 EVCC 中没有 Mini 入口¶
- Mini 独立 APK 是否已安装；
- 两个 APK 是否为配套版本；
- 关闭并重新打开主 EVCC；
- 仍不显示时重启车机。
打开 Mini 只显示授权提示¶
- 在主 EVCC Mini 编辑器中开始试用或输入激活码；
- 确认主 EVCC 本体已激活；
- 保持联网刷新状态；
- 提供设备 ID 和当前日志给管理员。
页面存在但没有数据¶
- 检查主 EVCC 对应属性源；
- 检查组件绑定的属性 ID；
- 检查主 EVCC 是否被系统完全停止；
- 音乐组件另需音乐桥接运行；
- 从主 EVCC 重新保存一次 Mini 配置。
按钮点击没有动作¶
- 查看主 EVCC 运行日志；
- 检查 RootService 和数据源；
- 检查组件动作是否引用已删除的规则、App 或属性；
- 在主控制台中单独测试相同动作。
左右滑动或页面顺序异常¶
- 回到主 EVCC Mini 编辑器检查页面顺序；
- 保存后等待自动刷新；
- 临时虚拟屏页面不会永久保存；
- 关闭当前虚拟屏再重新打开。
更新后提示版本不兼容¶
主 EVCC 和 Mini 同时更新到同一次发布版本。不要只更新其中一个 APK。
12. 安全建议¶
- 行驶中只保留少量大按钮，不要设计复杂菜单；
- 高风险动作开启确认执行；
- 不把清数据、卸载、系统命令放在容易误触的位置；
- 虚拟屏不要长期运行高负载视频或大型应用；
- 修改布局前保存模板；
- 遇到异常先检查主 EVCC 日志，不要直接清除数据。
主程序完整说明见 EVCC 用户手册，自动化组件见 EVCC 自动化使用手册。