# Mimi 安卓版

把手机正在播放的声音转成悬浮字幕，支持双语、仅译文或仅原文。

[English](README.md) · [简体中文](README.zh-CN.md) · [项目首页](../README.md)

<a id="start"></a>

## 安装与使用

1. **安装应用**：在[下载页](https://github.com/yuxino/mimi/releases/latest)选择 `.apk` 文件，下载后在 Android 10 或更新系统上安装。
2. **配置服务**：打开「服务」，添加一个语音服务，填写密钥等信息后保存。首次添加的配置会自动选中；服务选择和密钥获取方法见[配置指南](../docs/provider-setup.zh-CN.md#choose)。
3. **开启字幕**：在「字幕」中选择识别语言和翻译语言，点击开始。按提示允许悬浮窗、录音及系统音频捕获权限。
4. **播放内容**：切换到视频、直播等应用，播放含有人声的内容。字幕会悬浮显示；开启沉浸模式后，触摸操作可穿过字幕。

Mimi 本身免费，云服务可能收费。云端识别会接收采集的音频，远程文字翻译会接收识别文字。安卓服务配置需单独填写，不会从电脑版自动同步。

## 使用提示

- **音源**：安卓版采集其他应用的播放声音，不使用麦克风。Android 的录音权限也是播放声音采集所必需的。
- **没有字幕**：先确认已开启字幕、选中有效的服务配置，且内容中有人声。部分应用禁止音频采集，受保护内容可能无法识别。重新开始时需再次同意系统捕获提示。
- **字幕显示**：可调整字号、颜色、位置和显示模式。打开 Mimi 自身页面时，悬浮字幕会暂时隐藏，识别仍会继续；离开后恢复。
- **保留字幕**：新安装默认保留最近 3 句已确认字幕，已有用户保持原设置。可调整保留数量；停止后清空，不会保存为字幕文件。
- **服务范围**：支持阿里云、OpenAI、Gemini、Azure、火山引擎、腾讯云、百度和 xAI。安卓不支持 Apple 本地服务或自定义语音识别。

遇到问题可[提交反馈](https://github.com/yuxino/mimi/issues)，请附上手机系统版本、使用的服务和具体操作，不要公开密钥或私密字幕。开发与构建说明见[英文技术文档](README.md)。