Flutter谷歌翻译插件google_translation的使用

Flutter谷歌翻译插件google_translation的使用

Google Translation 插件方便地使用 Google API 密钥进行翻译。

Pub包

Github仓库

首次公告

目前，Google Translation 插件仅支持 Google 翻译 API 的基本功能。高级功能将在后期添加。

了解更多关于 Google 翻译 及其基本与高级功能的区别 在这里。

开始使用

设置API密钥

在使用 Google 翻译 API 时，你需要设置一个 Google 翻译 API 密钥。

安装

将 google_translation 添加到你的 pubspec.yaml 文件依赖项中。

dependencies:
  google_translation: ^版本号

使用

配置

首次设置 Google 翻译 API。

import 'package:google_translation/google_translation.dart';

void main() async {
  final googleTranslation = GoogleTranslation();
  googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");
}

Google 翻译 API 可以在调用函数时更新或覆盖。

简单翻译

用于文本翻译：

import 'package:google_translation/google_translation.dart';

void main() async {
  final googleTranslation = GoogleTranslation();
  googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");

  final result = await googleTranslation.simpleTextTranslate(
      inputText: "TEXT_NEED_TRANSLATE",
      sourceLanguage: "en", // 可选参数
      targetLanguage: "vi",
      googleAPIKey: "YOUR_GOOGLE_API_KEY", // 可选参数。如果已经在上面设置，则不需要
  );

  print("Result: $result"); // 输出值
}

语言检测

用于语言检测，获取可识别的语言列表：

import 'package:google_translation/google_translation.dart';

void main() async {
  final googleTranslation = GoogleTranslation();
  googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");

  final listDetectLanguages = await googleTranslation.simpleTextDetectLanguages(
      inputText: "TEXT_NEED_TO_DETECT_LANGUAGE",
      googleAPIKey: "YOUR_GOOGLE_API_KEY", // 可选参数。如果已经在上面设置，则不需要
  );

  print("List detect languages: $listDetectLanguages"); // 输出值
}

获取支持的语言

有两种方法可以获取支持的语言：

1. 获取默认支持的语言：

import 'package:google_translation/google_translation.dart';

void main() async {
  final googleTranslation = GoogleTranslation();
  googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");

  final supportLanguages = await googleTranslation.getListSupportLanguages(
     googleAPIKey: "YOUR_GOOGLE_API_KEY", // 可选参数。如果已经在上面设置，则不需要
  );

  print("List support languages: $supportLanguages"); // 输出值
}

1. 获取特定目标本地化支持的语言：

import 'package:google_translation/google_translation.dart';

void main() async {
  final googleTranslation = GoogleTranslation();
  googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");

  final supportLanguages = await googleTranslation.getListSupportLanguages(
      targetLanguage: "en", // 定义此参数
      googleAPIKey: "YOUR_GOOGLE_API_KEY", // 可选参数。如果已经在上面设置，则不需要
  );

  print("List support languages: $supportLanguages"); // 输出值
}

更多关于发现支持的语言的信息，请参阅 这里。

示例代码

以下是一个完整的示例代码，展示如何使用 google_translation 插件进行翻译和语言检测。

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final googleTranslation = GoogleTranslation();
  String result = '';
  String detectLanguage = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    googleTranslation.setupAPIKey("YOUR_GOOGLE_API_KEY");
    performTranslationAndDetection();
  }

  Future<void> performTranslationAndDetection() async {
    // 简单翻译
    final translatedText = await googleTranslation.simpleTextTranslate(
        inputText: "Hello, how are you?",
        sourceLanguage: "en",
        targetLanguage: "vi",
        googleAPIKey: "YOUR_GOOGLE_API_KEY"
    );
    setState(() {
      result = translatedText;
    });

    // 语言检测
    final detectedLanguages = await googleTranslation.simpleTextDetectLanguages(
        inputText: "Bonjour, comment ça va?",
        googleAPIKey: "YOUR_GOOGLE_API_KEY"
    );
    setState(() {
      detectLanguage = detectedLanguages.toString();
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Google Translation Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Translated Text: $result'),
            SizedBox(height: 20),
            Text('Detected Languages: $detectLanguage'),
          ],
        ),
      ),
    );
  }
}