Anotação de Avaliação de Pronúncia
Crie uma tarefa de anotação de qualidade de pronúncia no Potato com reprodução de áudio, visualização de forma de onda, escalas de avaliação Likert e campos de texto livre por gravação.
A avaliação de pronúncia aparece em aplicativos de aprendizado de idiomas, fonoaudiologia e treinamento de sotaque. Este tutorial explica como construir interfaces para avaliar a qualidade da pronúncia, sinalizar erros específicos e escrever feedback detalhado. Para os recursos de áudio subjacentes, consulte a documentação de anotação de áudio.
Avaliação Básica de Pronúncia
annotation_task_name: "Pronunciation Assessment"
task_dir: "."
data_files:
- data/learner_recordings.json
item_properties:
id_key: id
text_key: target_text
instance_display:
fields:
- key: target_text
type: text
label: "Target sentence"
- key: audio_path
type: audio
label: "Learner recording"
display_options:
controls: true
show_waveform: true
annotation_schemes:
- annotation_type: likert
name: overall_quality
description: "Overall pronunciation quality"
size: 5
min_label: "Very poor"
max_label: "Excellent"
label_requirement:
required: true
output_annotation_dir: annotation_output/
export_annotation_format: jsonl
user_config:
allow_all_users: trueConfiguração de Avaliação Detalhada
annotation_task_name: "Detailed Pronunciation Assessment"
task_dir: "."
data_files:
- data/recordings.json
item_properties:
id_key: id
text_key: sentence
instance_display:
fields:
- key: sentence
type: text
label: "Target text"
- key: native_language
type: text
label: "First language"
- key: learner_audio
type: audio
label: "Learner recording"
display_options:
controls: true
show_waveform: true
- key: native_audio
type: audio
label: "Native reference"
display_options:
controls: true
annotation_schemes:
- annotation_type: likert
name: overall
description: "Overall pronunciation quality"
size: 5
min_label: "Very poor"
max_label: "Excellent"
label_requirement:
required: true
- annotation_type: likert
name: intelligibility
description: "How understandable is the speaker?"
size: 5
min_label: "Unintelligible"
max_label: "Perfectly clear"
label_requirement:
required: true
- annotation_type: likert
name: accent_strength
description: "How strong is the foreign accent?"
size: 5
min_label: "No accent"
max_label: "Very strong"
- annotation_type: likert
name: intonation
description: "Intonation and rhythm"
size: 5
min_label: "Unnatural"
max_label: "Native-like"
- annotation_type: likert
name: fluency
description: "Fluency, meaning smoothness and pausing"
size: 5
min_label: "Very disfluent"
max_label: "Very fluent"
- annotation_type: multiselect
name: error_types
description: "What errors are present? Select all that apply."
labels:
- Vowel errors
- Consonant errors
- Word stress errors
- Sentence intonation errors
- Rhythm or timing errors
- Added sounds
- Deleted sounds
- Substituted sounds
- No significant errors
- annotation_type: text
name: problem_words
description: "List any mispronounced words"
placeholder: "e.g. 'thought' pronounced as 'taught'"
label_requirement:
required: false
- annotation_type: radio
name: native_comparison
description: "Compared to the native reference"
labels:
- Very different
- Somewhat different
- Fairly similar
- Very similar
- Indistinguishable
- annotation_type: likert
name: confidence
description: "Your confidence in this assessment"
size: 5
min_label: "Low"
max_label: "High"
output_annotation_dir: annotation_output/
export_annotation_format: jsonlAvaliação em Nível de Palavra
Para feedback detalhado de fonema/palavra:
annotation_schemes:
- annotation_type: multirate
name: word_ratings
description: "Rate the pronunciation of each word"
options:
- "the"
- "weather"
- "is"
- "really"
- "nice"
- "today"
labels:
- Poor
- Fair
- Good
arrangement: verticalAnotação em Nível de Fonema
Para pesquisa de fala:
data_files:
- data/phoneme_data.json
item_properties:
id_key: id
text_key: expected_phonemes
annotation_schemes:
- annotation_type: speech_transcript
name: phonemes
description: "Mark substitutions, deletions, and insertions against the expected phonemes"
segments_key: expected_phonemes
error_types:
- substitution
- deletion
- insertion
allow_correction: trueConfiguração Completa
annotation_task_name: "L2 English Pronunciation Assessment"
task_dir: "."
data_files:
- data/esl_recordings.json
item_properties:
id_key: id
text_key: target_sentence
instance_display:
fields:
- key: target_sentence
type: text
label: "The learner was asked to say"
- key: native_language
type: text
label: "First language"
- key: proficiency_level
type: text
label: "Level"
- key: audio_url
type: audio
label: "Recording"
display_options:
controls: true
show_waveform: true
annotation_instructions: |
## Pronunciation Assessment Guidelines
### Rating scales
**Overall score (1-9)**
- 1-3: significant difficulty, hard to understand
- 4-6: noticeable accent, still understandable
- 7-9: minor issues through to native-like
**Comprehensibility** is how much effort understanding takes. Ignore the
accent where the message is clear.
**Accentedness** is the degree of foreign accent, judged independently of
whether you understood it.
### What to listen for
Individual sounds, word stress, sentence intonation, and speaking rate.
### Tips
Listen at least twice. Use slow playback for the details. Be consistent
across recordings rather than across raters.
annotation_schemes:
- annotation_type: likert
name: overall_score
description: "Overall pronunciation score"
size: 9
min_label: "Very poor"
max_label: "Native-like"
label_requirement:
required: true
- annotation_type: likert
name: comprehensibility
description: "How easy is it to understand?"
size: 9
min_label: "Very hard"
max_label: "Very easy"
label_requirement:
required: true
- annotation_type: likert
name: accentedness
description: "How strong is the foreign accent?"
size: 9
min_label: "No accent"
max_label: "Very strong"
- annotation_type: likert
name: vowels
description: "Vowel pronunciation accuracy"
size: 5
min_label: "Poor"
max_label: "Excellent"
- annotation_type: likert
name: consonants
description: "Consonant pronunciation accuracy"
size: 5
min_label: "Poor"
max_label: "Excellent"
- annotation_type: likert
name: word_stress
description: "Word stress patterns"
size: 5
min_label: "Incorrect"
max_label: "Correct"
- annotation_type: likert
name: sentence_intonation
description: "Sentence intonation"
size: 5
min_label: "Unnatural"
max_label: "Natural"
- annotation_type: likert
name: fluency
description: "Speaking fluency"
size: 5
min_label: "Disfluent"
max_label: "Fluent"
- annotation_type: multiselect
name: common_errors
description: "Check all that apply"
labels:
- Th-sounds (think, this)
- R-sounds
- L-sounds
- Vowel length
- Final consonants dropped
- Consonant clusters simplified
- Word stress on wrong syllable
- Flat intonation
- No errors detected
label_requirement:
required: false
- annotation_type: text
name: feedback
description: "Specific words or sounds that need work"
rows: 4
placeholder: "e.g. 'world' - /r/ needs work; 'through' - th sound"
label_requirement:
required: false
- annotation_type: radio
name: confidence
description: "How confident are you in your ratings?"
labels:
- Not confident
- Somewhat confident
- Very confident
training:
enabled: true
data_file: data/calibration_recordings.json
annotation_schemes: ["overall_score", "comprehensibility"]
passing_criteria:
min_correct: 4
allow_retry: true
phases:
order: [training, annotation]
training:
type: training
file: data/calibration_recordings.json
output_annotation_dir: annotation_output/
export_annotation_format: jsonl
user_config:
allow_all_users: trueFormato de Saída
{
"overall_score": "6",
"comprehensibility": "7",
"accentedness": "5",
"vowels": "4",
"consonants": "3",
"word_stress": "4",
"sentence_intonation": "3",
"fluency": "4",
"common_errors": ["Th-sounds (think, this)", "R-sounds"],
"feedback": "'weather' - th sound; 'really' - r sound",
"confidence": "Very confident"
}Dicas para Avaliação de Pronúncia
Avalie algumas gravações de amostra em grupo antes de começar, para que todos se calibrem no mesmo patamar. Mantenha gravações de referência à mão para ancorar suas avaliações. Ouça pelo menos duas vezes, uma para a impressão geral e outra para os detalhes. Use bons fones de ouvido; alto-falantes de celular vão prejudicar. E avaliadores com alguma formação em fonética vão pegar isso mais rápido.
Próximos Passos
- Adicione transcrição do que foi realmente dito
- Configure verificações de confiabilidade entre avaliadores
- Aprenda sobre o crowdsourcing de avaliações de pronúncia
Documentação completa de áudio em Anotação de Áudio.