Flutter文本转语音插件flutter_azure_tts的使用

Flutter实现Microsoft Azure Cognitive Text-To-Speech API，可以将文本转换为语音。下面我们将介绍如何在Flutter项目中使用flutter_azure_tts插件。

开始使用

初始化框架

首先，需要初始化插件，并提供你的订阅密钥和区域。你还可以选择启用日志记录功能以便调试。

import 'package:flutter_azure_tts/flutter_azure_tts.dart';

void initializeAzureTTS() async {
  await FlutterAzureTts.init(
      subscriptionKey: "YOUR SUBSCRIPTION KEY",
      region: "YOUR REGION",
      withLogs: true); // enable logs
}

获取可用的语音列表

接下来，获取所有可用的语音列表，并选择一个适合你需求的语音。

Future<void> getAvailableVoices() async {
  final voicesResponse = await FlutterAzureTts.getAvailableVoices();

  // 列出所有可用的语音
  print("${voicesResponse.voices}");

  // 选择一个英语神经语音
  final voice = voicesResponse.voices
      .where((element) => element.locale.startsWith("en-"))
      .toList(growable: false).first;

  print("Selected Voice: $voice");
}

请求音频文件

选定语音后，可以生成一段文本对应的音频文件。

Future<void> generateAudio(String text, dynamic voice) async {
  TtsParams params = TtsParams(
      voice: voice,
      audioFormat: AudioOutputFormat.audio16khz32kBitrateMonoMp3,
      rate: 1.5, // 可选语速，默认值为1.0
      text: text);

  final ttsResponse = await FlutterAzureTts.getTts(params);

  // 获取音频字节数据
  final audioBytes = ttsResponse.audio.buffer.asByteData(); // 你可以将这些字节保存到文件以备后用

  print("Audio bytes generated successfully.");
}

使用语音风格和角色（可选）

对于支持风格和角色的语音，你可以指定一个风格或角色来增强语音效果。

Future<void> generateStyledAudio(String text, dynamic voice) async {
  TtsParams params = TtsParams(
      voice: voice,
      audioFormat: AudioOutputFormat.audio16khz32kBitrateMonoMp3,
      text: text,
      role: VoiceRole.SeniorMale,
      style: StyleSsml(
          style: VoiceStyle.cheerful,
          styleDegree: 1.5), // 可选强度，范围从0.01到2.0
  );

  final ttsResponse = await FlutterAzureTts.getTts(params);

  final audioBytes = ttsResponse.audio.buffer.asByteData();
  print("Styled Audio bytes generated successfully.");
}

完整示例

以下是一个完整的示例，展示了如何初始化、获取语音列表并生成音频：

import 'package:flutter_azure_tts/flutter_azure_tts.dart';
import 'package:flutter_azure_tts/src/ssml/style_ssml.dart';

void main() async {
  try {
    // 初始化配置
    await FlutterAzureTts.init(
      subscriptionKey: "YOUR SUBSCRIPTION KEY",
      region: "YOUR REGION",
      withLogs: true,
    );

    // 获取可用的语音
    final voicesResponse = await FlutterAzureTts.getAvailableVoices();
    final voices = voicesResponse.voices;

    // 打印所有可用的语音
    print("$voices");

    // 选择一个支持风格和角色的英语神经语音
    final voice = voicesResponse.voices
        .where((element) =>
            element.locale.startsWith("en-") &&
            element.roles.isNotEmpty &&
            element.styles.isNotEmpty)
        .toList(growable: false)
        .first;

    // 生成文本对应的音频
    final text = "Microsoft Speech Service Text-to-Speech API is awesome";

    TtsParams params = TtsParams(
        voice: voice,
        audioFormat: AudioOutputFormat.audio16khz32kBitrateMonoMp3,
        rate: 1.5,
        style: StyleSsml(style: voice.styles.first, styleDegree: 1.5),
        role: VoiceRole.OlderAdultMale,
        text: text);

    final ttsResponse = await FlutterAzureTts.getTts(params);

    // 获取音频字节
    final audioBytes = ttsResponse.audio.buffer.asByteData();
    print(
        "Audio size: ${(audioBytes.lengthInBytes / (1024 * 1024)).toStringAsPrecision(2)} Mb");
  } catch (e) {
    print("Something went wrong: $e");
  }
}

通过上述步骤，你应该能够成功地在Flutter应用中集成文本转语音功能。确保替换"YOUR SUBSCRIPTION KEY"和"YOUR REGION"为你自己的Azure订阅密钥和区域。