---
name: "onWiFiSignalChange"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "onWiFiSignalChange - 监听设备信号强度变化。"
summary: "监听设备信号强度变化。"
---

## onWiFiSignalChange

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

### 描述

订阅 Wi‑Fi 信号变化。

### 参数

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `cb` | `(params: WiFiSignalChangeParams) => void` | 是 | 回调 |

##### WiFiSignalChangeParams 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `signal` | `number` | 是 | - | 信号强度 |
| `level` | `"good" \| "normal" \| "weak" \| "bad"` | 是 | - | 信号等级 |
| `devId` | `string` | 否 | - | 设备 ID |


### 返回值

无


### 示例代码

#### 订阅信号变化

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