初始提交：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
commit f0f0a9b50e
446 changed files with 2627836 additions and 0 deletions
@@ -0,0 +1,149 @@
+import Live
+import socket
+import threading
+import os
+import json
+import re
+
+from _Framework.ControlSurface import ControlSurface
+
+SOCKET_HOST = "127.0.0.1"
+SOCKET_PORT = 9129
+BUFFER_SIZE  = 4096
+
+
+class AudioInserter(ControlSurface):
+
+    def __init__(self, c_instance):
+        super().__init__(c_instance)
+        self._c_instance = c_instance
+        self._server_thread = None
+        self._running = False
+        self._start_server()
+        self.log_message("AudioInserter: started, listening on port %d" % SOCKET_PORT)
+
+    def _start_server(self):
+        self._running = True
+        self._server_thread = threading.Thread(target=self._server_loop, daemon=True)
+        self._server_thread.start()
+
+    def _server_loop(self):
+        try:
+            srv = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            srv.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            srv.bind((SOCKET_HOST, SOCKET_PORT))
+            srv.listen(5)
+            srv.settimeout(1.0)
+            while self._running:
+                try:
+                    conn, _ = srv.accept()
+                    data = conn.recv(BUFFER_SIZE).decode("utf-8").strip()
+                    response = self._handle_command(data)
+                    conn.sendall((response + "\n").encode("utf-8"))
+                    conn.close()
+                except socket.timeout:
+                    continue
+                except Exception as e:
+                    self.log_message("AudioInserter socket error: %s" % str(e))
+        except Exception as e:
+            self.log_message("AudioInserter server error: %s" % str(e))
+
+    def _handle_command(self, raw):
+        try:
+            cmd = json.loads(raw)
+        except Exception:
+            return json.dumps({"ok": False, "error": "Invalid JSON"})
+
+        action = cmd.get("action", "")
+
+        if action == "ping":
+            return json.dumps({"ok": True, "message": "pong"})
+
+        if action == "insert_audio":
+            file_path = cmd.get("file_path", "")
+            if not file_path:
+                return json.dumps({"ok": False, "error": "No file_path provided"})
+            if not os.path.isfile(file_path):
+                return json.dumps({"ok": False, "error": "File not found: %s" % file_path})
+
+            result = {"done": False, "ok": False, "error": None}
+            event = threading.Event()
+            track_name = cmd.get("track_name", "")
+
+            def do_insert():
+                try:
+                    result["ok"], result["error"] = self._insert_audio(file_path, track_name)
+                except Exception as e:
+                    result["ok"] = False
+                    result["error"] = str(e)
+                finally:
+                    result["done"] = True
+                    event.set()
+
+            self.schedule_message(1, do_insert)
+            event.wait(timeout=10.0)
+
+            if result["ok"]:
+                msg = result.get("error") or ("Inserted: %s" % os.path.basename(file_path))
+                return json.dumps({"ok": True, "message": msg})
+            else:
+                return json.dumps({"ok": False, "error": result.get("error", "Unknown error")})
+
+        return json.dumps({"ok": False, "error": "Unknown action: %s" % action})
+
+    def _clean_track_name(self, name):
+        name = re.sub(r'\b\w+\s*:\s*\S+', '', name)
+        name = re.sub(r'\s{2,}', ' ', name).strip()
+        return name if name else "Audio"
+
+    def _insert_audio(self, file_path, track_name=""):
+        import shutil, time
+        song = self._c_instance.song()
+        insert_time = song.current_song_time
+
+        song.create_audio_track(-1)
+        track = song.tracks[-1]
+
+        raw_name = track_name if track_name else os.path.splitext(os.path.basename(file_path))[0]
+        clean_name = self._clean_track_name(raw_name)
+        track.name = clean_name
+
+        # Copy file to a unique path so each generation is preserved independently
+        ext = os.path.splitext(file_path)[1]
+        unique_name = "%s_%s%s" % (clean_name.replace(" ", "_"), int(time.time()), ext)
+        dest_dir = os.path.dirname(file_path)
+        unique_path = os.path.join(dest_dir, unique_name)
+        shutil.copy2(file_path, unique_path)
+        self.log_message("AudioInserter: copied to %s" % unique_path)
+
+        # Step 1: create audio clip in session slot 0
+        slot = track.clip_slots[0]
+        slot.create_audio_clip(unique_path)
+        clip = slot.clip
+
+        if clip is None:
+            return False, "clip is None after create_audio_clip"
+
+        clip.name = clean_name
+
+        self.log_message("AudioInserter: session clip created, length=%s is_session_clip=%s" % (
+            clip.length, clip.is_session_clip))
+
+        # Step 2: duplicate to arrangement at playhead using track.duplicate_clip_to_arrangement
+        # Signature from Live 11 sources: duplicate_clip_to_arrangement(clip, position)
+        try:
+            track.duplicate_clip_to_arrangement(clip, insert_time)
+            self.log_message("AudioInserter: duplicate_clip_to_arrangement succeeded")
+
+            # Step 3: delete the session clip — we only want it in arrangement
+            slot.delete_clip()
+
+            return True, None
+        except Exception as e:
+            self.log_message("AudioInserter: duplicate_clip_to_arrangement failed: %s" % str(e))
+            return False, "duplicate_clip_to_arrangement failed: %s" % str(e)
+
+    def disconnect(self):
+        self._running = False
+        super().disconnect()
+        self.log_message("AudioInserter: disconnected")
@@ -0,0 +1,4 @@
+from .AudioInserter import AudioInserter
+
+def create_instance(c_instance):
+    return AudioInserter(c_instance)