Flutter翻译服务插件preklad_io_client的使用

Flutter翻译服务插件preklad_io_client的使用

Prekla.IO API 服务 该包设计用于与翻译API服务一起工作。
https://preklad.io

特性

它允许按需翻译键值对映射或简单的文本消息。
翻译结果存储在缓存中以减少网络请求。

入门

在 pubspec.yaml 文件中添加 preklad_io_client：

dependencies:
  preklad_io_client: any # 或者使用最新版本

从 Preklad.IO 服务获取 API_KEY。 https://preklad.io

使用方法

配置客户端：

ApiClient.initialize(
      apiKey: 'YOUR_API_KEY',
      sourceLanguage: 'en',
      targetLanguage: 'cs',
    );

翻译纯文本消息：

final result = await ApiClient().translateText(text);

翻译键值对映射：

const textData = {
    'inputField': 'Enter text in English to translate',
    'button': 'Translate',
};
await ApiClient().translateData(textData)

随时通过键使用翻译后的数据：

ApiClient().getTranslationForKey('inputField');

运行示例

查看 example/ 文件夹中的示例应用。

完整示例代码

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  ApiClient.initialize(apiKey: 'YOUR_API_KEY');

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Preklad.io Client Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(
          title: 'Preklad.IO Client Example:  https://preklad.io'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _translatedText = '';
  final _textController = TextEditingController();
  bool _isInitialized = false;

  [@override](/user/override)
  void dispose() {
    _textController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  void initState() {
    super.initState();

    const textData = {
      'inputField': 'Enter text in English to translate',
      'button': 'Translate',
    };

    ApiClient()
        .translateData(textData,
            sourceLanguageCode: 'en', targetLanguageCode: 'es')
        .then((value) {
      setState(() {
        _isInitialized = true;
      });
    });
  }

  String getTextLabel() {
    return ApiClient().getTranslationForKey('inputField');
  }

  String getButtonText() {
    return ApiClient().getTranslationForKey('button');
  }

  buttonClickHandler() async {
    final text = _textController.text;
    final result = await ApiClient().translateText(text);

    setState(() {
      _translatedText = result;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 等待翻译数据加载
    if (!_isInitialized) {
      return Scaffold(
        appBar: AppBar(
          title: Text(widget.title),
        ),
        body: const Center(
          child: CircularProgressIndicator(),
        ),
      );
    }

    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            TextField(
              controller: _textController,
              decoration: InputDecoration(
                border: const OutlineInputBorder(),
                labelText: getTextLabel(),
              ),
            ),
            ElevatedButton(
              onPressed: buttonClickHandler,
              child: Text(getButtonText()),
            ),
            if (_translatedText.isNotEmpty)
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(
                  _translatedText,
                  locale: const Locale('es', 'ES'),
                  style: Theme.of(context).textTheme.headlineSmall,
                ),
              ),
          ],
        ),
      ),
    );
  }
}