Overview

AlternativePronunciation is a class that defines mapping beween a word and its phonetic pronunciation. Phonetic pronunciation is a space separated string of phonemes that define how the word is pronounced. The names of the phonemes are defined in ASR Bundle lang/phones.txt file. For some languages for which this mapping is not deterministic, ASR Bundle will contain a large lookup table in lang/lexicon.txt file.

You can use AlternativePronunciations to provide alternatives to existing pronunciations, to define pronunciations for the words that are not in the lexicon.txt file (including made-up words), or to provide common mispronunciations (which can be useful in some scenarios such as language learning and reading instruction); For the latter, you can also provide a tag when defining AlternativePronunciation; if such alternative pronunciation is recognized by the recognizer, the # symbol and the provided tag will be appended to the word in the result (e.g. “PEAK#WRONG”, if the tag was set to “WRONG”).

Example:

KIOSAlternativePronunciation *ap = [KIOSAlternativePronunciation new];
ap.word = @"PEAK";
ap.pronunciation = @"P IH0 K";
ap.tag = @"WRONG";