VoxaTrace/com.musicmuni.voxatrace.calibra

Package-level declarations

Types

CalibraBreath

object CalibraBreath

Breath capacity and control analysis for vocal performance assessment.

CalibraEffects

class CalibraEffects

Unified audio effects chain for real-time vocal processing.

CalibraEffectsConfig

data class CalibraEffectsConfig(val noiseGate: NoiseGateConfig? = null, val compressor: CompressorConfig? = null, val reverb: ReverbConfig? = null, val sampleRate: Float = 16000.0f)

Configuration for CalibraEffects audio processing chain.

CalibraErrorType

enum CalibraErrorType : Enum<CalibraErrorType>

Error types for Calibra library operations.

CalibraException

class CalibraException(val type: CalibraErrorType, val message: String, val nativeCode: Int? = null) : VoxaTraceException

Exception class for Calibra library errors.

CalibraLiveEval

class CalibraLiveEval : AutoCloseable

Real-time singing evaluation session with segment support.

CalibraMelodyEval

object CalibraMelodyEval

Offline melody/song evaluation for post-recording analysis.

CalibraMusic

object CalibraMusic

Music theory utilities for pitch and note conversions.

CalibraNoteEval

object CalibraNoteEval

Offline note/exercise evaluation for scales, arpeggios, and svara patterns.

CalibraPitch

class CalibraPitch

Unified pitch detection API for singing and speech analysis.

CalibraSpeakingPitch

object CalibraSpeakingPitch

Natural speaking pitch detection for voice profiling.

CalibraVAD

class CalibraVAD

Voice Activity Detection (VAD) for identifying speech/singing in audio.

CalibraVocalRange

class CalibraVocalRange

Streaming vocal range analyzer for determining a singer's pitch range.

ContourExtractorConfig

data class ContourExtractorConfig(val preset: PitchPreset = PitchPreset.BALANCED, val algorithm: PitchAlgorithm = PitchAlgorithm.SWIFT_F0, val sampleRate: Int = 16000, val hopMs: Int = 10, val cleanup: ContourCleanup = ContourCleanup.SCORING, val voiceType: VoiceType = VoiceType.Auto, val quietHandling: QuietHandling = QuietHandling.NORMAL, val strictness: DetectionStrictness = DetectionStrictness.BALANCED)

Configuration for CalibraPitch ContourExtractor.

DetectedNote

data class DetectedNote(val pitch: VocalPitch, val durationSeconds: Float, val isStable: Boolean)

A detected stable note during range analysis.

ExercisePattern

data class ExercisePattern(val noteFrequencies: List<Float>, val noteDurations: List<Int>, val notesPerLoop: Int = noteFrequencies.size)

Pattern for exercise evaluation (scales, arpeggios, etc.).

ExerciseResult

data class ExerciseResult(val score: Float, val noteResults: List<NoteResult>, val keyHz: Float)

Result of an exercise evaluation.

NoteResult

data class NoteResult(val noteIndex: Int, val expectedFrequencyHz: Float, val score: Float, val level: PerformanceLevel = PerformanceLevel.fromScore(score))

Result for a single note in an exercise.

RangeStats

data class RangeStats(val totalPitchesReceived: Int, val validPitchesAfterFiltering: Int, val stableSegmentsDetected: Int, val longestStableSegmentSeconds: Float, val hasEnoughDataForRange: Boolean)

Statistics about accumulated range data.

VocalPitch

data class VocalPitch(val frequencyHz: Float, val midiNote: Int, val noteLabel: String, val confidence: Float = 1.0f)

A detected vocal pitch with quality metrics.

VocalRange

data class VocalRange(val lower: VocalPitch, val upper: VocalPitch, val octaves: Float)

Complete vocal range result with total and comfortable ranges.

VocalRangeConfig

data class VocalRangeConfig(val minNoteDurationSeconds: Float = 1.0f, val minConfidence: Float = 0.5f, val stabilityWindowMs: Float = 50.0f, val maxDeviationSemitones: Float = 1.0f, val sampleRate: Int = 16000)

Configuration for vocal range detection.

VocalRangePhase

enum VocalRangePhase : Enum<VocalRangePhase>

Phases in the vocal range detection flow.

VocalRangeResult

data class VocalRangeResult(val low: VocalPitch, val high: VocalPitch, val octaves: Float, val semitones: Int, val naturalShruti: VocalPitch)

Final vocal range result with calculated metrics.

VocalRangeSession

class VocalRangeSession

High-level vocal range detection session with observable state.

VocalRangeSessionConfig

data class VocalRangeSessionConfig(val countdownSeconds: Int = 3, val maxDetectionTimeSeconds: Int = 10, val minNoteDurationSeconds: Float = 1.0f, val minConfidence: Float = 0.5f, val transitionDelayMs: Long = 500, val autoFlow: Boolean = true)

Configuration for VocalRangeSession.

VocalRangeState

data class VocalRangeState(val phase: VocalRangePhase = VocalRangePhase.IDLE, val countdownSeconds: Int = 0, val phaseMessage: String = "Ready to detect your vocal range", val currentPitch: VocalPitch? = null, val currentAmplitude: Float = 0.0f, val stabilityProgress: Float = 0.0f, val bestLowNote: DetectedNote? = null, val bestHighNote: DetectedNote? = null, val lowNote: DetectedNote? = null, val highNote: DetectedNote? = null, val result: VocalRangeResult? = null, val error: String? = null)

Observable state emitted during vocal range detection.

Inherited functions

init

fun CalibraVAD.Companion.init(context: Context)

Android-specific initialization for CalibraVAD.

isInitialized

fun CalibraVAD.Companion.isInitialized(): Boolean

Check if CalibraVAD has been initialized with Android context.