开发资源与常用方案¶
最后更新：
这里汇总文档中心“开发手册”板块的公开手册、示例和工具。开放 API、Lua、自动化、MQTT 与兼容 AIDL 拥有各自的入口和契约；选择方式前先看接入方式选择，不要把一种方式的字段套用到另一种。
独立 Android 应用可使用第三方应用跳转入口，按包名打开商店详情以便用户更新， 或打开 Android 权限管理和 EVCC 开放 API 应用授权窗口。入口支持 Scheme URL 与 Intent Action， 无需接入开放 API SDK。
开放 API 资源¶
| 资源 | 适合场景 |
|---|---|
| 接入与快速开始 | 第一次接入、Manifest 和客户端 SDK |
| 权限与授权 | 设计最小权限、处理签名变化与实时撤权 |
| 属性模型 | 五种来源、AUTO、区域、类型化读写和目录 |
| 初始化与监听 | 初始快照、来源换代、Binder 重绑和缺口重同步 |
| 变量与动作 | 共享变量、能力发现和受控动作 |
| AIDL 接口参考 | 接口分组、数据类型和固定资源限制 |
| 状态与错误码 | 按状态分类重试、提示或停止调用 |
开发时优先使用Demo 教程中的 SDK 模式。需要区分 SDK 与底层 Binder 问题时，再使用 Demo 的 Raw AIDL 模式。网页辅助调试台只生成代码、检查参数和模拟回调序号，不能从浏览器 连接车机 Binder 或执行 Shell。
发布资源及校验值见Demo 下载。源码 ZIP 只包含公开 Contract、Client SDK 和独立 Demo，不包含 EVCC 主应用源码或生产签名材料。
Lua、自动化、公式和变量¶
以下是完整开发手册，不是开放 API 的附录：
跨方式协作时重点确认：
- 属性和变量的读取、写入与监听如何映射到类型化 Binder 调用；
- 应用触发现有自动化规则的推荐方式；
- 应留在第三方应用中的网络、存储、计时器和界面生命周期；
- 公式引擎没有通过 EvccApi 1.0 作为通用求值服务开放。
需要在 EVCC 内编排规则或编写脚本时，以对应完整手册为准；需要开发独立 Android 应用时，以公开 Contract、SDK 和运行时能力查询为准。Lua 函数名、自动化动作名和 AIDL 方法名不是同一套命名空间。
其他集成协议¶
小程序 MQTT 接入面向 Broker、远端服务和家庭自动化平台，当前只提供属性与变量的 只读发布。它不是 EvccApi 的网络传输层，MQTT 凭据也不能换取 Binder 权限。
字段、Topic、完整时序和服务端示例见完整 MQTT 协议参考。
米德宝/AIDL 兼容接口用于维护已有客户端。完整协议见 v1和 v2。新应用不得以旧 协议 v1/v2 作为 EvccApi 的版本或兼容层。
扩展与创作¶
内容制作是文档中心的独立一级板块。完整入口、公开规格和在线工具见 扩展与创作概览：
| 资源 | 内容 |
|---|---|
| EVCC 内容商店与分享手册 | 规则、模板、组件、皮肤、脚本和配置包的上传、隐私检查、审核与分享码 |
| MIBO 宠物包制作说明 | .mibo-pet 工程结构、动作素材、打包、部署和实体设备验收 |
| MIBO 仪表与音乐背景制作说明 | 固定文件名、画布、导出格式、预览和部署 |
| MIBO TF 媒体制作说明 | 媒体套装目录、命名、转换、校验和部署 |
EVCC 官网还提供控制台皮肤编辑器、动态壁纸编辑器和配置转换工具。这些工具处理用户主动导入的资源或 配置，不会连接车机 Binder，也不会自动获得开放 API 权限。上传任何内容前，应移除账号、Token、 私人坐标、车辆标识、日志和本地绝对路径。
内容商店里的脚本和配置有自己的审核、签名与分享边界；下载内容不等于授予第三方应用 EvccApi 权限， 恢复配置也不会恢复开放 API 的应用授权。
权威顺序与版本风险¶
遇到内容不一致时，按以下顺序判断：
- 当前版本的公开
evccapi-contract、运行时EvccApiInfo、会话权限和queryCapabilities()； - 本网站与同版本 Demo；
- 与当前开发方式对应的 Lua、自动化、MQTT、内容扩展或兼容接口专题手册；
- 历史示例、截图或第三方教程。
专题手册可能按较早 EVCC 版本整理，示例中的界面位置、能力数量和默认值可能变化。接入代码必须校验 协议主版本、忽略可选的未知字段，并以运行时能力和明确状态为准。涉及车辆写入、动作、Shell 或定位 数据时，还必须在目标 EVCC 版本和真实车机上验证；网页构建通过或 Demo 编译成功不能证明车辆侧行为。
API 1.1 音乐能力¶
开放 API 1.1 已提供通用音乐能力，银河可按迁移指南切换，不再需要绑定旧音乐服务。
API 1.2 音量组¶
SDK 和 Demo 1.2.0 提供查询、读取、设置和增减，包含 Java/Kotlin 示例。先确认协议与独立音量权限；旧服务返回 UNSUPPORTED，重连不重放写入。见音量组接入说明。