From a78e6f7a052c755c6551e71c9408f93ad8925f95 Mon Sep 17 00:00:00 2001
From: ChestnutYueyue <952134128@qq.com>
Date: Sun, 15 Feb 2026 20:48:09 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E5=B0=86=E9=94=AE=E7=9B=98=E4=BA=8B?=
 =?UTF-8?q?=E4=BB=B6=E6=A3=80=E6=B5=8B=E4=BB=8EkeyCode=E6=94=B9=E4=B8=BAsc?=
 =?UTF-8?q?ancode?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

统一使用scancode作为键盘事件的检测标准，提高跨平台兼容性
---
 README.md                      | 2 +-
 docs/module_system.md          | 2 +-
 docs/quick_start.md            | 4 ++--
 examples/basic/main.cpp        | 2 +-
 examples/hello_module/main.cpp | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 2dd7b30..1d1827c 100644
--- a/README.md
+++ b/README.md
@@ -318,7 +318,7 @@ auto eventService = app.events();
 // 键盘事件
 eventService->addListener(EventType::KeyPress, [](Event& e) {
     auto& key = std::get<KeyEvent>(e.data);
-    if (key.keyCode == static_cast<int>(Key::Escape)) {
+    if (key.scancode == static_cast<int>(Key::Escape)) {
         Application::get().quit();
     }
 });
diff --git a/docs/module_system.md b/docs/module_system.md
index a67fab9..f2943f0 100644
--- a/docs/module_system.md
+++ b/docs/module_system.md
@@ -495,7 +495,7 @@ auto eventService = app.events();
 // 监听键盘事件
 eventService->addListener(EventType::KeyPress, [](Event& e) {
     auto& key = std::get<KeyEvent>(e.data);
-    if (key.keyCode == static_cast<int>(Key::Escape)) {
+    if (key.scancode == static_cast<int>(Key::Escape)) {
         Application::get().quit();
     }
 });
diff --git a/docs/quick_start.md b/docs/quick_start.md
index 3ca0bd0..bf253a0 100644
--- a/docs/quick_start.md
+++ b/docs/quick_start.md
@@ -314,12 +314,12 @@ public:
         addListener(EventType::KeyPress, [](Event& e) {
             auto& key = std::get<KeyEvent>(e.data);
             
-            if (key.keyCode == static_cast<int>(Key::Escape)) {
+            if (key.scancode == static_cast<int>(Key::Escape)) {
                 e.handled = true;
                 Application::get().quit();
             }
             
-            if (key.keyCode == static_cast<int>(Key::Space)) {
+            if (key.scancode == static_cast<int>(Key::Space)) {
                 E2D_LOG_INFO("Space pressed!");
             }
         });
diff --git a/examples/basic/main.cpp b/examples/basic/main.cpp
index cc74410..5de72a1 100644
--- a/examples/basic/main.cpp
+++ b/examples/basic/main.cpp
@@ -125,7 +125,7 @@ int main(int argc, char *argv[]) {
     eventService->addListener(EventType::KeyPress, [](Event &e) {
       auto &keyEvent = std::get<KeyEvent>(e.data);
 
-      if (keyEvent.keyCode == static_cast<int>(Key::Escape)) {
+      if (keyEvent.scancode == static_cast<int>(Key::Escape)) {
         e.handled = true;
         Application::get().quit();
       }
diff --git a/examples/hello_module/main.cpp b/examples/hello_module/main.cpp
index 99006d3..83fcc53 100644
--- a/examples/hello_module/main.cpp
+++ b/examples/hello_module/main.cpp
@@ -17,7 +17,7 @@ public:
     addListener(EventType::KeyPress, [](Event &e) {
       auto &keyEvent = std::get<KeyEvent>(e.data);
 
-      if (keyEvent.keyCode == static_cast<int>(Key::Escape)) {
+      if (keyEvent.scancode == static_cast<int>(Key::Escape)) {
         e.handled = true;
         E2D_LOG_INFO("ESC !!!exit");
         Application::get().quit();