sdk/com.everysight.mav2.sdk.services/M2GlassesService

M2GlassesService

class M2GlassesService : M2Service

Service for managing the physical connection to the Maverick2 glasses and monitoring their hardware state.

Properties

var readyTimestamp: Long

Milliseconds since epoch when the glasses last reached the Ready state, 0 before the first ready. Useful for measuring connect time and for ignoring stale pre-ready events.

Functions

areGlassesOnFace

fun areGlassesOnFace(): Boolean

Checks whether the glasses are currently detected on the user's face.

fun battery(): Int

Returns the current battery level as a percentage.

fun batteryMW(): Int

Returns the current system power consumption reading.

Initiates a connection to the glasses using the currently configured transport (BLE or WebSocket simulator).

fun description(): String

Returns a parsed human-readable description of the glasses serial number.

fun disconnect()

Disconnects the active transport session (BLE or WebSocket).

fun enableDevice(device: M2DeviceType, enable: Boolean)

Enables or disables a hardware device component on the glasses.

fun fwVersion(): String

Returns the major firmware version number as a string.

fun fwVersions(): Array<Int>

Returns the four firmware version numbers reported by the glasses, in order: ver0, ver1, ver2, ver3 - the same four values com.everysight.mav2.sdk.viewmodels.M2GlassesViewModel exposes as fwVersion0 to fwVersion3. They are firmware-defined counters, not a semantic version, so do not read them as major/minor/patch.

getConfiguredSimulatorHost

fun getConfiguredSimulatorHost(): String

Returns the persisted WebSocket simulator host, normalized the same way setConfiguredSimulator normalizes its argument.

getConnectionStatus

fun getConnectionStatus(): M2ConnectionStatus

Returns the current high-level connection status.

getDeviceAddress

fun getDeviceAddress(): String

Returns the currently configured target BLE device address.

fun getDeviceName(): String

Returns the currently configured target device name.

hasConfiguredDevice

fun hasConfiguredDevice(): Boolean

Returns true when a target device is configured for connection.

isChargerConnected

fun isChargerConnected(): Boolean

Checks whether an external power source is physically connected.

fun isCharging(): Boolean

Checks whether the battery is actively charging.

fun isConnected(): Boolean

Checks whether the transport layer is currently connected.

isDeviceEnabled

fun isDeviceEnabled(device: M2DeviceType): Boolean

Queries whether a specific hardware device component is currently enabled on the glasses.

fun isProximityOn(): Boolean

Checks whether the proximity sensor is currently enabled.

fun isReady(): Boolean

Checks whether the glasses have reached the M2ConnectionStatus.Ready state, meaning all SDK services are fully operational.

isSimulatorConfigured

fun isSimulatorConfigured(): Boolean

Checks whether the WebSocket simulator transport has been configured.

fun isTouchOn(): Boolean

Checks whether the touchpad is currently enabled.

registerBatteryListener

fun registerBatteryListener(listener: IM2GlassesBatteryEvents)

Registers a listener for battery and charging state events.

registerConnectionListener

fun registerConnectionListener(listener: IM2GlassesConnectionEvents)

Registers a listener for connection lifecycle events.

registerSystemListener

fun registerSystemListener(listener: IM2GlassesSystemEvents)

Registers a listener for system, touch, and power-button events.

fun serial(): String

Returns the raw serial number string reported by the glasses firmware.

setConfiguredDevice

fun setConfiguredDevice(address: String?, name: String? = null, autoConnect: Boolean = true)

Configure connection to a BLE device (glasses).

setConfiguredSimulator

fun setConfiguredSimulator(simulatorIpOrHost: String, autoConnect: Boolean = true)

Configure connection to the WebSocket simulator transport.

unregisterBatteryListener

fun unregisterBatteryListener(listener: IM2GlassesBatteryEvents)

Unregisters a previously registered battery event listener.

unregisterConnectionListener

fun unregisterConnectionListener(listener: IM2GlassesConnectionEvents)

Unregisters a previously registered connection lifecycle listener.

unregisterSystemListener

fun unregisterSystemListener(listener: IM2GlassesSystemEvents)

Unregisters a previously registered system event listener.