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

Cloud Text-To-Speech 是一个用于 Google、Microsoft 和 Amazon 文本转语音（TTS）服务的 Flutter 插件。它提供了统一的接口来访问这些服务，并支持多种配置选项。

主要特性

• 支持 Google Cloud TTS、Microsoft Azure Cognitive TTS 和 Amazon Polly。
• 提供通用接口和独立接口以充分利用每个提供商的功能。
• 支持 SSML 输入的清理，确保只发送受支持的 SSML 元素。
• 提供本地语言和英文的语言选择器。
• 可配置输出格式、速率和音调。

使用示例

初始化配置

通用单个提供商

import 'package:cloud_text_to_speech/cloud_text_to_speech.dart';

void main() async {
  // 初始化配置
  await TtsUniversal.init(
    provider: TtsProviders.amazon,
    googleParams: InitParamsGoogle(apiKey: 'API-KEY'),
    microsoftParams: InitParamsMicrosoft(subscriptionKey: 'SUBSCRIPTION-KEY', region: 'eastus'),
    amazonParams: InitParamsAmazon(keyId: 'KEY-ID', accessKey: 'ACCESS-KEY', region: 'us-east-1'),
    withLogs: true,
  );

  // 更换提供商
  TtsUniversal.setProvider(TtsProviders.microsoft);

  // 获取所有可用的声音
  final voicesResponse = await TtsUniversal.getVoices();
  final voices = voicesResponse.voices;

  // 打印所有可用的声音
  print(voices);

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

  // 转换文本为语音并获取音频数据
  const text = "Amazon, Microsoft and Google Text-to-Speech API are awesome";
  final ttsParams = TtsParamsUniversal(
    voice: voice,
    audioFormat: AudioOutputFormatUniversal.mp3_64k,
    text: text,
    rate: 'slow',
    pitch: 'default',
  );
  final ttsResponse = await TtsUniversal.convertTts(ttsParams);
  final audioBytes = ttsResponse.audio.buffer.asByteData();

  // 播放音频（需要额外的播放库，如 audioplayers）
}

使用特定提供商

Google

import 'package:cloud_text_to_speech/cloud_text_to_speech.dart';

void main() async {
  // 初始化 Google 配置
  await TtsGoogle.init(
    params: InitParamsGoogle(apiKey: "API-KEY"),
    withLogs: true,
  );

  // 获取所有可用的声音
  final voicesResponse = await TtsGoogle.getVoices();
  final voices = voicesResponse.voices;

  // 打印所有可用的声音
  print(voices);

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

  // 转换文本为语音并获取音频数据
  final text = '<speak>Google<break time="2s"/> Speech Service Text-to-Speech API is awesome!</speak>';
  final ttsParams = TtsParamsGoogle(
    voice: voice,
    audioFormat: AudioOutputFormatGoogle.mp3,
    text: text,
    rate: 'slow',
    pitch: 'default',
  );
  final ttsResponse = await TtsGoogle.convertTts(ttsParams);
  final audioBytes = ttsResponse.audio.buffer.asByteData();

  // 播放音频（需要额外的播放库，如 audioplayers）
}

Microsoft

import 'package:cloud_text_to_speech/cloud_text_to_speech.dart';

void main() async {
  // 初始化 Microsoft 配置
  await TtsMicrosoft.init(
    params: InitParamsMicrosoft(subscriptionKey: "SUBSCRIPTION-KEY", region: "eastus"),
    withLogs: true,
  );

  // 获取所有可用的声音
  final voicesResponse = await TtsMicrosoft.getVoices();
  final voices = voicesResponse.voices;

  // 打印所有可用的声音
  print(voices);

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

  // 转换文本为语音并获取音频数据
  final text = '<speak>Microsoft<break time="2s"/> Speech Service Text-to-Speech API is awesome!</speak>';
  final ttsParams = TtsParamsMicrosoft(
    voice: voice,
    audioFormat: AudioOutputFormatMicrosoft.audio48Khz192kBitrateMonoMp3,
    text: text,
    rate: 'slow',
    pitch: 'default',
  );
  final ttsResponse = await TtsMicrosoft.convertTts(ttsParams);
  final audioBytes = ttsResponse.audio.buffer.asByteData();

  // 播放音频（需要额外的播放库，如 audioplayers）
}

Amazon

import 'package:cloud_text_to_speech/cloud_text_to_speech.dart';

void main() async {
  // 初始化 Amazon 配置
  await TtsAmazon.init(
    params: InitParamsAmazon(keyId: 'KEY-ID', accessKey: 'ACCESS-KEY', region: 'us-east-1'),
    withLogs: true,
  );

  // 获取所有可用的声音
  final voicesResponse = await TtsAmazon.getVoices();
  final voices = voicesResponse.voices;

  // 打印所有可用的声音
  print(voices);

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

  // 转换文本为语音并获取音频数据
  final text = '<speak>Amazon<break time="2s"/> Speech Service Text-to-Speech API is awesome!</speak>';
  final ttsParams = TtsParamsAmazon(
    voice: voice,
    audioFormat: AudioOutputFormatAmazon.audio48Khz192kBitrateMonoMp3,
    text: text,
    rate: 'slow',
    pitch: 'default',
  );
  final ttsResponse = await TtsAmazon.convertTts(ttsParams);
  final audioBytes = ttsResponse.audio.buffer.asByteData();

  // 播放音频（需要额外的播放库，如 audioplayers）
}

注意事项

1. 保护 API 密钥：确保你的 API 密钥安全，避免从移动或 Web 应用中提取。
2. Amazon Polly 在模拟器中的问题：有时在模拟器中使用 Amazon Polly 可能会遇到 403 错误。
3. SSML/XML 处理：可以使用 xml 包来修复 SSML/XML 格式。
4. 音频格式：所有提供商返回的音频格式是统一的 Uint8List，可以用来播放或保存到文件。
5. 音频播放库：推荐使用 audioplayers 或 assets_audio_player 来播放音频。

希望这些示例代码能帮助你快速上手使用 cloud_text_to_speech 插件。如果有任何问题或需要进一步的帮助，请随时提问！