Files

T

SoundGame Dev f0f0a9b50e 初始提交：3 款纯音频游戏 + 共享引擎 + 完整文档与资产管线

- 共享引擎（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 模板

2026-08-29 13:00:34 +08:00

2.5 KiB

Raw Blame History

SoundGame — Android 开发环境使用说明

全部软件安装在用户目录，无需 sudo。source 环境变量文件后即可使用：

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/`

常用命令

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。手机上：开发者选项 → 无线调试。

# 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 侧：

Windows 安装 platform-tools，手机开 USB 调试并连上 Windows，确认 Windows 的 adb devices 能看到手机。
Windows 上执行：adb -a -P 5037 nodaemon server（监听所有网卡）。

WSL2 中获取 Windows 主机 IP（ip route show | awk '/default/ {print $3}'），然后：

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。

2.5 KiB Raw Blame History Unescape Escape