如何将 TTS 合成的 WAV 文件保存到 Android 应用内部存储

本文详解如何使用 Android TextToSpeech 的 `synthesizeToFile()` 方法，将语音合成结果安全、合规地保存至应用私有内部存储（而非外部存储），避免权限问题并提升数据安全性。

在 Android 开发中，TextToSpeech.synthesizeToFile() 是生成语音文件的核心方法。但许多开发者误用 Environment.getExternalStoragePublicDirectory()（需 READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE 权限，且自 Android 10+ 已受限），导致兼容性差或权限拒绝。正确做法是将 WAV 文件保存至应用专属的内部存储目录——无需任何运行时权限，路径私有、自动随应用卸载清理，符合现代 Android 存储最佳实践。

✅ 正确保存至内部存储（推荐方案）

Android 提供 getFilesDir() 或 getCacheDir() 获取应用私有内部目录。其中 getFilesDir() 更适合长期保存用户生成内容（如 TTS 音频）：

public void speakNow(View v) {
    String inputText = et.getText().toString().trim();
    if (inputText.isEmpty()) return;

    // ✅ 使用内部存储路径：/data/data/<package>/files/Audio007/
    File audioDir = new File(getFilesDir(), "Audio007");
    if (!audioDir.exists()) {
        audioDir.mkdirs(); // 自动创建多级目录
    }
    File destFile = new File(audioDir, "wakeUp.wav");

    // 构建参数哈希表（可选：设置 utterance ID 用于回调）
    HashMap<String, String> params = new HashMap<>();
    params.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, inputText);

    // ? 关键：直接传入 File 对象的绝对路径（String 形式）
    int result = tts.synthesizeToFile(
        inputText,
        params,
        destFile.getAbsolutePath() // ← 使用内部路径，非 Environment.getExternalStorage...
    );

    if (result == TextToSpeech.SUCCESS) {
        Log.i(tag, "WAV saved successfully to: " + destFile.getAbsolutePath());
        Toast.makeText(this, "Saved to internal storage", Toast.LENGTH_SHORT).show();
    } else {
        Log.e(tag, "TTS synthesis failed: " + result);
        Toast.makeText(this, "Synthesis failed", Toast.LENGTH_SHORT).show();
    }
}

⚠️ 注意事项与常见误区

• 不要手动用 FileOutputStream 写入 synthesizeToFile() 的输出：该方法已完整处理音频编码与写入，OUTPUT_FILE_PLACE_HERE 在你的参考答案中是误导性伪代码——TTS 不提供原始字节流，无法手动 fos.write()。
• 权限零依赖：getFilesDir() 返回路径位于应用沙盒内，无需声明任何存储权限（<uses-permission> 可完全移除）。
• 路径兼容性：getFilesDir() 在所有 Android 版本均稳定可用；避免使用已废弃的 getExternalStorageDirectory()。
• 文件访问限制：内部存储文件默认不可被其他应用或文件管理器直接访问（除非 root）。如需分享，应通过 FileProvider 提供 URI。
• 异步执行：synthesizeToFile() 是同步阻塞调用，建议在后台线程（如 Executors.newSingleThreadExecutor()）中执行，避免主线程卡顿。

? 补充：验证文件是否生成成功

可在调试时快速检查文件是否存在及大小：

if (destFile.exists() && destFile.length() > 0) {
    Log.d(tag, "File size: " + destFile.length() + " bytes"); // 正常 WAV 通常 ≥ 5KB
} else {
    Log.w(tag, "File is empty or not created");
}

遵循以上方式，你即可安全、简洁、向后兼容地将 TTS 输出持久化至内部存储，彻底规避外部存储权限与分区变更（Scoped Storage）带来的复杂性。