# 户外亮化智能灯具产品定义文档

**文档版本**: v1.0  
**制定日期**: 2026年5月30日  
**产品形态**: 地插灯 / 规格灯（可扩展）  
**技术方案**: 蓝牙+MCU控制

---

## 一、产品概述

### 1.1 产品定位
面向户外亮化市场的智能灯具，支持RGB+白光，具备丰富的内置动态效果，可应用于：
- 树木照明
- 墙面洗墙
- 景观氛围营造
- 节日装饰

### 1.2 市场参考
- **对标案例**: Airlines美国客户地插灯项目（月销2万套）
- **差异化优势**: 
  - 有线方案（vs 无线方案），响应速度更快
  - 效果更丰富（支持更复杂的动态效果）
  - 可扩展感应功能

---

## 二、系统架构

### 2.1 控制逻辑（参考星空灯）

```
┌─────────────────────────────────────────┐
│           户外亮化控制系统               │
├─────────────────────────────────────────┤
│  层级结构: 感应模式与其他模式同级         │
│                                         │
│  ┌─────────────┐  ┌─────────────┐      │
│  │  常亮模式    │  │  呼吸模式    │      │
│  └─────────────┘  └─────────────┘      │
│  ┌─────────────┐  ┌─────────────┐      │
│  │  流水模式    │  │  叠加模式    │      │
│  └─────────────┘  └─────────────┘      │
│  ┌─────────────┐  ┌─────────────┐      │
│  │  感应模式 ★ │  │  其他模式... │      │
│  └─────────────┘  └─────────────┘      │
│                                         │
│  感应模式配置:                           │
│  - 感应前状态 (无人时的效果)             │
│  - 感应后状态 (有人时的效果)             │
│  - 感应持续时间                          │
│  - 感应灵敏度                            │
└─────────────────────────────────────────┘
```

### 2.2 与现有产品对比

| 特性 | 彩色楼梯灯 | 星空灯 | 户外亮化灯(本产品) |
|-----|-----------|--------|------------------|
| 感应逻辑 | 核心触发逻辑 | 附加功能 | 附加功能(可选) |
| 模式数量 | 中等 | 较少 | **丰富** |
| 动态效果 | 流水、追逐 | 呼吸、闪烁 | **呼吸+流水+叠加+...** |
| 应用场景 | 楼梯踏步 | 天花板 | **户外景观** |
| 防水等级 | IP20 | IP20 | **IP65+** |

---

## 三、功能规格定义

### 3.1 基础功能

#### 3.1.1 颜色控制
| 功能 | 说明 |
|-----|------|
| RGB全彩 | 1600万色可调 |
| 白光 | 独立白光通道，支持色温调节 |
| 亮度调节 | 0-100%无级调光 |

#### 3.1.2 静态效果
| 效果名称 | 描述 |
|---------|------|
| 单色常亮 | 固定颜色持续亮 |
| 单色呼吸 | 单颜色渐变呼吸 |
| 双色呼吸 | 两种颜色交替呼吸 |
| 白常亮 | 纯白光照明 |

### 3.2 动态效果（重点）

#### 3.2.1 基础动态效果
| 效果名称 | 描述 | 参考来源 |
|---------|------|---------|
| 流水效果 | 颜色像水流一样流动 | 彩色楼梯灯 |
| 追逐效果 | 光点依次追逐 | 彩色楼梯灯 |
| 渐变效果 | 颜色平滑过渡 | 通用 |
| 闪烁效果 | 快速闪烁 | 通用 |

#### 3.2.2 高级叠加效果 ★
| 效果名称 | 描述 | 示例 |
|---------|------|------|
| **底色+刷光** | 保持底色，另一种颜色光刷过 | 红色底色+蓝色光刷 |
| **水波纹** | 类似水波扩散效果 | 中心向外扩散 |
| **渐变流水** | 颜色渐变同时流动 | 彩虹流水 |
| **随机闪烁** | 随机位置随机颜色闪烁 | 星空感 |
| **音乐律动** | 跟随音乐节奏变化 | 需音频输入 |

#### 3.2.3 节日主题效果（参考Airlines）
| 节日 | 效果描述 | 配色方案 |
|-----|---------|---------|
| 万圣节 | 南瓜效果 | 橙色+黄色渐变 |
| 圣诞节 | 雪花/圣诞树 | 红+绿+白 |
| 春节 | 喜庆氛围 | 红+金 |
| 情人节 | 浪漫氛围 | 粉+紫 |
| 独立日 | 美国国庆 | 红+白+蓝 |

### 3.3 感应功能（可选配置）

#### 3.3.1 感应模式配置
```yaml
感应模式:
  触发方式: 雷达感应 / 人体红外
  
  感应前状态:
    - 效果: 可配置任意静态/动态效果
    - 亮度: 可配置(建议30%)
    - 示例: 红色呼吸(低亮度)
  
  感应后状态:
    - 效果: 可配置任意静态/动态效果
    - 亮度: 可配置(建议100%)
    - 示例: 白色常亮(高亮度)
    - 持续时间: 5-300秒可调
  
  感应参数:
    - 感应距离: 1-10米可调
    - 感应角度: 120°
    - 防误触发: 支持
```

#### 3.3.2 感应应用场景
| 场景 | 感应前 | 感应后 | 持续时间 |
|-----|--------|--------|---------|
| 庭院照明 | 微亮呼吸 | 全亮白光 | 30秒 |
| 景观氛围 | 静态底色 | 动态流水 | 60秒 |
| 安全警示 | 熄灭 | 红色闪烁 | 10秒 |

---

## 四、硬件规格

### 4.1 产品形态选项

#### 方案A: 地插灯
| 参数 | 规格 |
|-----|------|
| 安装方式 | 地插式，插入土壤 |
| 照射角度 | 可调，15°-90° |
| 适用场景 | 照树、照墙、草坪 |
| 材质选择 | 塑料壳 / 金属壳 |

#### 方案B: 规格灯
| 参数 | 规格 |
|-----|------|
| 安装方式 | 固定安装 |
| 照射角度 | 固定/可调 |
| 适用场景 | 建筑立面、桥梁 |
| 材质选择 | 金属壳为主 |

### 4.2 材质选择对比

| 材质 | 优点 | 缺点 | 适用场景 |
|-----|------|------|---------|
| **塑料壳** | 轻便、成本低、运费省 | 质感一般、散热差 | 亚马逊零售 |
| **金属壳** | 质感好、散热佳、防水好 | 重、成本高 | 工程项目 |

### 4.3 关键硬件参数

| 参数 | 规格要求 |
|-----|---------|
| 防水等级 | IP65  minimum，目标IP67 |
| 光源 | RGBW LED |
| 功率 | 5W-15W（根据型号） |
| 控制方式 | 蓝牙Mesh / WiFi（可选） |
| 通信距离 | 蓝牙20米 / WiFi 100米 |
| 天线 | 外置天线（金属壳必须） |
| 供电 | AC 110-240V 或 DC 24V |
| 工作温度 | -20°C ~ +50°C |

---

## 五、软件功能规格

### 5.1 控制方式

#### 5.1.1 小程序控制（第一阶段）
| 功能 | 说明 |
|-----|------|
| 设备发现 | 自动搜索附近灯具 |
| 分组控制 | 支持多灯编组 |
| 场景模式 | 预设效果一键切换 |
| 自定义效果 | 颜色、速度、亮度调节 |
| 定时任务 | 定时开关、定时切换效果 |
| 感应配置 | 感应参数设置 |

#### 5.1.2 平台接入（第二阶段）
| 平台 | 优先级 | 说明 |
|-----|-------|------|
| 米家 | P1 | 国内主流，生态完善 |
| 涂鸦 | P2 | 海外客户常用 |
| HomeKit | P3 | 高端用户 |

### 5.2 效果编辑逻辑

```
效果 = 基础效果 + 叠加层 + 动态参数

基础效果:
  - 颜色: RGB值或预设色
  - 亮度: 0-100%
  
叠加层(可选):
  - 叠加颜色
  - 叠加模式: 刷光/波纹/闪烁
  - 叠加速度
  
动态参数:
  - 变化速度
  - 变化方向
  - 循环/单次
```

---

## 六、开发计划

### 6.1 阶段划分

#### Phase 1: 基础功能（4周）
- [ ] 硬件方案确定（塑料壳/金属壳）
- [ ] 基础静态效果开发
- [ ] 小程序基础控制
- [ ] 防水测试

#### Phase 2: 动态效果（4周）
- [ ] 流水/追逐效果
- [ ] 叠加效果开发
- [ ] 节日主题效果
- [ ] 效果参数可调

#### Phase 3: 感应功能（3周）
- [ ] 雷达感应模块集成
- [ ] 感应逻辑开发
- [ ] 感应参数配置
- [ ] 场景测试优化

#### Phase 4: 平台接入（4周）
- [ ] 米家接入
- [ ] 涂鸦接入（可选）
- [ ] 认证测试

### 6.2 关键里程碑

| 时间 | 里程碑 | 交付物 |
|-----|-------|-------|
| 第2周 | 硬件选型完成 | 3D打印样机 |
| 第4周 | 基础功能完成 | 可演示Demo |
| 第8周 | 动态效果完成 | 效果库20+ |
| 第11周 | 感应功能完成 | 完整功能样机 |
| 第15周 | 平台接入完成 | 量产版本 |

---

## 七、成本与定价参考

### 7.1 成本预估

| 项目 | 塑料壳方案 | 金属壳方案 |
|-----|-----------|-----------|
| 外壳 | ¥15-20 | ¥35-50 |
| LED模组 | ¥20-30 | ¥20-30 |
| 控制板 | ¥25-35 | ¥25-35 |
| 电源 | ¥15-20 | ¥15-20 |
| 感应模块 | ¥10-15 | ¥10-15 |
| 其他 | ¥10 | ¥10 |
| **BOM成本** | **¥95-130** | **¥115-160** |

### 7.2 定价策略

| 市场 | 建议零售价 | 备注 |
|-----|-----------|------|
| 国内工程 | ¥200-300 | 金属壳，质感优先 |
| 国内零售 | ¥150-200 | 塑料壳，性价比 |
| 亚马逊 | $30-50 | 塑料壳，轻小件 |
| 海外工程 | $80-150 | 金属壳，高端定位 |

> 参考: Airlines客户零售价$100-300/个

---

## 八、风险评估

| 风险 | 影响 | 应对措施 |
|-----|------|---------|
| 防水不达标 | 高 | 严格IP67测试，选择可靠外壳供应商 |
| 效果不够丰富 | 中 | 参考Airlines效果库，持续迭代 |
| 金属壳信号差 | 中 | 必须外置天线，预留天线接口 |
| 成本过高 | 中 | 双版本策略，塑料壳走量 |
| 市场竞争 | 低 | 差异化感应功能，更快响应速度 |

---

## 九、待确认事项

1. **外壳材质**: 塑料壳 vs 金属壳？还是双版本？
2. **感应方案**: 雷达感应 vs 人体红外？
3. **功率规格**: 单灯功率范围？
4. **首批数量**: 试产数量？
5. **目标市场**: 优先国内工程还是亚马逊？
6. **平台接入**: 先做米家还是涂鸦？

---

## 十、参考资源

1. **Airlines客户效果库** - 需找刘峰/周工获取
2. **星空灯控制逻辑** - 已有代码可参考
3. **彩色楼梯灯效果** - 流水/追逐效果参考
4. **竞品分析** - 企业地插灯产品

---

**文档维护**: 产品开发过程中持续更新  
**下次评审**: 硬件选型确定后