SDK v3.2.0 · 已发布

为你的App嵌入翻译能力
多平台SDK，一行代码接入

覆盖Flutter、React Native、iOS原生和Android原生的翻译SDK套件。支持离线翻译引擎、OCR文字识别、语音流式翻译三大核心能力，全部通过统一的API暴露给开发者。SDK包体积控制在4MB以内，不会拖累你的App启动速度。

快速开始浏览文档

// Flutter 集成示例 import 'package:traneasy_sdk/traneasy_sdk.dart'; void main() { WidgetsFlutterBinding.ensureInitialized(); await TraneasySDK.initialize( 'YOUR_API_KEY', offlineLanguages: ['en', 'ja', 'ko'], ); // 翻译一段文字 final result = await TraneasySDK.translate( text: '你好，世界', from: 'zh', to: 'en', ); print(result.translated); // Hello, world }

跨平台SDK套件

统一的API设计，在不同框架下保持一致的开发体验

🔨

TranEasy Flutter SDK

Dart原生实现，支持Flutter 3.x及以上版本。提供Widget级别的翻译组件，可直接嵌入页面树，适配Material Design 3。

v3.2.0 · pub.dev

⚡

TranEasy React Native SDK

基于原生桥接的RN模块，TypeScript类型定义完整。支持新架构（Fabric/TurboModules），也兼容旧版Bridge模式。

v3.1.2 · npm

🍎

TranEasy iOS SDK

Swift 5.9编写，支持SPM和CocoaPods分发。利用Core ML加速端侧推理，iOS 14以上可用。Combine + async/await双模式。

v3.2.0 · SPM

🦼

TranEasy Android SDK

Kotlin优先，协程+Flow异步架构。利用NNAPI硬件加速，兼容Android 8.0+。支持AAR直接集成和Maven Central分发。

v3.2.0 · Maven

🌊

TranEasy HarmonyOS SDK

ArkTS原生实现，支持HarmonyOS 3.0及以上。集成华为HiAI Foundation加速推理，API-version 9+可用。

v1.5.0 · 华为市场

🔌

TranEasy C++ Core

跨平台底层引擎，所有上层SDK的共享核心。基于ONNX Runtime的推理引擎，支持量化模型部署，内存占用极低。

v4.0.1 · CMake

平台集成指南

针对每个平台的最佳实践和代码示例

🍎 iOS 原生集成

通过Swift Package Manager引入，配置Info.plist添加NSCameraUsageDescription权限即可启用拍照翻译。推荐在AppDelegate中预热引擎。

// Package.swift
dependencies: [
    .package(
        url: "https://github.com/traneasy/ios-sdk",
        from: "3.2.0"
    )
]
                

🦼 Android 原生集成

在build.gradle中添加Maven依赖，AndroidManifest声明INTERNET权限。建议在Application.onCreate中调用TranEasySDK.warmUp()预热模型。

// build.gradle.kts
dependencies {
    implementation("com.traneasy:android-sdk:3.2.0")
}
                

🌊 HarmonyOS 适配

在oh-package.json5中声明依赖，module.json5中配置ohos.permission.INTERNET权限。支持Stage模型和FA模型双模式。

// oh-package.json5
{
  "dependencies": {
    "@traneasy/harmony-sdk": "^1.5.0"
  }
}
                

🔨 Flutter 跨平台

pubspec.yaml添加依赖后，平台通道自动注册。Android端minSdkVersion设为21，iOS部署目标14.0。使用TranEasyWidget组件一行搞定。

// pubspec.yaml
dependencies:
  traneasy_sdk: ^3.2.0
                

UI组件展示

内置精美组件，几行代码拼出专业翻译界面

💬

对话气泡组件

ConversationBubble自动识别说话方向，支持左右分栏布局，内置打字机动画效果。

🎥

相机扫描组件

CameraScanner封装了AVCaptureSession/CameraX，实时预览画面中叠加翻译结果文字层。

🔈

语音按钮组件

VoiceButton按住录音松手翻译，带波形动画和音量指示器，集成ASR引擎自动断句。

📜

语言选择器

LanguagePicker采用分段控制器设计，支持最近使用和收藏语言，搜索过滤响应即时。

📄

翻译结果卡片

TranslateCard支持原文/译文对照显示，一键复制、朗读、收藏，长按反馈翻译质量。

⏱

加载状态指示

LoadingIndicator提供骨架屏和进度环两种样式，支持深色浅色主题自适应切换。

快速上手

从零到翻译功能上线，只需四步

注册获取API Key

访问易翻译开发者控制台注册账号，创建应用后获取专属API Key。免费额度每月10万字符翻译量，足够开发和测试使用。企业用户可在线申请扩容，审核通常在2小时内完成。

安装对应平台SDK

根据你的技术栈选择Flutter、React Native或原生SDK。以Flutter为例，在pubspec.yaml添加traneasy_sdk依赖后执行flutter pub get，30秒内即可完成安装。各平台的安装命令我们在文档里都列好了，直接复制粘贴就行。

初始化引擎

在App启动时调用初始化方法，传入API Key并配置所需语言。如果要用离线翻译，这一步会触发语言包下载——建议在Wi-Fi环境下且用后台任务执行，避免阻塞用户操作。引擎初始化通常在200ms内完成。

调用翻译API

一行代码就能完成翻译，支持回调、Future/Promise和协程三种异步模式。SDK自动处理网络重试、超时降级和离线切换，你不需要关心这些底层细节。调用translate()、scanImage()或startConversation()即可实现三种核心翻译模式。

常见问题

SDK集成过程中开发者最常问到的问题

SDK的付费模式是怎样的？

SDK本身免费集成，按API调用量计费。每月前10万字符翻译免费，超出部分每100万字符收费15元。离线翻译功能不产生API调用费用，语言包下载也免费。企业版包含SLA保障和专属技术支持，年费根据调用量阶梯定价，5万字符/秒以下年费9800元起。

离线翻译模型如何更新？

模型文件随SDK版本一起分发，我们大约每季度发布一次模型更新。调用SDK的checkModelUpdate()方法可以查询是否有新版本可用。模型下载支持断点续传，单个语言包的更新通常在40-80MB之间。如果不想自动更新，可以锁定模型版本号，只在App发版时手动升级。

SDK对App包体积的影响有多大？

基础SDK（不含离线模型）在各平台的增量体积：iOS约3.2MB，Android约2.8MB，Flutter约3.5MB，React Native约3.0MB。离线模型文件按需下载，不计入安装包。如果确实需要预置模型，我们提供App Bundle/On-Demand Resources方案来避免安装包过大。

支持哪些编程语言和技术栈？

目前正式支持Flutter (Dart)、React Native (TypeScript)、iOS原生 (Swift/ObjC)、Android原生 (Kotlin/Java)和HarmonyOS (ArkTS)五个平台。底层C++核心引擎也可以独立集成到任意C/C++项目中。Unity、Unreal和Cordova的封装包正在开发中，预计下个季度发布Beta版。

如何处理网络不稳定导致的翻译失败？

SDK内置了三级降级策略：在线API超时后自动切到离线引擎，离线引擎不可用则返回错误码让App层决定展示方式。你还可以提前调用preloadOfflineModels()确保离线模型已就绪，这样即使完全没有网络也能正常翻译。重试策略采用指数退避，默认最多重试3次。

SDK的线程安全性如何？

所有公共API都是线程安全的，可以在任意线程中调用。iOS端内部使用串行队列管理GPU推理任务，Android端通过Kotlin协程的Dispatchers.Default调度离线翻译。同时发起多个翻译请求时，引擎内部维护了一个优先级队列，确保UI线程的翻译请求总是最先得到响应。

遇到问题怎么获取技术支持？

推荐先在GitHub Discussions提问，我们的工程师会在24小时内回复。付费企业用户可以走专属工单系统，响应时间SLA为4小时。紧急问题也可以通过邮件联系dev-support@traneasy.com。技术文档中每个API都有可运行的示例代码，很多常见问题在示例里就已经覆盖了。

为你的App嵌入翻译能力多平台SDK，一行代码接入