@minto-ai/huoshan-tts/dist/utils/ssml-converter.d.ts

借助“火山引擎在线语音合成API”实现浏览器端“文本转语音

/**
 * 发音规则
 * 描述某一段文本的发音，供转换为 Ssml 的 <phoneme> 使用
 * @property content 原始文本内容（可为多字符，用于最长匹配）
 * @property alphabet 发音字母表，支持 'py'（拼音）或 'ipa'
 * @property ph 发音标记，依据 alphabet 的格式填写
 */
interface PronunciationRule {
    content: string;
    alphabet: 'py' | 'ipa';
    ph: string;
}
/**
 * 发音规则列表
 * 由多个发音规则构成的数组
 */
type PronunciationRuleList = Array<PronunciationRule>;
/**
 * Ssml 转换器
 * 根据发音规则，将输入文本按最长匹配替换为 <phoneme> 并输出 Ssml
 */
declare class SsmlConverter {
    private readonly pronunciationRules;
    /**
     * 创建 Ssml 转换器
     * @param pronunciationRules 多音字/词规则列表，按长度降序用于最长匹配
     */
    constructor(pronunciationRules: PronunciationRuleList);
    /**
     * 批量转换段落为 Ssml 字符串数组
     * @param paragraphs 段落文本数组
     * @returns Ssml 字符串数组
     */
    convertParagraphs(paragraphs: string[]): string[];
    /**
     * 单段落转换为 Ssml
     * @param paragraph 段落文本
     * @returns Ssml 字符串
     */
    private convertParagraph;
}
/**
 * 创建或复用 Ssml 转换器（单例）
 * @param pronunciationRules 发音规则列表
 * @returns SsmlConverter 实例（全局复用）
 */
declare function createSsmlConverter(pronunciationRules: PronunciationRuleList): SsmlConverter;
export { createSsmlConverter, };
export type { PronunciationRule, PronunciationRuleList, SsmlConverter, };