用户自定义属性——让最终用户能微调你的壁纸
为什么要暴露用户属性
Workshop 上最受欢迎的壁纸往往有丰富的可调选项。原因很简单：用户下载了一个壁纸，能把它的颜色改成自己喜欢的、能关掉太吵的粒子效果、能放慢动画速度——这让一个壁纸变成了「自己的壁纸」。
三种常见属性类型
| 类型 | 外观 | 可调范围 | 典型用途 |
|---|---|---|---|
color | 颜色选择器 | RGB + Alpha | 主题色 |
slider | 滑块 | 0 ~ 1（或自定义数值） | 速度、强度、阈值 |
bool | 复选框 | 开 / 关 | 开关粒子、开关效果 |
添加用户属性的步骤
- 在编辑器中打开右上角「项目设置」（齿轮图标）
- 进入「Properties」选项卡
- 点击「+ Add Property」添加新属性
- 为属性设置：内部名称（英文，用于代码引用）、显示名称、类型、默认值
- 在 SceneScript 中引用这个属性值，驱动元素参数变化
命名与分类建议
- 内部名称：驼峰命名，如
primaryColor、particleSpeed、enableGlow - 显示名称：面向用户的中文或英文，简洁明了
- 分组：把相关属性归到一组（如「外观」「性能」「互动」），侧栏会按组显示
从属性到 SceneScript 的数据流
用户在客户端调整滑块
↓
SceneScript 中读取 property 值
↓
驱动元素的位置 / 材质参数 / 粒子行为
↓
用户看到效果实时变化这个流程完全在客户端发生，不需要重启壁纸或重新加载。设置越丰富的壁纸，越能让用户觉得是「专属定制」。