14 changed files with 312 additions and 45 deletions
@ -0,0 +1,170 @@ |
|||
import 'dart:convert'; |
|||
|
|||
import 'package:get/get.dart'; |
|||
import 'package:http/http.dart' as http; |
|||
|
|||
import '../../core/utils/logger.dart'; |
|||
import '../../data/models/appconfig.dart'; |
|||
import 'language_configs/azure_language_config.dart'; |
|||
import 'language_manager.dart'; |
|||
|
|||
/// 微软 Azure Translator REST 翻译服务 |
|||
/// 端点：https://api.cognitive.microsofttranslator.com |
|||
/// 文档：https://learn.microsoft.com/azure/ai-services/translator/reference/v3-0-translate |
|||
class MicrosoftTranslationService extends GetxService { |
|||
static const String _defaultEndpoint = |
|||
'https://api.cognitive.microsofttranslator.com'; |
|||
static const String _apiPath = '/translate'; |
|||
static const String _apiVersion = '3.0'; |
|||
|
|||
late final String _subscriptionKey; |
|||
late final String _region; |
|||
late final String _endpoint; |
|||
|
|||
bool _isInitialized = false; |
|||
bool get isInitialized => _isInitialized; |
|||
|
|||
final LanguageManager _languageManager = Get.find<LanguageManager>(); |
|||
|
|||
/// shortCode -> 微软 translationCode 缓存（由 getAzureTranslationLanguageSpecs 构建） |
|||
final Map<String, String> _shortCodeToTranslationCode = {}; |
|||
|
|||
@override |
|||
Future<void> onInit() async { |
|||
await initialize(); |
|||
super.onInit(); |
|||
} |
|||
|
|||
Future<bool> initialize() async { |
|||
if (_isInitialized) return true; |
|||
try { |
|||
_subscriptionKey = AppConfig.env('AZURE_TRANSLATION_KEY') ?? ''; |
|||
_region = AppConfig.env('AZURE_TRANSLATION_REGION') ?? ''; |
|||
_endpoint = |
|||
AppConfig.env('AZURE_TRANSLATION_ENDPOINT') ?? _defaultEndpoint; |
|||
|
|||
if (_subscriptionKey.isEmpty) { |
|||
print( |
|||
'🟢[MS-TRANS-DBG] AZURE_TRANSLATION_KEY 未配置，服务无法初始化'); |
|||
Logger.error('微软翻译服务初始化失败：AZURE_TRANSLATION_KEY 为空'); |
|||
return false; |
|||
} |
|||
|
|||
for (final spec in getAzureTranslationLanguageSpecs()) { |
|||
final short = spec['shortCode']; |
|||
final code = spec['translationCode']; |
|||
if (short != null && code != null) { |
|||
_shortCodeToTranslationCode[short] = code; |
|||
} |
|||
} |
|||
|
|||
_isInitialized = true; |
|||
print( |
|||
'🟢[MS-TRANS-DBG] 微软翻译服务初始化成功: endpoint=$_endpoint, region=$_region, keyLen=${_subscriptionKey.length}, specCount=${_shortCodeToTranslationCode.length}'); |
|||
Logger.info('微软翻译服务初始化成功 region=$_region'); |
|||
return true; |
|||
} catch (e) { |
|||
print('🟢[MS-TRANS-DBG] 微软翻译服务初始化异常: $e'); |
|||
Logger.error('微软翻译服务初始化异常: $e'); |
|||
return false; |
|||
} |
|||
} |
|||
|
|||
/// 把 ASR 代码（如 `zh-CN`）映射为微软 Translator 语言码（如 `zh-Hans`） |
|||
/// 找不到返回 null |
|||
String? _toTranslationCode(String asrCode) { |
|||
if (asrCode.isEmpty) return null; |
|||
final short = _languageManager.getShortCodeByAsrCode(asrCode); |
|||
if (short == null) return null; |
|||
return _shortCodeToTranslationCode[short]; |
|||
} |
|||
|
|||
/// 文本翻译 |
|||
/// [text] 待翻译文本 |
|||
/// [sourceLanguageCode] 源语言 ASR 码（传空串则让微软自动检测） |
|||
/// [targetLanguageCode] 目标语言 ASR 码 |
|||
Future<String?> translateText({ |
|||
required String text, |
|||
required String sourceLanguageCode, |
|||
required String targetLanguageCode, |
|||
}) async { |
|||
if (!_isInitialized) { |
|||
print('🟢[MS-TRANS-DBG] 未初始化，返回 null'); |
|||
Logger.error('微软翻译服务未初始化'); |
|||
return null; |
|||
} |
|||
if (text.isEmpty) return null; |
|||
|
|||
try { |
|||
final String? targetCode = _toTranslationCode(targetLanguageCode); |
|||
if (targetCode == null) { |
|||
print( |
|||
'🟢[MS-TRANS-DBG] 目标语言码映射失败: targetAsr=$targetLanguageCode，返回 null'); |
|||
Logger.error('微软翻译失败：目标语言 $targetLanguageCode 不在映射表'); |
|||
return null; |
|||
} |
|||
final String? sourceCode = _toTranslationCode(sourceLanguageCode); |
|||
|
|||
final queryParams = <String, String>{ |
|||
'api-version': _apiVersion, |
|||
'to': targetCode, |
|||
}; |
|||
if (sourceCode != null && sourceCode.isNotEmpty) { |
|||
queryParams['from'] = sourceCode; |
|||
} |
|||
|
|||
final uri = Uri.parse('$_endpoint$_apiPath') |
|||
.replace(queryParameters: queryParams); |
|||
final body = json.encode([ |
|||
{'text': text} |
|||
]); |
|||
final headers = { |
|||
'Content-Type': 'application/json', |
|||
'Ocp-Apim-Subscription-Key': _subscriptionKey, |
|||
'Ocp-Apim-Subscription-Region': _region, |
|||
'X-ClientTraceId': _newTraceId(), |
|||
}; |
|||
|
|||
print( |
|||
'🟢[MS-TRANS-DBG] 发起翻译请求: uri=$uri, from=$sourceCode, to=$targetCode, text=$text'); |
|||
final response = |
|||
await http.post(uri, headers: headers, body: body).timeout( |
|||
const Duration(seconds: 10), |
|||
onTimeout: () => http.Response('{"error":"timeout"}', 408), |
|||
); |
|||
print( |
|||
'🟢[MS-TRANS-DBG] 翻译响应: status=${response.statusCode}, bodyLen=${response.body.length}, body=${response.body.length > 500 ? response.body.substring(0, 500) : response.body}'); |
|||
|
|||
if (response.statusCode != 200) { |
|||
Logger.error( |
|||
'微软翻译 HTTP 错误: status=${response.statusCode}, body=${response.body}'); |
|||
return null; |
|||
} |
|||
|
|||
final decoded = json.decode(response.body); |
|||
if (decoded is! List || decoded.isEmpty) { |
|||
print('🟢[MS-TRANS-DBG] 响应非 List 或为空，解析失败'); |
|||
return null; |
|||
} |
|||
final first = decoded.first; |
|||
if (first is! Map) return null; |
|||
final translations = first['translations']; |
|||
if (translations is! List || translations.isEmpty) return null; |
|||
final translated = translations.first; |
|||
if (translated is! Map) return null; |
|||
final result = translated['text']; |
|||
if (result is! String) return null; |
|||
print('🟢[MS-TRANS-DBG] 翻译成功: $result'); |
|||
return result; |
|||
} catch (e, st) { |
|||
print('🟢[MS-TRANS-DBG] 翻译请求异常: $e\n$st'); |
|||
Logger.error('微软翻译请求异常: $e'); |
|||
return null; |
|||
} |
|||
} |
|||
|
|||
String _newTraceId() { |
|||
final now = DateTime.now().microsecondsSinceEpoch; |
|||
return 'ms-trans-$now'; |
|||
} |
|||
} |
|||
Loading…
Reference in new issue