SmartGroupModel.onDeviceOnlineStatusUpdate(listener: Function)

Requires:
@ray-js/panel-sdk≥1.5.0

Description

Listen for smart group online status changes

Parameters

ParameterTypeRequiredDescription
listener(data: OnlineStatusChanged) => numberYesEvent callback that receives parameters containing device online status and related information

Return Value

Type: number
Listener ID, used to cancel via offDeviceOnlineStatusUpdate

Referenced Types

typeOnlineStatusChangedDevice online/offline status change event callback parameters
PropertyTypeRequiredDescription
onlinebooleanYesOnline status
deviceIdstringYesDevice ID
onlineTypenumberYesDevice online type (reserved for future use)
Wi-Fi online 1 << 0
Local online 1 << 1
Bluetooth LE online 1 << 2
Bluetooth LE mesh online 1 << 3

Examples

Example

const id = group.onDeviceOnlineStatusUpdate((data) => {
  console.log('Online status changed:', data);
});
// Unsubscribe when needed
group.offDeviceOnlineStatusUpdate(id);