Interface AudioOut

Represents a device that outputs audio.

interface AudioOut {
    getProperties: () => Promise<AudioProperties>;
    name: string;
    play: (
        audioData: Uint8Array,
        audioInfo?: AudioInfo,
        extra?: Struct,
    ) => Promise<void>;
    doCommand(command: Struct): Promise<JsonValue>;
}

Hierarchy (View Summary)

Implemented by

Properties

getProperties name play

Methods

doCommand

Properties

getProperties

getProperties: () => Promise<AudioProperties>

Return the audio output properties.

Example

const audioOut = new VIAM.AudioOutClient(machine, 'my_audio_out');
const properties = await audioOut.getProperties();

Readonlyname

name: string

The name of the resource.

play

play: (
    audioData: Uint8Array,
    audioInfo?: AudioInfo,
    extra?: Struct,
) => Promise<void>

Play audio on the device.

Type declaration

    • (audioData: Uint8Array, audioInfo?: AudioInfo, extra?: Struct): Promise<void>

    • Parameters

      • audioData: Uint8Array

        The audio data to play

      • OptionalaudioInfo: AudioInfo

        Information about the audio format (optional, required for raw pcm data)

      • Optionalextra: Struct

      Returns Promise<void>

Example

const audioOut = new VIAM.AudioOutClient(machine, 'my_audio_out');
const audioData = new Uint8Array([...]); // Your audio data
const audioInfo = { codec: 'pcm16', sampleRateHz: 48000, numChannels: 2 };
await audioOut.play(audioData, audioInfo);

Methods

doCommand

  • doCommand(command: Struct): Promise<JsonValue>

    Send/Receive arbitrary commands to the resource.

    Parameters

    • command: Struct

      The command to execute.

    Returns Promise<JsonValue>

    Example

    import { Struct } from '@viamrobotics/sdk';

    const result = await resource.doCommand(
      Struct.fromJson({
        myCommand: { key: 'value' },
      })
    );

Settings

Member Visibility

On This Page

Properties
Methods