Skip to main content

Interface: CalibrationConfig

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:47

Configuration for environmental calibration using Web Audio APIs.

Properties​

backoffMultiplier?​

optional backoffMultiplier: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:75

Multiplier for the exponential backoff strategy during continuous adaptation.

Default​

1.5

calibrationBufferSize?​

optional calibrationBufferSize: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:58

Buffer size for the ScriptProcessorNode used during initial calibration. Affects how often audio data is analyzed during calibration.

Default​

4096

enableFrequencyAnalysis?​

optional enableFrequencyAnalysis: boolean

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:100

Enable frequency analysis using AnalyserNode during initial calibration.

Default​

true

fftSize?​

optional fftSize: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:106

FFT size for the AnalyserNode. Must be a power of 2. frequencyBinCount will be fftSize / 2.

Default​

256 (yields 128 frequency bins)

initialCalibrationMs?​

optional initialCalibrationMs: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:52

Duration in milliseconds for the initial calibration phase via MediaStream.

Default​

3000

initialUpdateIntervalMs?​

optional initialUpdateIntervalMs: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:70

Initial interval in milliseconds for continuous adaptation checks if no voice activity. This applies when processAudioFrame is used for continuous updates.

Default​

1000

maxBackoffIntervalMs?​

optional maxBackoffIntervalMs: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:80

Maximum interval in milliseconds for continuous adaptation checks.

Default​

30000

minBackoffIntervalMs?​

optional minBackoffIntervalMs: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:85

Minimum interval in milliseconds for continuous adaptation checks after activity or change.

Default​

500

minRmsSamplesForContinuousUpdate?​

optional minRmsSamplesForContinuousUpdate: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:64

Minimum number of RMS samples (from processed frames) required for a meaningful profile update during continuous adaptation (when processAudioFrame is called).

Default​

50

rmsHistoryBufferSize?​

optional rmsHistoryBufferSize: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:90

Number of recent RMS values (from processed frames) to store in a buffer for continuous adaptation.

Default​

50

sampleRate?​

optional sampleRate: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:112

Sample rate of the audio. The calibrator will try to use this for its internal AudioContext. If the input MediaStream has a different rate, resampling might occur or the stream's rate is used.

Default​

16000

thresholdSensitivityFactor?​

optional thresholdSensitivityFactor: number

Defined in: packages/agentos/src/io/hearing/EnvironmentalCalibrator.ts:95

Sensitivity adjustment factor for calculating speech/silence thresholds.

Default​

1.0