---
name: "SmartStorageAbility.get"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "get - 获取存储的数据"
summary: "根据 key 获取存储的数据，支持本地缓存回调和云端数据同步。"
---

## SmartStorageAbility.get

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

### 描述

读取指定 key 的存储数据

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `key` | `string` | 是 | 存储键名 |
| `callback` | `(cacheData: TReturnRes) => void` | 否 | 可选回调，在数据读取完成后调用 |

### 返回值

类型: `Promise<TReturnRes<T>>`

包含时间戳和值的存储结果

### 引用对象

##### `type` TReturnRes

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `__isEqual__` | `boolean` | 是否是相等的值，用于判断云端是否与本地数据相同，如果相同，则不进行更新 |
| `data` | `Object` | 返回的值和类型 |
| `time` | `timeStamp` | 生成设计的时间戳，用于判断哪端是最新的（本地或云端数据） |

##### `type` TReturnRes.data

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `T` | 返回的值 |
| `type` | `string` | 返回的类型 |


### 示例代码

#### 示例

```typescript
const result = await sdm.storage.get<number>('brightness');
console.log('值:', result.value, '时间:', result.time);
```