---
name: "SmartStorageAbility.set"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "添加存储数据"
summary: "根据 key 添加存储数据，value 字符串长度建议不超过 256，最大不超过 900。"
---

## SmartStorageAbility.set

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 当 storageType 不为 'local' 时，value 序列化后最大长度为 900 字符。
> 本地缓存支持的 value 最大长度超过 1024。

### 描述

存储指定 key 的数据

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `key` | `string` | 是 | 存储键名 |
| `value` | `T` | 是 | 要存储的值，序列化后长度不能超过 900 字符（建议 256 以内） |

### 返回值

类型: `Promise<boolean>`

存储操作结果

### 示例代码

#### 示例

```typescript
await sdm.storage.set('brightness', 80);
await sdm.storage.set('config', { mode: 'auto', level: 3 });
```