---
name: "SmartGroupModel.onDeviceOnlineStatusUpdate"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.5.0" }
---

## SmartGroupModel.onDeviceOnlineStatusUpdate

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

> 💡 在群组设备环境中，onDeviceOnlineStatusUpdate 正常情况下不会触发，因为群组目前没有在线状态变更事件。

### 描述

监听智能群组在线状态变更

### 参数

`(listener: Function)`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `listener` | `(data: OnlineStatusChanged) => number` | 是 | 事件回调，接收包含设备在线状态等信息的参数 |

### 返回值

无


### 引用对象

##### `type` OnlineStatusChanged

设备上下线状态变更事件回调参数

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `online` | `boolean` | 在线状态 |
| `deviceId` | `string` | 设备 id |
| `onlineType` | `number` | 设备在线类型（预留，后期使用） Wi-Fi online             1 << 0 Local online             1 << 1 Bluetooth LE online      1 << 2 Bluetooth LE mesh online 1 << 3 |


### 示例代码

#### 示例

```typescript
const id = group.onDeviceOnlineStatusUpdate((data) => {
  console.log('在线状态变更:', data);
});
// 需要时取消监听
group.offDeviceOnlineStatusUpdate(id);
```