# PlayTranslate

<!-- l10n-header -->
<div align="center">

[English](../README.md) | [简体中文](./README.zh-CN.md) | [繁體中文](./README.zh-HK.md) | [Español](./README.es.md) | [العربية](./README.ar.md) | [Français](./README.fr.md) | [Português (Brasil)](./README.pt-BR.md) | [Русский](./README.ru.md) | [Deutsch](./README.de.md) | [日本語](./README.ja.md) | [Türkçe](./README.tr.md) | Tiếng Việt | [한국어](./README.ko.md) | [ไทย](./README.th.md)

[![Downloads](https://img.shields.io/github/downloads/dominostars/playtranslate/total)](https://github.com/dominostars/playtranslate/releases)
[![Stars](https://img.shields.io/github/stars/dominostars/playtranslate?style=flat)](https://github.com/dominostars/playtranslate/stargazers)
![Android](https://img.shields.io/badge/Android-10%2B-3DDC84?logo=android&logoColor=white)
[![License](https://img.shields.io/github/license/dominostars/playtranslate)](https://github.com/dominostars/playtranslate/blob/main/LICENSE)

</div>
<!-- /l10n-header -->

PlayTranslate là ứng dụng Android giúp bạn dịch theo thời gian thực và học ngoại ngữ, dành cho trò chơi, visual novel, manga và mọi văn bản khác hiển thị trên màn hình. Ứng dụng hỗ trợ 26 ngôn ngữ trò chơi và 59 ngôn ngữ dịch!

[Nhấn vào đây để tải bản phát hành mới nhất](https://github.com/dominostars/playtranslate/releases/latest)

Để báo lỗi, nhận trợ giúp hoặc gửi yêu cầu, hãy tham gia [máy chủ Discord](https://discord.gg/DVCj6p7MUC)

[PlayTranslate với Persona 3 Reload](https://github.com/user-attachments/assets/e89c2c6e-92f3-41d2-8e51-5483beaca612)

## Tính năng

- **Dịch chỉ với một lần nhấn**: Chụp màn hình trò chơi và dịch ngay văn bản trên đó
- **Chế độ tự động dịch**: Bản dịch tự cập nhật mỗi khi lời thoại thay đổi, bạn không cần nhấn gì cả
- **Tra cứu từ**: Đưa kính lúp nổi lên bất kỳ từ nào để xem ngay định nghĩa trong từ điển
- **Ngoại tuyến**: OCR và tra cứu từ điển vẫn hoạt động khi không có kết nối Internet, và bạn có thể tải thêm mô hình dịch ngoại tuyến nếu muốn
- **Chế độ furigana và pinyin**: Hiện cách đọc ngay phía trên các chữ theo thời gian thực
- **Phím tắt**: Gán một phím vật lý để xem trước bản dịch hoặc furigana khi giữ phím, rất tiện cho máy chơi game cầm tay có nút bấm riêng
- **Màn hình kép và chia đôi màn hình**: Dùng được trên cả hai màn hình của thiết bị màn hình kép như Ayn Thor, hoặc ở chế độ chia đôi màn hình của Android, cạnh trò chơi đang chạy trong cửa sổ
- **Vùng chụp**: Chỉ chụp riêng khung thoại, phụ đề hoặc bất kỳ khu vực nào bạn tự chọn
- **Chuyển văn bản thành giọng nói**: Nghe văn bản được đọc to. Bạn có thể đổi giọng nói mặc định trong phần cài đặt
- **Xuất sang Anki**: Lưu câu vào AnkiDroid kèm văn bản gốc, bản dịch, danh sách từ, từ mục tiêu, âm thanh chuyển văn bản thành giọng nói và ảnh chụp màn hình. Bạn còn có thể ghi lại âm thanh trò chơi và đưa vào thẻ! Có thể chọn loại thẻ, kèm các mẫu thiết lập sẵn cho những bộ thẻ phổ biến.
- **Tích hợp Yomitan**: Từ điển Yomitan được tích hợp liền mạch, gồm trọng âm cao độ, nhãn tần suất, thông tin kanji mở rộng và định nghĩa từ được gộp lại, hiển thị ở mọi nơi (kể cả Anki). Trong tương lai, Yomitan sẽ còn được tích hợp sâu hơn nữa
- **Dịch bằng máy ảnh**: Hướng máy ảnh vào văn bản ngoài đời thực để đọc bản dịch trực tiếp, hoặc chụp ảnh tĩnh để nhấn vào từng từ và tra cứu.
- **Lịch sử văn bản**: Lưu lại bản ghi các câu đã chụp. Mặc định tắt.

## Cách cài đặt

1. [Nhấn vào đây để tải bản phát hành mới nhất](https://github.com/dominostars/playtranslate/releases/latest)
2. Trên thiết bị Android, hãy cho phép trình duyệt hoặc trình quản lý tệp cài ứng dụng không rõ nguồn gốc: mở **Cài đặt → Ứng dụng → Quyền truy cập đặc biệt của ứng dụng → Cài đặt ứng dụng không rõ nguồn gốc**, chọn trình duyệt hoặc trình quản lý tệp đó rồi bật **Cho phép từ nguồn này**. Khi bạn mở tệp APK lần đầu, Android cũng sẽ đề nghị đưa bạn đến thẳng màn hình này
3. Mở tệp APK rồi nhấn nút **Cài đặt**
4. Khi mở ứng dụng lần đầu, hãy làm theo các bước hướng dẫn để cấp những quyền cần thiết

### Không cài đặt được?

Trên một số thiết bị Android, **Google Play Protect** chặn các tệp APK cài từ bên ngoài Cửa hàng Play và hiện một cảnh báo chung chung như “Ứng dụng chưa được cài đặt” hoặc “Đã phát hiện ứng dụng độc hại”. Nếu gặp trường hợp này, hãy tạm thời tắt tính năng quét:

1. Mở **Cửa hàng Play**
2. Nhấn vào **biểu tượng hồ sơ** (góc trên bên phải)
3. Nhấn vào **Play Protect**
4. Nhấn vào **biểu tượng bánh răng** (góc trên bên phải)
5. Tắt **Quét ứng dụng bằng Play Protect**

Cài tệp APK xong, hãy bật lại Play Protect để tính năng này tiếp tục quét các ứng dụng khác của bạn.

### Không bật được Hỗ trợ tiếp cận?

Một vài tính năng nâng cao (như giữ phím tắt để xem trước) sẽ yêu cầu bạn bật quyền Hỗ trợ tiếp cận. Từ Android 13 trở lên, Android làm mờ nút chuyển Hỗ trợ tiếp cận của mọi ứng dụng được cài từ tệp APK tải xuống, và khi bạn nhấn vào nút này, thông báo “Chế độ cài đặt bị hạn chế” sẽ hiện ra. Để bỏ chặn:

1. Trong **Cài đặt → Hỗ trợ tiếp cận**, chọn PlayTranslate rồi nhấn vào nút chuyển bị mờ một lần. Đóng thông báo “Chế độ cài đặt bị hạn chế”.
2. Mở trang Thông tin ứng dụng: **Cài đặt → Ứng dụng → PlayTranslate**.
3. Nhấn vào menu **⋮** rồi chọn **Cho phép các chế độ cài đặt bị hạn chế**. Mục này chỉ xuất hiện sau bước 1.
4. Xác thực nếu được yêu cầu, sau đó quay lại Hỗ trợ tiếp cận và bật nút chuyển.

## Trợ giúp và ủng hộ

Để báo lỗi, nhận trợ giúp hoặc gửi yêu cầu, hãy tham gia [máy chủ Discord](https://discord.gg/DVCj6p7MUC)

Bạn có thể ủng hộ PlayTranslate trên Ko-fi tại https://ko-fi.com/playtranslate

## Ngôn ngữ được hỗ trợ

PlayTranslate dịch từ **26 ngôn ngữ trò chơi** (ngôn ngữ của văn bản mà ứng dụng đọc được trên màn hình) sang **59 ngôn ngữ dịch** (ngôn ngữ hiển thị cho bạn). Cả hai bảng đều được sắp xếp theo tổng số người nói trên toàn thế giới.

### Ngôn ngữ trò chơi (đọc từ màn hình)

| Ngôn ngữ               | Tên bản địa      | Mã      |
|------------------------|------------------|---------|
| Tiếng Anh              | English          | en      |
| Tiếng Trung (Giản thể) | 简体中文             | zh      |
| Tiếng Trung (Phồn thể) | 繁體中文             | zh-Hant |
| Tiếng Hindi            | हिन्दी           | hi      |
| Tiếng Tây Ban Nha      | Español          | es      |
| Tiếng Ả Rập            | العربية          | ar      |
| Tiếng Pháp             | Français         | fr      |
| Tiếng Bồ Đào Nha       | Português        | pt      |
| Tiếng Nga              | Русский          | ru      |
| Tiếng Indonesia        | Bahasa Indonesia | id      |
| Tiếng Đức              | Deutsch          | de      |
| Tiếng Nhật             | 日本語              | ja      |
| Tiếng Thổ Nhĩ Kỳ       | Türkçe           | tr      |
| Tiếng Việt             | Tiếng Việt       | vi      |
| Tiếng Hàn              | 한국어              | ko      |
| Tiếng Italy            | Italiano         | it      |
| Tiếng Thái             | ไทย              | th      |
| Tiếng Hà Lan           | Nederlands       | nl      |
| Tiếng Romania          | Română           | ro      |
| Tiếng Hungary          | Magyar           | hu      |
| Tiếng Thụy Điển        | Svenska          | sv      |
| Tiếng Catalan          | Català           | ca      |
| Tiếng Đan Mạch         | Dansk            | da      |
| Tiếng Phần Lan         | Suomi            | fi      |
| Tiếng Na Uy            | Norsk            | no      |
| Tiếng Ba Lan           | Polski           | pl      |

### Ngôn ngữ dịch (bản dịch dành cho bạn)

| Ngôn ngữ               | Tên bản địa      | Mã   |
|------------------------|------------------|------|
| Tiếng Anh              | English          | en   |
| Tiếng Trung            | 中文               | zh   |
| Tiếng Hindi            | हिन्दी           | hi   |
| Tiếng Tây Ban Nha      | Español          | es   |
| Tiếng Ả Rập            | العربية          | ar   |
| Tiếng Pháp             | Français         | fr   |
| Tiếng Bangla           | বাংলা            | bn   |
| Tiếng Bồ Đào Nha       | Português        | pt   |
| Tiếng Nga              | Русский          | ru   |
| Tiếng Urdu             | اردو             | ur   |
| Tiếng Indonesia        | Bahasa Indonesia | id   |
| Tiếng Swahili          | Kiswahili        | sw   |
| Tiếng Đức              | Deutsch          | de   |
| Tiếng Nhật             | 日本語              | ja   |
| Tiếng Marathi          | मराठी            | mr   |
| Tiếng Telugu           | తెలుగు           | te   |
| Tiếng Thổ Nhĩ Kỳ       | Türkçe           | tr   |
| Tiếng Việt             | Tiếng Việt       | vi   |
| Tiếng Hàn              | 한국어              | ko   |
| Tiếng Tamil            | தமிழ்            | ta   |
| Tiếng Ba Tư            | فارسی            | fa   |
| Tiếng Italy            | Italiano         | it   |
| Tiếng Thái             | ไทย              | th   |
| Tiếng Gujarati         | ગુજરાતી          | gu   |
| Tiếng Ba Lan           | Polski           | pl   |
| Tiếng Ukraina          | Українська       | uk   |
| Tiếng Tagalog          | Tagalog          | tl   |
| Tiếng Mã Lai           | Bahasa Melayu    | ms   |
| Tiếng Kannada          | ಕನ್ನಡ            | kn   |
| Tiếng Hà Lan           | Nederlands       | nl   |
| Tiếng Romania          | Română           | ro   |
| Tiếng Hungary          | Magyar           | hu   |
| Tiếng Hy Lạp           | Ελληνικά         | el   |
| Tiếng Séc              | Čeština          | cs   |
| Tiếng Thụy Điển        | Svenska          | sv   |
| Tiếng Belarus          | Беларуская       | be   |
| Tiếng Do Thái          | עברית            | he   |
| Tiếng Bulgaria         | Български        | bg   |
| Tiếng Catalan          | Català           | ca   |
| Tiếng Slovak           | Slovenčina       | sk   |
| Tiếng Haiti            | Kreyòl Ayisyen   | ht   |
| Tiếng Croatia          | Hrvatski         | hr   |
| Tiếng Đan Mạch         | Dansk            | da   |
| Tiếng Phần Lan         | Suomi            | fi   |
| Tiếng Na Uy            | Norsk            | no   |
| Tiếng Albania          | Shqip            | sq   |
| Tiếng Galician         | Galego           | gl   |
| Tiếng Slovenia         | Slovenščina      | sl   |
| Tiếng Litva            | Lietuvių         | lt   |
| Tiếng Latvia           | Latviešu         | lv   |
| Tiếng Hà Lan (Nam Phi) | Afrikaans        | af   |
| Tiếng Macedonia        | Македонски       | mk   |
| Tiếng Estonia          | Eesti            | et   |
| Tiếng Georgia          | ქართული          | ka   |
| Tiếng Wales            | Cymraeg          | cy   |
| Tiếng Malta            | Malti            | mt   |
| Tiếng Iceland          | Íslenska         | is   |
| Tiếng Ireland          | Gaeilge          | ga   |
| Tiếng Quốc Tế Ngữ      | Esperanto        | eo   |

## Dịch vụ dịch thuật trực tuyến (tùy chọn)

Theo mặc định, PlayTranslate dịch bằng [Lingva](https://github.com/thedaviddelta/lingva-translate), còn ML Kit là công cụ dịch ngoại tuyến được dùng dự phòng khi bản dịch trực tuyến không khả dụng. Để có bản dịch chất lượng cao hơn, bạn có thể thêm bất kỳ dịch vụ nào dưới đây trong **Cài đặt → Dịch vụ dịch thuật**. Bạn có thể thêm bao nhiêu dịch vụ tùy thích. Mỗi dịch vụ là một mục riêng trong danh sách, nên bạn có thể thiết lập sẵn nhiều dịch vụ và sắp xếp lại thứ tự để chọn dịch vụ nào dịch trước:

- **DeepL**: Gói miễn phí tại [deepl.com/en/pro#developer](https://www.deepl.com/en/pro#developer)
- **OpenAI**: [platform.openai.com](https://platform.openai.com/api-keys), chọn mô hình ngay trong ứng dụng
- **Gemini**: [aistudio.google.com](https://aistudio.google.com/app/apikey), chọn mô hình ngay trong ứng dụng
- **DeepSeek**: [platform.deepseek.com](https://platform.deepseek.com/api_keys), chọn mô hình ngay trong ứng dụng
- **Mistral**: [console.mistral.ai](https://console.mistral.ai/api-keys), chọn mô hình ngay trong ứng dụng
- **Groq**: [console.groq.com](https://console.groq.com/keys), chọn mô hình ngay trong ứng dụng
- **OpenRouter**: [openrouter.ai](https://openrouter.ai/keys), chọn mô hình ngay trong ứng dụng
- **Claude**: [platform.claude.com](https://platform.claude.com/settings/keys), chọn mô hình ngay trong ứng dụng
- **Bilibili Index-Translate**: [index-translate.bilibili.com](https://index-translate.bilibili.com/), miễn phí, không cần khóa API
- **Tùy chỉnh**: Bất kỳ máy chủ nào khác tương thích với OpenAI; hãy nhập URL máy chủ của bạn vào ô “URL tùy chỉnh”

## Thẻ ghi nhớ Anki (tùy chọn)

Hãy cài [AnkiDroid](https://play.google.com/store/apps/details?id=com.ichi2.anki), sau đó cấp cho PlayTranslate quyền truy cập AnkiDroid trong phần Cài đặt để xuất thẻ thẳng vào các bộ thẻ của bạn.

## Ghi công và giấy phép

Danh sách ghi công cho các thư viện, mô hình và dữ liệu ngôn ngữ học mà PlayTranslate sử dụng nằm trong [phần Credits của README tiếng Anh](https://github.com/dominostars/playtranslate#credits). PlayTranslate được phát hành theo giấy phép [GPL 3.0](https://github.com/dominostars/playtranslate/blob/main/LICENSE).