企业官网建设流程全解析

PlayTranslate 是一款面向 Android 的实时翻译与语言学习应用，专为游戏、视觉小说、漫画等屏幕文字而生。它的振假名（Furigana）/拼音（Pinyin）模式可以在游戏画面的汉字上方实时显示读音提示——日语原文自动标注平假名注音，中文原文自动标注拼音，帮助你在玩游戏的同时自然积累日语、中文的词汇与读音。本文是一份面向新手的完整教程，带你 3 步开启模式，并掌握快捷键预览、OCR 过滤等进阶技巧。

一、振假名/拼音模式是什么？

📖原理一句话：应用持续截取游戏画面 → OCR 识别文字 → 调用内置语言引擎注音 → 把读音"浮"在原文字符上方。

在源码中，这一机制由 Language.kt 中的HintTextKind枚举统一定义：日语映射为FURIGANA，中文（含繁体）映射为PINYIN。

• 日语注音引擎：JapaneseEngine.kt，基于词典 + 动词变形还原给出词干读音
• 中文注音引擎：ChineseEngine.kt，使用 HanLP 分词并针对多音字结合上下文消歧，避免拼音标错

💡 亮点：中文模式不是简单逐字注音，而是词级注音 + 多音字上下文消歧，"重庆/重量"这类词也能读对。

二、开启步骤：3 步上手振假名实时注音

步骤 1：把"源语言"设为日语或中文

打开应用主界面，先设置：

1. 源语言（Source）：选择ja（日语）或zh（中文）——这是 OCR 要读取的游戏文字语言
2. 目标语言（Target）：选择你自己的母语，用于面板翻译

只有源语言是日语/中文时，"Overlay Mode"选项里才会出现振假名/拼音选项。

步骤 2：把 Overlay Mode 切换为 Furigana 或 Pinyin

进入捕获/覆盖设置（Capture & Overlay）页面，找到Overlay Mode（覆盖模式）一行：

• Translation：显示译文（默认）
• Furigana：在汉字上方显示日语振假名
• Pinyin：在汉字上方显示中文拼音

切换后立即生效，游戏画面中的文字会实时"长"出读音。相关界面定义见 activity_capture_overlay_settings.xml，选项文案定义见 strings.xml。

步骤 3：调整捕获间隔，让注音"跟手"

同一设置页中的Capture interval（捕获间隔）决定截图频率。间隔越小，对话切换时注音出现越快，但耗电越高。新手建议：

• 对话节奏慢的文字冒险：1s ~ 1.5s
• 对话节奏快的动作游戏：0.5s ~ 0.8s

底层由 FuriganaMode.kt 的实时循环驱动：每帧 OCR 后只为发生变化的文字组重建注音框，打字机逐字显示台词时也能即时跟上。

三、进阶技巧：快捷键预览与 OCR 过滤

技巧 1：实体按键"长按预览"，掌机党福音

给一个实体键（手柄键/键盘键）绑定长按预览，即可在按住时于游戏画面上临时显示振假名或拼音，松开即消失——不遮挡游戏，随看随读。绑定入口在Hotkeys 设置，按键判定逻辑位于 HotkeyDecision.kt。

此外还支持在悬浮图标上双击切换"译文 ↔ 振假名"（见 strings.xml 中的Swap between translation and furigana），两种学习视角一键互切。

技巧 2：打开"Filter furigana from OCR"

如果游戏本身就在汉字旁印了小号假名，开启Filter furigana from OCR开关后，OCR 会自动丢弃这些原生假名，避免它们被误当成台词翻译或覆盖显示。该开关仅在源语言为日语时出现，实现位于 activity_capture_overlay_settings.xml 的rowFilterFurigana行。

技巧 3：把注音句子存进 Anki

阅读过程中看到好句子，可以直接加入 Anki 卡片，内容支持三种带注音的表达方式：

• Word / headword with furigana：词形 + 逐字注音，如聞[き]く
• Source sentence with furigana：整句 + 逐字注音，如友達[ともだち]に聞[き]いた

卡片内容模板定义见 strings.xml，配合间隔重复复习，把游戏里学到的词真正记住。

四、日语/中文学习工作流建议

🗺️ 推荐一套"边玩边学"的组合拳：

1. 先读后译：Overlay Mode 设为 Furigana/Pinyin，先靠注音读懂原文结构
2. 长按看译文：用快捷键预览确认理解，再松开回到阅读模式
3. 点词查义：把悬浮放大镜移到生词上，即时查看词典释义（日语支持 Yomitan 词典集成，含音高重音、词频标签）
4. 好句入 Anki：一键保存带注音的句子卡片，离线复习

注音的字体、字号与描边绘制统一由 FuriganaMetrics.kt 控制（加粗、字号为文字行高的 70%、3dp 描边），保证在任何游戏背景下都清晰可读；竖排文字的注音倾斜排版则由 FuriganaSlantPlacement.kt 处理。

五、常见问题

Q1：为什么画面上一直没有注音？确认源语言已设为ja或zh，且已下载对应语言包（OCR 与词典均支持离线）。语言目录见 langpack_catalog.json。

Q2：打字机逐字出现台词时，注音会不会闪烁？不会。框架会对"正在揭示"的文字做前沿保持（frontier hold），最后一个词的注音要等帧确认后才释放，避免你看到读音反复修改，逻辑见 FuriganaMode.kt 的GroupPlan规划。

Q3：可以双屏/分屏使用吗？可以。双屏设备（如 Ayn Thor）可在两块屏上各跑一个覆盖层，也能与窗口化游戏分屏使用。

Q4：注音和译文能同时显示吗？在"自动模式"下 Overlay Mode 二选一，但通过快捷键长按预览，可在按住瞬间切换查看另一种模式，兼顾阅读与理解。

六、本文涉及的核心模块

• 实时振假名覆盖循环：FuriganaMode.kt
• 语言 Profile 与注音类型：Language.kt
• 日语/中文注音引擎：JapaneseEngine.kt / ChineseEngine.kt
• 句级注音器：SentenceAnnotator.kt
• 快捷键判定：HotkeyDecision.kt
• 多语言 README（含简体中文版）：README.zh-CN.md

📝 小结：把源语言设为日语或中文，再把 Overlay Mode 切到 Furigana/Pinyin，PlayTranslate 就会在游戏画面上实时"加拼音、标假名"。配合快捷键预览与 Anki 导出，它既是翻译工具，也是一位随身语言学习助手。