[feat] 增加按键显示

1. UI上增加显示最近几个按键

Author: Nomination-NRB

src/app.py

@@ -2,13 +2,16 @@
 import tkinter as tk
 from tkinter import filedialog, messagebox, ttk
 from typing import List, Optional
+import threading
+import time
+from collections import deque
 
 from src.player import Player
 from src.event import Event
 
 
 class BaseApp:
-    def __init__(self, root: tk.Tk, title: str):
+    def __init__(self, root: tk.Tk, title: str, create_key_display: bool = True):
         self.root = root
         self.root.title(title)
         self.score_text: Optional[str] = None
@@ -21,6 +24,18 @@ def __init__(self, root: tk.Tk, title: str):
         self._create_params_frame()
         self._create_control_frame()
         self._create_tips_frame()
+        
+        # 根据参数决定是否创建按键显示框架
+        if create_key_display:
+            self._create_key_display_frame()
+        
+        # 初始化按键显示相关变量
+        self.keys = deque(maxlen=14)  # 显示最近maxlen个按键
+        self.last_press_time = {}
+        self.running = True
+        
+        # 启动按键监听
+        self._start_key_listener()
 
     def _create_file_bar(self):
         file_bar = tk.Frame(self.frm)
@@ -89,6 +104,85 @@ def _create_tips_frame(self):
             "4) 如无响应尝试以管理员身份运行。"
         )).pack(fill="x")
 
+    def _create_key_display_frame(self):
+        """创建按键显示框架"""
+        key_frame = tk.LabelFrame(self.frm, text="按键显示")
+        key_frame.pack(fill="x", pady=8)
+        
+        # 创建按键显示标签
+        self.lbl_keys = tk.Label(
+            key_frame,
+            text="等待按键...",
+            font=("Consolas", 16, "bold"),
+            fg="white",
+            bg="#C0C0C0",  # 使用深灰色模拟半透明效果
+            height=2,
+            anchor="center",
+            relief="flat",  # 去掉边框，让背景更平滑
+            borderwidth=0
+        )
+        self.lbl_keys.pack(fill="x", padx=4, pady=4)
+        
+        # 添加说明文字
+        tk.Label(key_frame, text="实时显示当前按下的按键", font=("微软雅黑", 9), fg="gray").pack(anchor="w", padx=4)
+
+    def _start_key_listener(self):
+        """启动按键监听线程"""
+        try:
+            from pynput import keyboard
+            
+            def on_press(key):
+                """键盘按下事件"""
+                try:
+                    k = key.char.upper()
+                except AttributeError:
+                    k = str(key).replace("Key.", "").upper()
+                
+                self.keys.append(k)
+                self.last_press_time[k] = time.time()
+                self._update_key_display()
+            
+            # 启动键盘监听器
+            self.key_listener = keyboard.Listener(on_press=on_press)
+            self.key_listener.start()
+            
+            # 启动清理过期按键的线程
+            threading.Thread(target=self._cleanup_keys_loop, daemon=True).start()
+            
+        except ImportError:
+            # 如果没有安装pynput，显示提示信息
+            self.lbl_keys.config(
+                text="需要安装 pynput 模块\npip install pynput",
+                font=("微软雅黑", 10),
+                fg="red",
+                bg="lightgray"
+            )
+
+    def _update_key_display(self):
+        """更新按键显示"""
+        if hasattr(self, 'lbl_keys'):
+            if self.keys:
+                display_text = "  ".join(self.keys)
+                self.lbl_keys.config(text=display_text)
+            else:
+                self.lbl_keys.config(text="等待按键...")
+
+    def _cleanup_keys_loop(self):
+        """后台循环，清理过期按键"""
+        while self.running:
+            now = time.time()
+            removed = False
+            for k in list(self.keys):
+                if now - self.last_press_time.get(k, 0) > 2.0:  # 2秒后自动清除
+                    try:
+                        self.keys.remove(k)
+                        removed = True
+                    except ValueError:
+                        pass
+            if removed:
+                self._update_key_display()
+            time.sleep(0.2)
+
     def update_progress(self, current: int, total: int):
         """更新进度条和进度标签"""
         if total > 0:
@@ -207,6 +301,15 @@ def toggle_play_pause(self):
             except Exception:
                 pass
 
+    def __del__(self):
+        """析构函数，清理资源"""
+        self.running = False
+        if hasattr(self, 'key_listener'):
+            try:
+                self.key_listener.stop()
+            except:
+                pass
+
 
 if __name__ == '__main__':
     pass

src/app_multi.py

@@ -11,7 +11,7 @@
 
 class MultiApp(BaseApp):
     def __init__(self, root: tk.Tk):
-        super().__init__(root, "多人模式 - 自动弹琴 (去和弦+分散)")
+        super().__init__(root, "多人模式 - 自动弹琴 (去和弦+分散)", create_key_display=False)
         self.raw_events: List[Event] = []
         self.play_events: List[SimpleEvent] = []
 
@@ -25,6 +25,9 @@ def __init__(self, root: tk.Tk):
             '3) 偏移不修改原谱文件，仅运行时生效。\n'
             '4) 适度调整偏移可减少漏音（建议 -20~20 范围内微调）。'
         )).pack(fill="x")
+        
+        # 在说明框架之后添加独立的按键显示框架
+        self._create_key_display_frame()
 
         # 添加多人模式特有的参数 - 使用正确的行数
         params = self.frm.winfo_children()[1]  # 获取第二个子元素（params）

utils/key_cast_overlay_demo.py

@@ -0,0 +1,88 @@
+import tkinter as tk
+from pynput import keyboard
+from collections import deque
+import threading
+import time
+
+MAX_KEYS = 5  # 显示最近几个按键
+DISPLAY_TIME = 2.0  # 每个按键显示多久（秒）
+
+
+class KeyCastOverlay:
+    def __init__(self):
+        self.root = tk.Tk()
+        self.root.overrideredirect(True)  # 去掉窗口边框
+        self.root.attributes("-topmost", True)  # 窗口置顶
+        self.root.attributes("-alpha", 0.7)  # 半透明
+
+        # 设置窗口大小和位置（屏幕底部居中）
+        sw = self.root.winfo_screenwidth()
+        sh = self.root.winfo_screenheight()
+        w, h = 400, 80
+        x, y = (sw - w) // 2, sh - h - 50
+        self.root.geometry(f"{w}x{h}+{x}+{y}")
+
+        # 标签显示按键
+        self.label = tk.Label(
+            self.root,
+            text="",
+            font=("Consolas", 24, "bold"),
+            fg="white",
+            bg="black"
+        )
+        self.label.pack(expand=True, fill="both")
+
+        # 按键缓存
+        self.keys = deque(maxlen=MAX_KEYS)
+        self.last_press_time = {}
+
+        # 键盘监听器
+        self.listener = keyboard.Listener(on_press=self.on_press)
+        self.listener.start()
+
+        # 后台线程定时清理过期按键
+        self.running = True
+        threading.Thread(target=self.cleanup_loop, daemon=True).start()
+
+        self.root.protocol("WM_DELETE_WINDOW", self.close)
+        self.root.mainloop()
+
+    def on_press(self, key):
+        """键盘按下事件"""
+        try:
+            k = key.char.upper()
+        except AttributeError:
+            k = str(key).replace("Key.", "").upper()
+
+        self.keys.append(k)
+        self.last_press_time[k] = time.time()
+        self.update_display()
+
+    def update_display(self):
+        """更新显示内容"""
+        self.label.config(text="  ".join(self.keys))
+
+    def cleanup_loop(self):
+        """后台循环，清理过期按键"""
+        while self.running:
+            now = time.time()
+            removed = False
+            for k in list(self.keys):
+                if now - self.last_press_time.get(k, 0) > DISPLAY_TIME:
+                    try:
+                        self.keys.remove(k)
+                        removed = True
+                    except ValueError:
+                        pass
+            if removed:
+                self.update_display()
+            time.sleep(0.2)
+
+    def close(self):
+        self.running = False
+        self.listener.stop()
+        self.root.destroy()
+
+
+if __name__ == "__main__":
+    KeyCastOverlay()