---
title: AI 生成式灯光场景方案 - 项目模板
summary: AI 生成式灯光场景方案的项目模板说明，基于 On-App AI 端侧能力提供毫秒级灯光方案生成。涵盖核心功能（端侧 AI 生成、动作预测引擎、单个与批量刷新、实时预览、多选保存、权限校验）、模板源码链接、云能力授权配置步骤及 IDE 项目创建方法。
---

## 项目模板

基于 On-App AI 端侧灯光场景能力，涂鸦为智能照明产品提供高效、低成本、可实时响应的 AI 灯光方案。该方案通过在移动端本地部署轻量化灯光场景生成模型，实现毫秒级（ < 10ms）生成专业级整屋灯光效果，支持一键预览与保存，无需云端推理，显著降低使用门槛与运营成本，全面提升用户体验与规模化落地效率。

### 核心功能

<Image
  src='/images/solution/aiLightingScene/preview_cn.jpg'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '240px',
    marginTop: '20px',
  }}
/>


- **端侧 AI 生成灯光场景:** 基于房间与灯光能力，一键生成 9 组氛围灯光方案，实时呈现，无需繁琐配置。

- **AI 动作预测引擎:** 为每个灯光场景自动匹配设备控制指令（actions），确保效果可落地执行。

- **单个与批量智能刷新:** 支持替换单个灯光方案，或仅刷新未选中的灯光方案，已选内容自动保留。

- **实时灯光预览:** 点击即可执行灯光动作，设备即时反馈，所见即所得。

- **多选保存云端场景:** 支持一次保存多个 AI 生成场景，长期留存并可随时调用。

- **交互体验增强:** 内置加载动画、成功反馈、禁用态提示，避免误触与操作冲突

- **场景数量与权限校验:** 支持上限控制与管理员权限校验，确保场景管理安全合规。

- **灵感补给机制:** 当用户频繁刷新时提供温和提示，提升 AI 交互体验温度。

### 模板

- [AI 生成式灯光场景模板源码](https://github.com/Tuya-Community/tuya-ray-materials?path=template/AILightingSceneTemplate)

> 注意: 

- 模板涉及的接口依赖云能力，需在 [小程序开发者平台](https://platform.tuya.com/miniapp/)`开发设置` - `云能力` 进行授权配置, 具体操作: 找到 `小程序照明场景能力` 卡片, 点击卡片右下角 `授权` 按钮, 完成该云能力授权。
- 如果路径中没有传入具体房间的 `roomId`, 模板默认以当前家庭下第一个房间为例, 开发者可以根据需求调整。
- 建议选择 SMB 相关家庭, 可体验灯光场景创建的完整流程和更多专业照明功能。


在 IDE 中新建智能小程序项目时，选择 **AI 生成式灯光场景模板** 即可快速创建项目, 如下图:

<Image
  src='/images/solution/aiLightingScene/template-select.png'
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    maxWidth: '800px',
    marginTop: '20px',
  }}
/>