Interface AudioIn

Represents a device that takes audio input.

interface AudioIn {
    getProperties: () => Promise<AudioProperties>;
    name: string;
    doCommand(command: Struct): Promise<JsonValue>;
    getAudio(
        codec: string,
        durationSeconds: number,
        previousTimestamp?: bigint,
        extra?: Struct,
    ): AsyncIterable<AudioChunk>;
}

Hierarchy (View Summary)

Implemented by

Properties

getProperties name

Methods

doCommand getAudio

Properties

getProperties

getProperties: () => Promise<AudioProperties>

Return the audio input properties.

Example

const audioIn = new VIAM.AudioInClient(machine, 'my_audio_in');
const properties = await audioIn.getProperties();

Readonlyname

name: string

The name of the resource.

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' },
      })
    );

getAudio

  • getAudio(
        codec: string,
        durationSeconds: number,
        previousTimestamp?: bigint,
        extra?: Struct,
    ): AsyncIterable<AudioChunk>

    Stream audio from the device.

    Parameters

    • codec: string
    • durationSeconds: number
    • OptionalpreviousTimestamp: bigint
    • Optionalextra: Struct

    Returns AsyncIterable<AudioChunk>

    Example

    const audioIn = new VIAM.AudioInClient(machine, 'my_audio_in');
    const stream = audioIn.getAudio(VIAM.AudioCodec.PCM16, 3, 0n, {});

Settings

Member Visibility

On This Page

Properties
Methods