---
name: "onWiFiSignalChange"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "onWiFiSignalChange - Listen to device signal strength changes."
summary: "Listen to device signal strength changes."
---

## onWiFiSignalChange

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

### Description

Subscribe to Wi‑Fi signal changes

### Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `cb` | `(params: WiFiSignalChangeParams) => void` | Yes | Callback |

##### WiFiSignalChangeParams properties

| Property | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `signal` | `number` | Yes | - | Signal strength |
| `level` | `"good" \| "normal" \| "weak" \| "bad"` | Yes | - | Signal level |
| `devId` | `string` | No | - | Device ID |


### Return Value

None


### Examples

#### Subscribe to signal changes

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