# Storage (/zh-CN/api-reference/rtm/react-native/storage)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
RTM 的 Storage 功能提供了一套动态数据库机制,可以让开发者动态设置、存储、更新、删除 Channel Metadata 和 User Metadata 等数据。
## setChannelMetadata [#setchannelmetadata]
### 接口描述 [#接口描述]
`setChannelMetadata` 方法可以为频道(Message Channel 或 Stream Channel)设置 Channel Metadata。一个频道只能有一组 Metadata,但每组 Metadata 可以有一个或多个 Metadata Item。如果多次调用该方法,SDK 会依次检索 Metadata Item 的 `key` 值,并按如下规则处理:
- 如果设置的 Metadata Item `key` 值不同,则会根据调用顺序依次增加。
- 如果设置的 Metadata Item `key` 值相同,则最后一次设置的 Metadata Item 的 `value` 会覆盖之前的值。
成功设置 Channel Metadata 后,订阅该频道且开启事件监听的用户会收到 `channel` 类型的 `storage` 事件通知。详见[事件监听](/zh-CN/api-reference/rtm/react-native/configuration#事件监听)。
Channel Metadata 同时也引进了版本控制逻辑 CAS(Compare And Set),该方法提供两种独立的版本控制字段,你可以根据实际业务场景设置任意一种或多种:
- 通过 `options` 中的 `majorRevision` 属性开启整组 Channel Metadata 的版本号校验。
- 通过 `data` 中单个 Metadata Item 的 `revision` 属性开启某个 Metadata Item 的版本号校验。
设置 Channel Metadata 或 Metadata Item 时,配合版本属性可以控制本次调用是否开启版本号校验,逻辑如下:
- 版本属性默认为 `-1` ,本次调用不开启 CAS 验证。如果 Channel Metadata 或 Metadata Item 已存在,则该值会被最新值覆盖;如果 Channel Metadata 或 Metadata Item 不存在,则 SDK 会创建该值。
- 版本属性为正整数时,本次调用开启 CAS 验证。如果 Channel Metadata 或 Metadata Item 已存在,则 SDK 会在版本号验证成功后更新对应的值;否则 SDK 会返回错误码。
### 接口方法 [#接口方法]
你可以通过以下方式调用 `setChannelMetadata` 方法:
```typescript
setChannelMetadata(
channelName: string,
channelType: RtmChannelType,
data: Metadata,
options?: IMetadataOptions
): Promise;
```
| 参数 | 类型 | 是否必填 | 默认值 | 描述 |
| ---------- | ------------ | ----- | --- | -------------- |
| `channelName` | string | 必填 | - | 频道名称。 |
| `channelType` | RtmChannelType | 必填 | - | 频道类型。支持的取值见[频道类型](/zh-CN/api-reference/rtm/react-native/enumv#channeltype)。 |
| `data` | Array\