Operations and Functions

DeviceOperation identifies an input reported by the device. DeviceFunction identifies the behavior assigned to that input.

The symbols below describe logical controls. The illustrations are intentionally abstract and do not prescribe device shape, control placement, or a product-specific gesture layout.

Device Operations

Primary controls

Side-specific clicks and long presses on the device's primary controls.

9

.unknown

The device operation is unavailable or not recognized.

AIBudsDeviceOperationUnknown

-1

.leftSingleClick

Perform a single click on the left-side control.

AIBudsDeviceOperationLeftSingleClick

0x01

.rightSingleClick

Perform a single click on the right-side control.

AIBudsDeviceOperationRightSingleClick

0x02

.leftDoubleClick

Perform a double click on the left-side control.

AIBudsDeviceOperationLeftDoubleClick

0x03

.rightDoubleClick

Perform a double click on the right-side control.

AIBudsDeviceOperationRightDoubleClick

0x04

.leftTripleClick

Perform a triple click on the left-side control.

AIBudsDeviceOperationLeftTripleClick

0x05

.rightTripleClick

Perform a triple click on the right-side control.

AIBudsDeviceOperationRightTripleClick

0x06

.leftLongPress

Perform a long press on the left-side control.

AIBudsDeviceOperationLeftLongPress

0x07

.rightLongPress

Perform a long press on the right-side control.

AIBudsDeviceOperationRightLongPress

0x08

Touch panel

Tap and hold gestures reported by a touch-sensitive control surface.

6

.leftTouchSingleClick

Perform a single tap on the touch panel on the left-side control.

AIBudsDeviceOperationLeftTouchSingleClick

0x10

.rightTouchSingleClick

Perform a single tap on the touch panel on the right-side control.

AIBudsDeviceOperationRightTouchSingleClick

0x11

.leftTouchDoubleClick

Perform a double tap on the touch panel on the left-side control.

AIBudsDeviceOperationLeftTouchDoubleClick

0x12

.rightTouchDoubleClick

Perform a double tap on the touch panel on the right-side control.

AIBudsDeviceOperationRightTouchDoubleClick

0x13

.leftTouchLongPress

Perform a long press on the touch panel on the left-side control.

AIBudsDeviceOperationLeftTouchLongPress

0x14

.rightTouchLongPress

Perform a long press on the touch panel on the right-side control.

AIBudsDeviceOperationRightTouchLongPress

0x15

Button 1

Side-specific gestures reported by the control identified as Button 1.

6

.leftButton1SingleClick

Perform a single click on Button 1 on the left-side control.

AIBudsDeviceOperationLeftButton1SingleClick

0x16

.rightButton1SingleClick

Perform a single click on Button 1 on the right-side control.

AIBudsDeviceOperationRightButton1SingleClick

0x17

.leftButton1DoubleClick

Perform a double click on Button 1 on the left-side control.

AIBudsDeviceOperationLeftButton1DoubleClick

0x18

.rightButton1DoubleClick

Perform a double click on Button 1 on the right-side control.

AIBudsDeviceOperationRightButton1DoubleClick

0x19

.leftButton1LongPress

Perform a long press on Button 1 on the left-side control.

AIBudsDeviceOperationLeftButton1LongPress

0x1A

.rightButton1LongPress

Perform a long press on Button 1 on the right-side control.

AIBudsDeviceOperationRightButton1LongPress

0x1B

Button 2

Side-specific gestures reported by the control identified as Button 2.

6

.leftButton2SingleClick

Perform a single click on Button 2 on the left-side control.

AIBudsDeviceOperationLeftButton2SingleClick

0x1C

.rightButton2SingleClick

Perform a single click on Button 2 on the right-side control.

AIBudsDeviceOperationRightButton2SingleClick

0x1D

.leftButton2DoubleClick

Perform a double click on Button 2 on the left-side control.

AIBudsDeviceOperationLeftButton2DoubleClick

0x1E

.rightButton2DoubleClick

Perform a double click on Button 2 on the right-side control.

AIBudsDeviceOperationRightButton2DoubleClick

0x1F

.leftButton2LongPress

Perform a long press on Button 2 on the left-side control.

AIBudsDeviceOperationLeftButton2LongPress

0x20

.rightButton2LongPress

Perform a long press on Button 2 on the right-side control.

AIBudsDeviceOperationRightButton2LongPress

0x21

Touch slides

Directional slides on a supported touch surface.

2

.touchSlideBackwardToForward

Slide from the device-defined backward direction toward forward.

AIBudsDeviceOperationTouchSlideBackwardToForward

0x22

.touchSlideForwardToBackward

Slide from the device-defined forward direction toward backward.

AIBudsDeviceOperationTouchSlideForwardToBackward

0x23

These symbols describe logical controls only. Their icons do not define device shape, control placement, or the gestures supported by a specific product.

Device Functions

General and communication

No-action, calling, and voice-assistant behaviors.

3

.none

Do not assign a behavior to the operation.

AIBudsDeviceFunctionNone

0

.redial

Redial using the device calling behavior.

AIBudsDeviceFunctionRedial

1

.voiceAssistant

Invoke the configured voice assistant.

AIBudsDeviceFunctionVoiceAssistant

2

Playback and volume

Media navigation, playback, volume, and playback-source controls.

6

.previousTrack

Move to the previous track.

AIBudsDeviceFunctionPreviousTrack

3

.nextTrack

Move to the next track.

AIBudsDeviceFunctionNextTrack

4

.volumeUp

Increase volume by a device-defined step.

AIBudsDeviceFunctionVolumeUp

5

.volumeDown

Decrease volume by a device-defined step.

AIBudsDeviceFunctionVolumeDown

6

.playPause

Toggle media playback between playing and paused.

AIBudsDeviceFunctionPlayPause

7

.localBluetoothToggle

Switch between local playback and Bluetooth playback when supported.

AIBudsDeviceFunctionLocalBluetoothToggle

14

Device modes

Device-defined mode and noise-control behaviors.

2

.gameMode

Invoke the device game-mode behavior.

AIBudsDeviceFunctionGameMode

8

.noiseReduction

Invoke the device noise-reduction behavior.

AIBudsDeviceFunctionNoiseReduction

9

Capture and recording

Photo, video, and audio recording behaviors.

4

.takePhoto

Take one photo.

AIBudsDeviceFunctionTakePhoto

10

.continuousShooting

Invoke continuous photo capture.

AIBudsDeviceFunctionContinuousShooting

11

.videoRecordToggle

Toggle video recording between started and stopped.

AIBudsDeviceFunctionVideoRecordToggle

12

.audioRecordToggle

Toggle audio recording between started and stopped.

AIBudsDeviceFunctionAudioRecordToggle

13

The device-reported mapping is authoritative. An enum case does not guarantee that a device accepts the corresponding assignment.

Use the Device Mapping

physicalOperationsMapping remains the source of truth for a connected device. Present only operations reported by that mapping, and treat an assignment as supported only after the device accepts it.