SoundGame Dev
f0f0a9b50e
- 共享引擎（app/src/main）：GestureEngine 6 手势识别、AudioEngine 三层音频 （ExoPlayer BGM 交叉淡入 / 对白 ducking / SoundPool 低延迟）、Game/GameEngine 状态机接口、MainActivity 全屏封面 + TalkBack - 《声命线》storyline：末世互动广播剧，3 幕 8 抉择点 4 结局 - 《声东击西》reflex：听声辨位反应，12 波战斗 + BGM 三档 BPM 变速 - 《暗室》escape：3x3 网格密室逃脱，钥匙→铁柜→保险丝→电箱→大门谜题链 - 文档：setup（从零搭建）/ architecture（架构）/ engine-api（引擎 API）/ asset-pipeline（资产流水线）/ games/*（三款游戏设计文档） - 资产管线：Qwen3-TTS 对白 + 程序合成音效/BGM + Mureka BGM 的 gen 脚本与台账， 全部 ogg 资产入库可复现 - env.d 环境脚本：android/tts 入库；sfx/mureka 含密钥不入库，仅提交 .example.sh 模板
70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# SoundGame — Android 开发环境使用说明
|
||
|
||
全部软件安装在用户目录，无需 sudo。`source` 环境变量文件后即可使用：
|
||
|
||
```bash
|
||
source /home/ubuntu/SoundGame/env.d/android.sh
|
||
```
|
||
|
||
## 已安装组件
|
||
|
||
| 组件 | 版本 | 位置 |
|
||
|---|---|---|
|
||
| JDK (OpenJDK) | 17.0.2 | `tools/jdk17` |
|
||
| Android cmdline-tools | latest (15859902) | `tools/android-sdk/cmdline-tools/latest` |
|
||
| platform-tools (adb) | 37.0.1 | `tools/android-sdk/platform-tools` |
|
||
| Android SDK Platform | android-36 | `tools/android-sdk/platforms/android-36` |
|
||
| build-tools | 36.0.0 | `tools/android-sdk/build-tools/36.0.0` |
|
||
| ffmpeg / ffprobe（静态） | N-126303 (2026-08-27) | `tools/bin/` |
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
adb devices # 查看已连接设备
|
||
sdkmanager --list_installed # 查看已安装 SDK 组件
|
||
sdkmanager "platforms;android-36" # 安装其他组件
|
||
ffmpeg -i in.mp3 -c:a aac out.m4a # 音频转码
|
||
```
|
||
|
||
Gradle 项目可在 `local.properties` 中写：
|
||
```
|
||
sdk.dir=/home/ubuntu/SoundGame/tools/android-sdk
|
||
```
|
||
|
||
## 真机调试（WSL2 无法直接访问 USB，推荐以下两种方式）
|
||
|
||
### 方式一：无线调试（推荐，Android 11+）
|
||
|
||
手机和电脑连同一 Wi-Fi。手机上：开发者选项 → 无线调试。
|
||
|
||
```bash
|
||
# 1. 配对（手机“无线调试”→“使用配对码配对”，会显示 IP:端口 和 6 位配对码）
|
||
adb pair 192.168.x.x:37027
|
||
# 输入配对码
|
||
|
||
# 2. 连接（用无线调试首页显示的 IP:端口，注意与配对端口不同）
|
||
adb connect 192.168.x.x:43215
|
||
|
||
# 3. 验证
|
||
adb devices
|
||
```
|
||
|
||
Android 10 及以下可先在有 root/电脑的机器上执行 `adb tcpip 5555`，再 `adb connect <手机IP>:5555`。
|
||
|
||
### 方式二：Windows 侧 adb server（备选）
|
||
|
||
WSL2 默认看不到 USB 设备。可让 adb server 跑在 Windows 侧：
|
||
|
||
1. Windows 安装 platform-tools，手机开 USB 调试并连上 Windows，确认 Windows 的 `adb devices` 能看到手机。
|
||
2. Windows 上执行：`adb -a -P 5037 nodaemon server`（监听所有网卡）。
|
||
3. WSL2 中获取 Windows 主机 IP（`ip route show | awk '/default/ {print $3}'`），然后：
|
||
```bash
|
||
export ADB_SERVER_SOCKET=tcp:<Windows主机IP>:5037
|
||
adb devices # 现在走的是 Windows 的 server
|
||
```
|
||
|
||
## 备注
|
||
|
||
- JDK 实际用的是华为云镜像的 Oracle OpenJDK 17.0.2（Adoptium 官方源在本机过慢），对 Gradle/Android 构建完全够用。
|
||
- 未修改 `~/.bashrc`；每次新开 shell 需重新 `source env.d/android.sh`。
|