語音翻譯 (Android Translator)

這是一款專為 Android 平台設計的 離線雙引擎語音翻譯 App。 結合了極速輕巧的 Google ML Kit 神經網路翻譯，以及支援硬體加速的強大裝置端大語言模型 (On-Device LLMs)，帶給使用者「無網路也能精準對談」的流暢體驗。

🌟 核心特色 (Key Features)

1. 創新的雙大腦翻譯架構 (Dual-Engine Translation)

本應用同時擁有以下三種翻譯引擎，可視硬體資源自由發揮：

• ⚡️ ML Kit (預設)：超輕量、零延遲的毫秒級離線翻譯，特別適合旅行、日常短句。
• 🧠 Nano (AICore)：無縫接軌 Android 旗艦機 (如 Pixel系列) 專有的原生系統級模型 Google Gemini Nano，無須手動下載檔案。
• 🚀 Gemma (MediaPipe)：支援利用本地 GPU 推理的高效能大型語言模型。只要把名為 gemma*.bin 或 *.task 的大模型檔案放進手機 Download/ 區，App 即刻智慧掛載並設為預設翻譯核。

亮點功能：強制繁體中文輸出 為了克服開源 LLM 常輸出簡體字的缺點，底層配備了強勢 Prompt Engineering。只要目標語系是「中文」，雙語模型都會精準為您生成正體中文 (繁體字)。

2. 極簡化的面對面交談 (Two-Way Dual Mic)

取消了繁瑣的「反轉/切換」按鈕，直接將畫面區分為原始方與目標方：

• 直接講話：對方是越南人，對方只要按他專屬的藍色麥克風按鈕說話；您是台灣人，只要點擊您的橘色麥克風說話。
• 即時記錄：支援 Line 式流暢對話氣泡，完美還原交流脈絡。並且支援一鍵清除與單獨刪除防呆設計。

3. 多語言與國際化介面支援 (I18N Support)

內建英文、繁體中文與越南文介面切換功能，更原生整合了 zh-TW, en-US, vi-VN 離線語音識別包，就算完全拔除網路也能暢手通話。

🛠 系統架構與技術棧

• Frontend & App Logic: React Native (Expo)
• Native Implementation: Kotlin (客製化 Expo Modules)
• Speech Recognition: iOS / Android 原生語音框架 (Expo Speech Recognition)
• Offline ML Engine: com.google.mlkit:translate
• Device LLMs:
  • com.google.mlkit:genai-prompt (Gemini Nano via AICore)
  • com.google.mediapipe:tasks-genai (Gemma 2B)

🚀 本地開發指南

1. 安裝環境與依賴

   npm install

2. Android 編譯與執行 由於深度整合了大量的神經網路原生 Kotlin SDK，請務必使用 Prebuild 產生 App：

   npx expo prebuild --clean
   cd android && ./gradlew assembleRelease

   編譯好的 APK 會存放於 /android/app/build/outputs/apk/release/app-release.apk

📁 關於模型資料要求

若您想要體驗 Gemma，請將符合 MediaPipe 格式的模型 (如 gemma-4-E2B-it.bin) 放置於 Android 手機的 Download 公共資料夾下。本專案寫有自動模糊掃描防護機制，只要檔名包含 gemma 且可讀取，引擎便會自動為您亮起。

---

Developed with ❤️