VoxaTrace/com.musicmuni.voxatrace.calibra.model

Package-level declarations

Types

data class ActiveSegmentState(val segmentIndex: Int, val segment: Segment, val currentPitch: Float, val currentAmplitude: Float, val elapsedSeconds: Float, val isCapturing: Boolean)

State of the currently active segment during practice.

AudioSource

sealed class AudioSource

Represents the source of audio data for evaluation.

LessonMaterial

data class LessonMaterial(val audioSource: AudioSource, val segments: List<Segment>, val keyHz: Float, val pitchContour: PitchContour? = null, val hpcpFrames: List<FloatArray>? = null)

Reference material for singing evaluation.

NoteEvalConfig

data class NoteEvalConfig(val algorithm: ScoringAlgorithm = ScoringAlgorithm.SIMPLE, val boundaryToleranceMs: Int = 0)

Configuration for note evaluation scoring.

NoteEvalPreset

enum NoteEvalPreset : Enum<NoteEvalPreset>

Presets for common note evaluation use cases.

PerformanceLevel

enum PerformanceLevel : Enum<PerformanceLevel>

Performance levels for singing evaluation.

PracticePhase

enum PracticePhase : Enum<PracticePhase>

Practice phase during a CalibraLiveEval session.

ResultAggregation

enum ResultAggregation : Enum<ResultAggregation>

How to aggregate multiple attempts per segment into a final score.

ScoringAlgorithm

enum ScoringAlgorithm : Enum<ScoringAlgorithm>

Algorithm for computing note accuracy scores.

Segment

data class Segment(val index: Int, val startSeconds: Float, val endSeconds: Float, val lyrics: String = "", val studentStartSeconds: Float? = null, val studentEndSeconds: Float? = null)

A segment of a song or exercise with timing and optional lyrics.

SegmentResult

data class SegmentResult(val segment: Segment, val score: Float, val pitchAccuracy: Float = score, val level: PerformanceLevel = PerformanceLevel.fromScore(score), val attemptNumber: Int = 1, val referencePitch: PitchContour = PitchContour.EMPTY, val studentPitch: PitchContour = PitchContour.EMPTY)

Result of evaluating a single segment.

SessionConfig

data class SessionConfig(val autoAdvance: Boolean = true, val scoreThreshold: Float = 0.0f, val maxAttempts: Int = 0, val resultAggregation: ResultAggregation = ResultAggregation.LATEST, val hopSize: Int = 320, val autoPhaseTransition: Boolean = true, val autoSegmentDetection: Boolean = true)

Configuration for a CalibraLiveEval session.

SessionPhase

enum SessionPhase : Enum<SessionPhase>

Current phase of a CalibraLiveEval.

SessionState

data class SessionState(val phase: SessionPhase = SessionPhase.IDLE, val activeSegmentIndex: Int? = null, val activeSegment: Segment? = null, val currentPitch: Float = -1f, val currentAmplitude: Float = 0.0f, val segmentProgress: Float = 0.0f, val completedSegments: Set<Int> = emptySet(), val error: String? = null)

Current state of a CalibraLiveEval.

SingingResult

data class SingingResult(val overallScore: Float, val segmentResults: Map<Int, List<SegmentResult>>, val aggregation: ResultAggregation = ResultAggregation.LATEST)

Complete result of a singing evaluation session.

VADBackend

enum VADBackend : Enum<VADBackend>

Available Voice Activity Detection backend engines.

VADConfig

data class VADConfig(val backend: VADBackend = VADBackend.SPEECH, val sampleRate: Int = 16000, val threshold: Float = 0.5f, val minSpeechDuration: Float = 0.25f, val minSilenceDuration: Float = 0.25f, val windowSize: Int = 512, val numThreads: Int = 1, val modelPath: String? = null, val rmsThreshold: Float = 0.05f, val pitchProbThreshold: Float = 0.5f, val minPitch: Float = 50.0f)

Configuration for Voice Activity Detection.

VADModelProvider

sealed class VADModelProvider

Type-safe model provider for VAD backends.

VADResult

data class VADResult(val ratio: Float, val level: VoiceActivityLevel)

Result from VAD analysis containing ratio, level, and convenience properties.

VoiceActivityLevel

enum VoiceActivityLevel : Enum<VoiceActivityLevel>

Voice activity classification levels.