App 使用指南
JustPiano 5.0 · Android · 更新于 2026-08-04
从第一次弹奏，到导入自己的曲谱、连接 MIDI 键盘、保存录音，本指南帮助你找到每项操作的入口。
普通弹奏、瀑布流、自由演奏与双键盘。
USB/MIDI 键盘、延音踏板与麦克风音符识别。
曲库、排行、普通房间、键盘协奏与社交。
WAV 录音、聊天记录、账号与成绩数据管理。
1. 运行要求与首次使用
App 支持 Android 8.0（API 26）及以上系统，主要按横屏设计。首次启动时，音源可能需要在后台准备。看到准备提示后，可先浏览首页，等待完成后再开始弹奏。
本地普通弹奏、键盘模式和已下载资源可离线使用。曲库同步、资源下载、账号功能和联网房间需要网络连接。
| 权限或系统能力 | 使用场景 |
|---|---|
| 网络 | 登录、在线曲库、对战、皮肤和音源下载、问题反馈。 |
| 通知 | 联网模式在后台维持连接时显示常驻通知。 |
| 麦克风 | 仅用于自由演奏的真钢琴音符识别；内部弹奏录音不采集环境音。 |
| USB / MIDI | 连接支持 MIDI 的电子琴或键盘，接收力度和延音踏板信号。 |
| 电池与唤醒 | 可选，用于降低联网模式在后台被系统断开的概率。 |
| 安装未知应用 | 仅在 App 内执行版本更新安装时可能需要。 |
2. 首页入口
| 入口 | 功能 |
|---|---|
| 本地弹奏 | 进入普通弹奏、自由演奏或键盘模式。 |
| 联网模式 | 登录后使用在线曲库、对战、排行和社交功能。 |
| 参数设置 | 管理皮肤、音源、MIDI、弹奏、瀑布流、聊天和联网参数。 |
| 皮肤 / 音源下载 | 浏览、下载、应用在线资源，也可以恢复默认设置。 |
| 录音文件 | 播放、导入、分享或删除 WAV 弹奏录音。 |
| 聊天记录 | 按日期和房间查看、搜索、统计、导入、导出或删除记录。 |
| 软件帮助 / 更新日志 | 查看 App 内图片帮助和版本更新内容。 |
| 问题反馈 | 提交崩溃、隐私、功能建议或举报信息。 |
3. 本地弹奏
普通弹奏与本地曲库
打开“首页 → 本地弹奏 → 普通弹奏”，通过分类、曲名搜索、侧边索引或排序找到曲目。选曲时可查看曲目时长、左右手难度和历史最高分，再选择试听、瀑布流或弹奏。
收藏内置曲谱；在用户导入分类中删除导入曲谱。
使用下落音块和钢琴键盘播放当前曲目。
打开播放器，支持暂停、上下曲、收藏和循环模式。
进入音块判定弹奏页面，保存对应左右手最高分。
曲库顶部的常用选项：
- 录音：弹奏开始时启动内部录音，结束时保存 WAV，不包含环境音。
- 左手：选中后由你弹奏左手和弦，App 自动播放右手主旋律；不选时默认弹奏右手。
- 连续：试听结束后按当前列表顺序自动播放下一首。
- 练习：音块到达判断线后自动暂停，等待你弹奏对应音符。
瀑布流与自由演奏
瀑布流以钢琴键盘和下落音块展示曲谱。点击曲名可切换五线谱显示，部分曲谱可能不支持五线谱。在设置中可调整曲谱速度、音块速度、移调、左右手颜色、八度虚线和背景。
选择“自由演奏”后，无需加载固定曲谱；通过触屏或外接设备弹奏，音符会实时形成瀑布流。
使用麦克风识别真钢琴音符时，首次需要授予录音权限，并下载约 72 MB 的模型。建议佩戴耳机，减少 App 外放声音产生的回声。
键盘模式
键盘模式提供上下两组可独立调整的钢琴键盘，可改变高度比例、白键数量和音域位置，并支持触屏发声、按键动画、MIDI 力度、延音踏板、移调、节拍器和 WAV 录音。
4. 曲谱导入、同步与成绩数据
打开“普通弹奏 → 更多菜单”，可进入参数设置，或按需要同步曲库、导入曲谱和管理成绩数据：
- 曲库同步：从服务器同步最新曲谱到本地。
- MID 导入：导入
.mid、.midi或.mscz文件。 - 外部打开：也可在文件管理器中选择“使用 JustPiano 打开”或“分享到 JustPiano”。
- 成绩数据：导出或恢复本地收藏和所有弹奏分数。
5. 录音与文件保存
普通弹奏、瀑布流和键盘模式都可以生成内部弹奏录音。录音直接记录 App 发出的声音，不使用麦克风，也不会录入环境杂音。
在“首页 → 录音文件”中可以播放、导入、分享或删除 WAV 文件。默认目录为：
SD卡/Android/data/ly.pp.justpiano3/files/Records
卸载 App 时，系统可能清理这个默认目录。重要录音请提前分享备份；也可以在“参数设置 → 录音文件存储位置”中选择自定义目录。
6. 联网模式
登录与账号
登录页支持注册、记住账号和密码、自动登录、已保存账号切换，以及正式服、测试服或开发服务器选择。退出联网模式时可以选择保留登录状态或注销登录。
账号列表可导出为明文或加密 JSON 文件。选择加密导出时，设置的密码仅用于本地备份，与账号登录密码无关，也不会上传服务器。
在线功能入口
浏览分类、最热、最新、收藏、搜索和冠军曲目，并可收藏、瀑布流或弹奏。
创建或进入普通房间、键盘房间，选曲、分配左右手、组队、移调并开始弹奏。
查看考级、等级、冠军、总分、祝福、贡献榜及个人资料。
查找用户、管理好友、私信、查看资料、举报或取消屏蔽。
房间内可打开好友、聊天、在线用户、歌曲和邀请面板。房主可换位、关闭或打开空位、移出成员、静音和转让房主；页面会根据你的房间身份显示可用操作。
进入键盘房间后，可实时广播触屏或 MIDI 按键，与其他成员协奏。
房间大厅还包含换衣间、在线奖励、搭档、信箱和家族等个人内容。家族考核曲和本地上传族徽在当前版本尚未完整开放，族徽可按页面提示前往官网处理。
7. 聊天、资源与参数设置
聊天与聊天记录
联网聊天支持普通消息、表情、图文混合、彩色消息、@ 用户、私信和未读提示。聊天设置可以控制时间显示、提示音、记录保存、字体大小和导出加密。
在聊天记录页，可按日期和房间浏览记录，通过搜索或日历定位消息，并查看发言统计。记录支持分组删除，也可全部或按单个分组导入、导出。加密记录在其他设备打开时可能需要原密钥。
皮肤、音源与主要设置
| 分类 | 主要内容 |
|---|---|
| 弹奏 / 音块 | 和弦、按键效果、判定提示、判断线、节拍、音块速度、大小和变色。 |
| 瀑布流 / 五线谱 | 背景、播放速度、移调、颜色、透明度和谱面滚动方式。 |
| 键盘 / 声音 | 按键标签、触屏与 MIDI 移调、踏板、延音、混响和震动。 |
| 联网 | 通知、退出行为、后台保活、保持唤醒和键盘协奏模式。 |
| 聊天 | 时间、提示音、记录保存、字体大小和导出加密。 |
在皮肤和音源下载页，可下载、应用资源或恢复默认资源；已安装资源可在参数设置中切换或删除。设置了自定义背景图片后，会优先显示该图片。
日常使用时，建议保持 Debug tools、渲染测试和延迟测试选项的默认值。
8. 常见问题
没有声音或首次弹奏卡顿
等待首页音源准备完成，并检查媒体音量、当前音源和声音设置。仍异常时，可先恢复默认音源。
MIDI 设备没有显示
检查 USB OTG/MIDI 支持和数据线，重新连接电子琴，再到 MIDI 设备设置中选择。
麦克风识别无法使用
确认已授权麦克风、模型下载完成，并降低环境噪声；使用耳机可减少外放回声。
联网模式频繁掉线
授予通知权限，并按需开启后台活动、忽略电池优化或保持唤醒；部分系统还需允许自启动。
录音在卸载后丢失
默认录音目录可能随卸载被清理。请使用自定义目录或提前分享备份重要 WAV 文件。
导入后原有数据不见了
成绩数据恢复和账号恢复都是覆盖操作。恢复前应先导出当前数据并确认备份文件。