产品定制指南

本文档介绍星启系统的产品管理功能，说明如何通过产品定制实现设备的个性化展示，包括产品图片、说明书、固件升级等信息的自定义配置。

概述

当用户在 APP 中添加设备时，会看到产品名称、图片、说明书等信息。通过产品定制，这些信息可以按合作厂商的需求进行配置，展示专属的品牌形象。

这套机制适用于所有类型的智能设备，包括智能门锁、猫眼、网关、智慧中控屏等。

通过这套机制：

• 合作厂商可以拥有专属的产品展示页面
• 不同批次、不同渠道的设备可以关联不同的产品信息
• 固件升级可以按产品独立管理

产品与型号

基本概念

星启系统的产品管理采用产品-型号两级结构：

概念	说明	示例
产品	一组共享相同展示信息的设备集合	"智能门锁 X100（厂商A定制版）"
型号	固件中预定义的硬件标识字符串	SL-X100-A、SL-X100-B

关系：一个产品可以关联多个型号，但一个型号只能归属于一个产品。

型号的拆分与合并

产品与型号的关联关系支持动态调整：

合并场景：多个型号共享相同的产品信息

产品"智能门锁X100"
├── 型号: SL-X100-BK（黑色款）
├── 型号: SL-X100-SV（银色款）
└── 型号: SL-X100-GD（金色款）

拆分场景：某个型号需要独立的产品信息（如合作厂商定制）

产品"智能门锁X100"              产品"智能门锁X100（厂商A定制）"
├── 型号: SL-X100-BK     →     └── 型号: SL-X100-BK-A
└── 型号: SL-X100-SV

这种灵活性确保了：当合作厂商提出定制需求时，可以将其专属型号从默认产品中分离出来，关联到独立的产品配置。

产品信息字段

每个产品可配置以下信息，这些信息将在 APP 中展示给用户：

字段	说明	用途
产品名称	产品的显示名称	APP 设备列表、设备详情页显示
产品图片	产品外观图	APP 设备图标、产品介绍页
说明书	产品说明书 PDF	APP 内查看/下载说明书
客服链接	在线客服或售后服务入口	APP 内跳转客服页面

更多定制需求？

如果您有其他展示需求（如品牌介绍、常见问题等），请与我方沟通，我们将评估可行性并提供解决方案。

工作流程

信息获取时机

APP 可以在两个时机获取产品信息：

时机	说明
设备发现阶段	通过 BLE 广播或二维码中的 productId 提前获取，用户体验更好
设备绑定阶段	通过设备返回的 model 值获取，所有设备都支持

技术细节

关于 productId 和 model 的协议定义，请参阅：

• 设备发现 - BLE 广播数据结构
• 绑定指令 - GetBindingInfo 响应字段

固件开发者须知

本节面向固件开发人员，说明 model 值的定义规范。

model 值的重要性

model 是产品定制的核心标识。APP 通过 model 值查询后台，获取对应的产品信息。

关键原则：不同的设备变体应使用不同的 model 值。

需要区分 model 的场景

场景	示例	说明
不同合作厂商	SL-X100-A、SL-X100-B	厂商 A 和厂商 B 可能需要不同的品牌展示
不同销售批次	SL-X100-2024Q1、SL-X100-2024Q2	不同批次可能有不同的说明书版本
不同销售渠道	SL-X100-JD、SL-X100-TB	不同渠道可能有不同的售后政策
不同硬件配置	SL-X100-CAM、SL-X100-NOCAM	有无摄像头等硬件差异

model 值格式规范

• 长度：建议 8-32 个字符
• 字符集：仅允许字母、数字、中划线（-）、下划线（_）
• 建议格式：{产品系列}-{变体标识}，如 SL-X100-BK-A

为什么要细分 model 值？

如果多个变体共用同一个 model 值，后续将无法为它们配置不同的产品信息。

反面案例：厂商 A 和厂商 B 的设备都使用 SL-X100 作为 model 值，当厂商 A 要求使用自己的品牌 Logo 时，将无法单独配置，因为修改会同时影响厂商 B 的设备。

正确做法：从一开始就为不同厂商分配不同的 model 值（如 SL-X100-A、SL-X100-B），即使初期它们共享相同的产品配置，未来也可以随时拆分。

合作厂商须知

本节面向合作厂商，说明产品定制的流程和可定制内容。

默认产品

所有设备的 model 值默认归属于一个默认产品，该产品使用标准的产品图片和说明书。

如果您对产品展示没有特殊要求，无需进行任何配置，设备将自动使用默认产品信息。

定制流程

如需定制产品展示，请按以下流程操作：

1. 确认 model 值：与我方确认您的设备使用的 model 值
2. 提供定制素材：
   • 产品名称
   • 产品图片（建议尺寸：800×800px，PNG 格式，透明背景）
   • 说明书 PDF
3. 配置上线：我方在星启系统中创建专属产品并关联您的 model 值
4. 验证确认：在 APP 中验证产品信息展示是否正确

可定制内容

内容	说明	展示位置
产品名称	您的品牌产品名称	APP 设备列表、设备详情
产品图片	您的产品外观图	APP 设备图标、产品页
说明书	您的产品说明书 PDF	APP 说明书查看/下载

APP/后台开发者须知

本节说明产品定制功能的技术实现要点。

获取产品信息的场景

场景	说明
添加设备	绑定流程中通过 model 获取产品信息并展示
设备详情	进入设备页面时展示产品图片、名称等
固件升级	通过 model 匹配该产品下的可用固件版本

实现要点

1. 绑定流程：在 GetBindingInfo 返回后，使用 model 值查询产品信息
2. 固件升级：固件包按产品管理，需通过 model 匹配对应产品
3. 缓存策略：产品信息变更频率低，建议本地缓存并设置合理过期时间

技术细节

• 绑定流程中 model 的获取方式，参见 绑定指令
• 固件升级流程，参见 固件升级

相关文档

• 产品与规格 - 产品/规格概念详解
• 设备发现 - BLE 广播中的 productId
• 绑定指令 - GetBindingInfo 返回的 model
• 固件升级 - 按产品管理固件版本