Flutter文本转语音合成、管理声音插件elevenlabs_flutter的使用

Flutter文本转语音合成、管理声音插件elevenlabs_flutter的使用

elevenlabs_flutter 是一个用于与ElevenLabs API交互的Flutter包。它提供了文本转语音合成、管理声音等方法。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  elevenlabs_flutter: ^0.1.0

或者运行以下命令：

dart pub add elevenlabs_flutter

然后运行：

dart pub get

使用

首先，导入该包：

import 'package:elevenlabs_flutter/elevenlabs_flutter.dart';

创建 ElevenLabsAPI 的实例：

final elevenLabs = ElevenLabsAPI();

初始化该实例，并传入你的API密钥和基础URL：

await elevenLabs.init(
  baseUrl: 'https://api.elevenlabs.io',
  apiKey: 'YOUR_API_KEY'
);

现在你可以调用各种方法，例如：

// 列出所有可用的声音
final voices = await elevenLabs.listVoices();

// 将文本转换为语音
final result = await elevenLabs.synthesize(
  TextToSpeechRequest(text: '你好，世界！')
);

// 获取合成历史记录
final history = await elevenLabs.getHistory();

处理错误

方法可能会抛出自定义异常，例如：

try {
  await elevenLabs.getVoice('voice_id');
} on NotFoundException catch (e) {
  // 处理404错误
} on UnknownApiException catch (e) {
  // 处理未知错误
}

贡献

欢迎提交拉取请求！如果有任何API方法需要实现，请随时打开一个问题。

许可证

本项目采用3条款BSD许可证，详情见LICENSE文件。

示例代码

下面是一个完整的示例代码，展示了如何使用 elevenlabs_flutter 插件进行文本转语音操作。

import 'package:flutter/material.dart';
import 'package:elevenlabs_flutter/elevenlabs_flutter.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("ElevenLabs Flutter Demo"),
        ),
        body: Center(
          child: TextButton(
            onPressed: () async {
              final elevenLabs = ElevenLabsAPI();
              try {
                await elevenLabs.init(
                  baseUrl: 'https://api.elevenlabs.io',
                  apiKey: 'YOUR_API_KEY'
                );

                // 列出所有可用的声音
                final voices = await elevenLabs.listVoices();
                print("Available Voices: $voices");

                // 将文本转换为语音
                final result = await elevenLabs.synthesize(
                  TextToSpeechRequest(text: '你好，世界！')
                );
                print("Synthesis Result: $result");

                // 获取合成历史记录
                final history = await elevenLabs.getHistory();
                print("Synthesis History: $history");
              } on NotFoundException catch (e) {
                print("404 Error: ${e.message}");
              } on UnknownApiException catch (e) {
                print("Unknown API Error: ${e.message}");
              }
            },
            child: Text("开始合成"),
          ),
        ),
      ),
    );
  }
}