Skip to main content

CommandConverter

aac-voice-api


Defined in: CommandConverter.ts:29

CommandConverter processes transcribed text in real-time, tokenizes it, and matches words against the CommandLibrary.

This class:

  • Tokenizes incoming transcription text into individual words
  • Normalizes and cleans tokens (lowercase, trim, remove punctuation)
  • Checks each token against the CommandLibrary
  • Uses SynonymResolver to check for synonym matches
  • Sends matched commands to CommandHistory with timestamps
  • Automatically executes matched commands
  • Invokes callback when commands are matched

Methods

getConfidenceMatcher()

getConfidenceMatcher(): ConfidenceMatcher;

Defined in: CommandConverter.ts:72

Gets the confidence matcher instance for configuration

Returns

ConfidenceMatcher

The confidence matcher instance


getSynonymResolver()

getSynonymResolver(): SynonymResolver;

Defined in: CommandConverter.ts:81

Gets the synonym resolver instance

Returns

SynonymResolver

The synonym resolver instance


processTranscription()

processTranscription(transcription, speakerId?): Promise<GameCommand[]>;

Defined in: CommandConverter.ts:186

Processes new transcription text by tokenizing it and checking each token against the CommandLibrary using multiple matching strategies:

  • Direct command match
  • Registered synonym match
  • API-based synonym match
  • Confidence/phonetic matching

For each matched command:

  • Logs it to the command log with a timestamp
  • Logs it to the logger with full details
  • Automatically executes the command's action/callback function

Parameters

ParameterTypeDescription

transcription

string

The new transcribed text from getTranscribed()

speakerId?

string

Optional speaker identifier for multi-speaker mode

Returns

Promise<GameCommand[]>

Array of matched commands found in the transcription


getInstance()

static getInstance(): CommandConverter;

Defined in: CommandConverter.ts:61

Returns the singleton instance of CommandConverter.

Returns

CommandConverter

The single shared instance.