语音合成 HarmonyOS SDK

"dependencies": {
                "@package/baidu-tts":"file:./libs/xxxx.har" // 替换“xxxx.har”为实际har包文件名
                }

"requestPermissions": [
{
"name":"ohos.permission.INTERNET"
}
]

private initialTts(): void {
  // 获取tts实例：Context需保证在tts运行期间不被释放（建议用AbilityContext）
  let speechSynthesizer = new SpeechSynthesizer(this);
  // 设置tts监听器（监听合成状态、错误信息）
  speechSynthesizer.setSpeechSynthesizerListener(SpeechSynthesizerListener);
  // 离线合成必需：设置离线授权及资源参数
  this.setOfflineParam(speechSynthesizer);
  // 在线合成必需：设置在线鉴权参数
  this.setOnlineParam(speechSynthesizer);
  // 获取设备cuid
  // SynthesizerTool.getCuid()
}

private setOfflineParam(speechSynthesizer: SpeechSynthesizer): void {
  // 1. 离线授权核心参数：APP_ID、SN码（需替换为业务方自有信息）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_APP_ID, "your appid"); // 百度控制台申请的APP_ID/PID
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_AUTH_SN, "your auth sn"); // 百度申请的离线授权SN码
  // 2. 离线资源库路径：文本模型、发音人模型的绝对路径（需确保设备可访问）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_OFFLINE_MODEL, this.setOfflineModel());
  // 3. 离线授权文件路径（可选，默认路径：/data/storage/el2/base/haps/entry/files/baidu_tts_license）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_TTS_LICENCE_FILE, "/data/storage/el2/base/haps/entry/files/baidu_tts_license");

  // 4. 初始化离线tts服务（耗时操作，建议提前调用，减少首次合成耗时）
  speechSynthesizer.loadOfflineTts().then(
    (ttsError: ITtsError) => {
      let resultCode = ttsError.getDetailCode(); // 0：初始化离线成功（含授权文件验证通过）
      let resultMessage = ttsError.getDetailMessage(); // 成功时为空，失败时返回错误描述
      if (resultCode !== 0) {
        // 离线初始化失败：可结合错误码（如-102）排查授权信息、资源路径
        console.error(`Offline TTS init failed: ${resultCode}, ${resultMessage}`);
      }
    }
  );
}

private setOfflineModel(): string {
  let offlineModel: Record<string, string> = {};
  // 文本模型路径：替换为业务方自有中文/英文文本模型路径
  offlineModel[SpeechSynthesizer.TTS_TEXT_MODEL_FILE] = "/data/storage/el2/base/haps/entry/files/bd_etts_common_text_txt_all_mand_eng_middle_big_v4.1.0_20230423.dat";
  // 发音人模型路径：替换为业务方自有发音人模型路径（如度小美、度小宇）
  offlineModel[SpeechSynthesizer.TTS_SPEECH_MODEL_FILE] = "/data/storage/el2/base/haps/entry/files/bd_etts_navi_speech_f7_mand_eng_high_am-style24k_v4.6.0_20210721.dat";
  return JSON.stringify(offlineModel);
}

private setOnlineParam(speechSynthesizer: SpeechSynthesizer): void {
  // 在线鉴权参数：替换为业务方自有api_key、secret_key（百度控制台申请）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_API_KEY, "your api_key");
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_SECRET_KEY, "your secret_key");
  // 在线发音人：如“0”（度小美）、“1”（度小宇）等（参考5.2.1参数说明）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_ONLINE_SPEAKER, "0");
  // 在线超时时间：2000ms（MIX模式超时切换离线，ONLINE模式超时返回错误）
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_ONLINE_TIMEOUT, "2000");

  // 初始化在线tts服务（非必需，提前调用减少首次合成耗时）
  speechSynthesizer.loadOnlineTts().then(
    (ttsError: ITtsError) => {
      let resultCode = ttsError.getDetailCode(); // 0：初始化在线成功
      let resultMessage = ttsError.getDetailMessage();
    }
  );
}

 private initialTts(): void {
// 获取tts实例，Context需要保证在tts运行期间不会被释放
        let speechSynthesizer = new SpeechSynthesizer(this);
// 设置tts监听器
        speechSynthesizer.setSpeechSynthesizerListener(SpeechSynthesizerListener);
// 如果需要离线合成，设置离线资源
        this.setOfflineParam(speechSynthesizer);
// 如果需要在线合成，设置在线资源
        this.setOnlineParam(speechSynthesizer);
// 获取设备cuid
// SynthesizerTool.getCuid()
    }

    private setOfflineParam(speechSynthesizer: SpeechSynthesizer): void {
        //设置您的app_id
        speechSynthesizer.setParam(SpeechSynthesizer.PARAM_APP_ID, "your appid");
        //设置您的鉴权sn
        speechSynthesizer.setParam(SpeechSynthesizer.PARAM_AUTH_SN, "your auth sn");
        // 离线资源库路径 
        speechSynthesizer.setParam(SpeechSynthesizer.PARAM_OFFLINE_MODEL, this.setOfflineModel());

        // 初始化离线tts服务，服务会读取相应离线资源进行加载，此过程是耗时操作。非必须调用。提前调用，会减少第一次合成或者合成播放接口耗时。
        speechSynthesizer.loadOfflineTts().then(
      (ttsError: ITtsError) => {
        let resultCode = ttsError.getDetailCode();// 返回值为0，初始化离线成功 
        let resultMessage = ttsError.getDetailMessage();// 返回值为0时，描述信息为空      
} );
    }

    private setOfflineModel():string {
    let offlineModel: Record<string, string> = {};
    offlineModel[SpeechSynthesizer.TTS_TEXT_MODEL_FILE] = "text音库在设备中的可访问绝对路径";
    offlineModel[SpeechSynthesizer.TTS_SPEECH_MODEL_FILE] = "speech音库在设备中的可访问绝对路径";
    return JSON.stringify(offlineModel);
    }

private setOnlineParam(speechSynthesizer: SpeechSynthesizer) : void {
// 设置在线需要的api_key和secret_key
speechSynthesizer.setParam(SpeechSynthesizer.PARAM_API_KEY, "your api_key");
speechSynthesizer.setParam(SpeechSynthesizer.PARAM_SECRET_KEY, "your secret_key");
// 设置在线发音人
speechSynthesizer.setParam(SpeechSynthesizer.PARAM_ONLINE_SPEAKER,
onlineSpeaker);
  // 在线超时时间，MIX模式超时会切换至离线，ONLINE模式会超时
  speechSynthesizer.setParam(SpeechSynthesizer.PARAM_ONLINE_TIMEOUT,
  “2000”); // 注意参考参数范围
  // 初始化在线tts服务，服务会读取相应资源进行加载，此过程是耗时操作。非必须调用。提前调用，会减少第一次合成或者合成播放接口耗时。
  speechSynthesizer.loadOnlineTts().then(
      (ttsError: ITtsError) => {
        let resultCode = ttsError.getDetailCode();// 返回值为0，初始化在线成功 
        let resultMessage = ttsError.getDetailMessage();// 返回值为0时，描述信息为空    
} );
}

speechSynthesizer.setParam(SpeechSynthesizer.PARAM_VOLUME, "5");

onSynthesizeResponse(synthesizerResponse: SynthesizerResponse): void;
// 获取业务测设置的合成标识id  
let utteranceId = synthesizerResponse.getUtteranceId(); 
// 获取当前实例id，构建多speechSynthesizer实例时用来区分不同的实例 
 let instanceId = synthesizerResponse.getInstanceId();
// 当前请求的唯一id，该值会串通后面所有链路
let sn = synthesizerResponse.getSn();

synthesizerResponse.getSynthesizeType() == SYNTHESIZE_START

synthesizerResponse.getSynthesizeType() == SYNTHESIZE_DATA_ARRIVED
       let progress = synthesizerData.getAudioProgress(); // 获取合成进度
       let engineType = synthesizerData.getEngineType();// 获取合成类型。0在线，1离线
       let sampleRate = synthesizerData.getAudioSampleRate();// 当前音频采样率
       let audioData = synthesizerData.getAudioData();// 当前音频数据

synthesizerResponse.getSynthesizeType() == SYNTHESIZE_FINISH

synthesizerResponse.getSynthesizeType() == SYNTHESIZE_ERROR
synthesizerResponse.getSynthesizerError() // 获取相关的错误信息

synthesizerResponse.getSynthesizeType() == PLAY_START

synthesizerResponse.getSynthesizeType() == PLAY_PROGRESS

synthesizerResponse.getSynthesizeType() == PLAY_FINISH

public static verifyModelFile(filePath:string):boolean

public static getEngineInfo():string

public static getEngineLibVersion():string

public static getDecoderLibVersion():string

public static getEngineVersion():number

public static matchResEngine(filePath:string) :number

public static getSpeechSampleRate(filePath:string):number

 * 查询离线授权文件（license）的剩余有效天数（避免授权过期导致离线合成失效）
 * @param licenseFilePath 授权文件路径（需与PARAM_TTS_LICENCE_FILE参数值一致）
 * @param id 授权关联ID：license_v2传产品线pid，license_v1传APP_ID
 * @param sn 离线授权SN码（license_v2必需，license_v1传null）
 * @param cuid 设备唯一标识（可通过HarmonyOS系统API获取，如deviceId）
 * @return 数字：剩余有效天数（正数=剩余天数，-1=文件无效，-2=授权信息不匹配，-3=查询失败）
 */
let licensePath = "/data/storage/el2/base/haps/entry/files/baidu_tts_license";
let appId = "your appid";
let authSn = "your auth sn";
let cuid = "1234567890ABCDEF"; // 示例设备ID，需替换为实际值
let leftDays = SynthesizerTool.getLicenseLeftValidDays(licensePath, appId, authSn, cuid);

if (leftDays > 0) {
  console.log("离线授权剩余有效天数：" + leftDays + "天");
  if (leftDays < 30) {
    console.warn("授权即将过期，请及时申请新的离线授权");
  }
} else {
  console.error("授权查询失败，错误码：" + leftDays);
}