Skip to main content

Work States

WorkState is a device-reported activity snapshot. Use it to present current activity or avoid conflicting commands; do not treat it as a complete capability declaration.

State Reference

Availability and connection

Initialization, availability, and Bluetooth connection states.

6
.unknown

The current state is unavailable or unrecognized.

AIBudsWorkStateUnknown
-1
.reserved

Reserved by the protocol; do not present it as an actionable state.

AIBudsWorkStateReserved
0
.initializing

The device is initializing.

AIBudsWorkStateInitializing
1
.btOrBleWaitingForConnection

Bluetooth is disconnected and the device is waiting for a connection.

AIBudsWorkStateBtOrBleWaitingForConnection
2
.btOrBleConnectedIdle

Bluetooth is connected and the device is idle.

AIBudsWorkStateBtOrBleConnectedIdle
3
.btOrBleDisconnectedIdle

Bluetooth is disconnected and the device is idle.

AIBudsWorkStateBtOrBleDisconnectedIdle
4

Communication and playback

Foreground communication and playback activity.

3
.calling

The device is in a call.

AIBudsWorkStateCalling
5
.playingLocalMusic

The device is playing local music.

AIBudsWorkStatePlayingLocalMusic
6
.aiConversing

The device is participating in an AI conversation.

AIBudsWorkStateAiConversing
7

Capture, transfer, and streaming

Camera, recording, file-transfer, and streaming activity.

6
.takingPhoto

The device is taking a photo.

AIBudsWorkStateTakingPhoto
9
.aiTakingPhoto

The device is taking a photo for an AI workflow.

AIBudsWorkStateAiTakingPhoto
10
.recordingVideo

The device is recording video.

AIBudsWorkStateRecordingVideo
11
.recordingAudio

The device is recording audio.

AIBudsWorkStateRecordingAudio
12
.fileTransferring

The device is transferring files.

AIBudsWorkStateFileTransferring
13
.streaming

The device is streaming media.

AIBudsWorkStateStreaming
14

Maintenance and testing

Update, reset, shutdown, and factory-test states.

7
.restoringFactorySettings

The device is restoring factory settings.

AIBudsWorkStateRestoringFactorySettings
8
.ota

The device is performing an OTA update.

AIBudsWorkStateOta
15
.shuttingDown

The device is shutting down.

AIBudsWorkStateShuttingDown
16
.factoryTesting

The device is running factory tests.

AIBudsWorkStateFactoryTesting
17
.ledTesting

The device is testing its LEDs.

AIBudsWorkStateLedTesting
18
.buttonTesting

The device is testing its buttons.

AIBudsWorkStateButtonTesting
19
.echoTesting

The device is running an echo test.

AIBudsWorkStateEchoTesting
20
WorkState is a snapshot reported by the device. Treat unknown and reserved as unavailable, and do not infer that every state is supported by every product.