Flutter微软Azure翻译服务插件azure_translation的使用

Flutter微软Azure翻译服务插件azure_translation的使用

插件简介

azure_translation 是一个用于与微软Azure翻译API交互的包装器。它目前支持以下功能：

• 列出语言
• 翻译
• 语言检测
• 分句

即将添加的功能包括：

• 转写（Transliteration）

列出语言

列出语言非常简单：

import 'package:azure_translation/azure_translation.dart' as at;

final langs = (await at.languages()).unwrap();
print(langs.translation?.take(4).join('\n'));
// Language(af, Afrikaans, Afrikaans, ltr)
// Language(am, Amharic, አማርኛ, ltr)
// Language(ar, Arabic, العربية, rtl)
// Language(as, Assamese, অসমীয়া, ltr)

在列表的语言中包含 translation、transliteration 和 dictionary 语言。 可以通过传递可选的 scopes 参数来请求这些中的一个或两个：

listLanguages(scopes: [LanguageScope.translation]);

还有一个可选的 baseLanguage 参数，用于设置 Accept-Language 头部。

final langs = (await at.languages(baseLanguage: 'fr')).unwrap();
print(langs.translationLanguage('en'));
// Language(en, Anglais, English, ltr)

翻译

翻译功能如下：

import 'package:azure_translation/azure_translation.dart' as at;

final res = await at.translate(
    ['hello world', 'good morning'],
    baseLanguage: 'en', // 可选
    languages: ['fr', 'vi', 'ar'],
    key: 'YOUR_AZURE_KEY',
    region: 'YOUR_AZURE_REGION',
);
print(res.object!.join('\n'));
// TranslationResult(hello world, [fr: Salut tout le monde, vi: Chào thế giới, ar: مرحبا بالعالم])
// TranslationResult(good morning, [fr: Bonjour, vi: Xin chào, ar: صباح الخير])

转写（Transliteration）

转写功能如下：

final res = await transliterate(
    ['konnichiwa', 'arigato', 'sayounara'],
    key: key,
    region: region,
    language: 'ja',
    fromScript: 'Latn',
    toScript: 'Jpan',
);
print(res.object!);
// TransliterationResult(ja, Latn -> Jpan, {konnichiwa: こんにちわ, arigato: ありがと, sayounara: さようなら})

语言检测

语言检测功能如下：

final res = await detect(
    ['bonjour', 'hola', 'здравейте'],
    key: key,
    region: region,
);
print(res.object!.join('\n'));
// DetectionResult(bonjour, fr, 1.0, true, false)
// DetectionResult(hola, es, 1.0, true, false)
// DetectionResult(здравейте, bg, 1.0, true, true)
print(res.object!.first.scores);
// {fr: 1.0}

分句

分句功能如下：

final res = await breakSentence(
    [
        'How are you? I am fine. What did you do today?',
        '¿hola, cómo estás? ¿Donde está la biblioteca?',
    ],
    key: key,
    region: region,
);
print(res.object!.join('\n'));
// BrokenSentence([How are you? , I am fine. ,What did you do today?])
// BrokenSentence([¿hola, cómo estás? ,¿Donde está la biblioteca?])

错误处理

错误处理在该包中都是通过结果类模式完成的。 如果HTTP出现问题（例如没有连接），则会抛出异常。 具体来说，它使用了来自 elegent 包的结果类.

final langs = await languages();
final Result<LanguageList, AzureTranslationError> res = await languages();
if (res.ok) {
    final LanguageList languageList = res.object!;
    print('Success! Language list: $languageList');
} else {
    final AzureTranslationError error = res.error!;
    print('Error! $error');
}

示例代码

要运行这些示例，需要在执行目录下创建一个 .env 文件。 .env 应该包含以下变量：

AZURE_KEY=YOUR_AZURE_KEY
AZURE_REGION=YOUR_AZURE_REGION

翻译示例

import 'package:azure_translation/azure_translation.dart' as at;

void main() async {
  final res = await at.translate(
      ['hello world', 'banana', 'bonjour'],
      baseLanguage: 'en', // 可选
      languages: ['fr', 'zh-Hans', 'ru'],
      key: 'YOUR_AZURE_KEY',
      region: 'YOUR_AZURE_REGION',
  );

  print(res.object!.join('\n'));
  // 输出:
  // hello world: [vi: Chào thế giới, zh-Hans: 世界您好, ru: Всем привет]
  // banana: [vi: chuối, zh-Hans: 香蕉, ru: банан]
  // bonjour: [vi: Xin chào, zh-Hans: 你好, ru: Привет]
}

转写示例

import 'package:azure_translation/azure_translation.dart' as at;

void main() async {
  final res = await at.transliterate(
      ['konnichiwa', 'arigato', 'sayounara'],
      key: 'YOUR_AZURE_KEY',
      region: 'YOUR_AZURE_REGION',
      language: 'ja',
      fromScript: 'Latn',
      toScript: 'Jpan',
  );

  print(res.object!);
  // 输出:
  // konnichiwa: こんにちわ
  // arigato: ありがと
  // sayounara: さようなら
}

语言检测示例

import 'package:azure_translation/azure_translation.dart' as at;

void main() async {
  final res = await at.detect(
      ['bonjour', 'hola', 'здравейте'],
      key: 'YOUR_AZURE_KEY',
      region: 'YOUR_AZURE_REGION',
  );

  print(res.object!.join('\n'));
  // 输出:
  // detectionResult(bonjour, fr, 1.0, true, false)
  // detectionResult(hola, es, 1.0, true, false
  // detectionResult(здравейте, bg, 1.0, true, true)

  print(res.object!.first.scores);
  // 输出:
  // {fr: 1.0}
}

分句示例

import 'package:azure_translation/azure_translation.dart' as at;

void main() async {
  final res = await at.breakSentence(
      [
          'How are you? I am fine. What did you do today?',
          '¿hola, cómo estás? ¿Donde está la biblioteca?',
      ],
      key: 'YOUR_AZURE_KEY',
      region: 'YOUR_AZURE_REGION',
  );

  print(res.object!.join('\n'));
  // 输出:
  // brokenSentence([ How are you? ,I am fine. ,What did you do today?])
  // brokenSentence([¿hola, cómo estás? ,¿Donde está la biblioteca?])
}