---
name: "offDeviceStatusChange"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "offDeviceStatusChange - 注销设备状态信息变更事件。"
summary: "注销设备状态信息变更事件。"
---

## offDeviceStatusChange

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

### 描述

取消订阅设备状态变化（须与订阅时同一 callback 引用）。

### 参数

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `callback` | `(status: DeviceStatus) => void` | 是 | 与订阅时同一引用 |

### 返回值

无


### 引用对象

##### `interface` DeviceStatus

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `type` | `"offline" \| "online" \| "sleep"` | 总状态：在线 / 离线 / 休眠 |
| `connectEnable` | `boolean` | 是否允许用户手动发起连接（如 BLE） |
| `onlineTypes` | `"local" \| "cloud" \| "ble" \| "localMatter" \| "unknown"[]` | 在线通道列表（位语义由平台展开为数组） |
| `sleepPeriod` | `Object` | 休眠窗口（仅 sleep 时） |
| `isWifiActive` | `boolean` | Wi-Fi 模块是否上电工作 |
| `isWifiMatter` | `boolean` | 是否支持为 wifi 走 matter 方案 |

##### `type` DeviceStatus.sleepPeriod

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `start` | `number` | 开始 |
| `end` | `number` | 结束 |


### 示例代码

#### 示例

```ts
import { offDeviceStatusChange } from '@ray-js/lock-sdk';
offDeviceStatusChange((status) => {
  console.log(status);
});
```