feat(sys): update bindings for MaaFramework v5.11.1 (#51)

Co-authored-by: Lemon-miaow <admin@lemonmiaow.xyz>

Author: github-actions[bot]

Cargo.lock

@@ -11,4 +11,4 @@ homepage = "https://github.com/MaaXYZ/MaaFramework"
 repository = "https://github.com/MaaXYZ/MaaFramework"
 
 [workspace.dependencies]
-maa-framework-sys = { path = "maa-framework-sys", version = "5.11.0" }
+maa-framework-sys = { path = "maa-framework-sys", version = "5.11.1" }

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "maa-framework-sys"
-version = "5.11.0"
+version = "5.11.1"
 authors.workspace = true
 edition.workspace = true
 description = "Low-level Rust bindings for MaaFramework"

maa-framework-sys/Cargo.toml

@@ -900,6 +900,7 @@ pub struct MaaFramework {
             device_node: *const ::std::os::raw::c_char,
             screen_width: ::std::os::raw::c_int,
             screen_height: ::std::os::raw::c_int,
+            use_win32_vk_code: MaaBool,
         ) -> *mut MaaController,
         ::libloading::Error,
     >,
@@ -3146,19 +3147,23 @@ impl MaaFramework {
             )
         }
     }
-    #[doc = " @brief Create a KWin (pure Wayland) controller for Linux.\n\n @param device_node The uinput device node path (e.g., \"/dev/uinput\").\n @param screen_width The screen width in pixels.\n @param screen_height The screen height in pixels.\n @return The controller handle, or nullptr on failure.\n\n @note This controller is designed for KWin (pure Wayland) on Linux.\n @note Input is simulated via /dev/uinput (kernel-level virtual touchscreen).\n @note Screencap is implemented via PipeWire / xdg-desktop-portal (KDE/KWin).\n       Captures the foreground monitor in fullscreen mode.\n @note Requires user authorization via the screen sharing dialog (xdg-desktop-portal).\n @note Requires write permission to /dev/uinput (typically via the \"input\" group).\n @note Only single touch is supported (contact must be 0)."]
+    #[doc = " @brief Create a KWin (pure Wayland) controller for Linux.\n\n @param device_node The uinput device node path (e.g., \"/dev/uinput\").\n @param screen_width The screen width in pixels.\n @param screen_height The screen height in pixels.\n @param use_win32_vk_code If true, key codes passed to click_key / key_down / key_up are\n        interpreted as Win32 Virtual-Key codes (VK_*) and translated to Linux evdev codes\n        internally. If false, key codes are passed through as raw evdev codes.\n @return The controller handle, or nullptr on failure.\n\n @note This controller is designed for KWin (pure Wayland) on Linux.\n @note Input is simulated via /dev/uinput (kernel-level virtual touchscreen).\n @note Screencap is implemented via PipeWire / xdg-desktop-portal (KDE/KWin).\n       Captures the foreground monitor in fullscreen mode.\n @note Requires user authorization via the screen sharing dialog (xdg-desktop-portal).\n @note Requires write permission to /dev/uinput (typically via the \"input\" group).\n @note Only single touch is supported (contact must be 0)."]
     pub unsafe fn MaaKWinControllerCreate(
         &self,
         device_node: *const ::std::os::raw::c_char,
         screen_width: ::std::os::raw::c_int,
         screen_height: ::std::os::raw::c_int,
+        use_win32_vk_code: MaaBool,
     ) -> *mut MaaController {
         unsafe {
             (self
                 .MaaKWinControllerCreate
                 .as_ref()
                 .expect("Expected function, got error."))(
-                device_node, screen_width, screen_height
+                device_node,
+                screen_width,
+                screen_height,
+                use_win32_vk_code,
             )
         }
     }

maa-framework-sys/src/bindings/dynamic_bindings.rs

@@ -68,7 +68,7 @@ shim ! (MaaReplayControllerCreate (recording_path : * const :: std :: os :: raw
 shim ! (MaaRecordControllerCreate (inner : * mut MaaController , recording_path : * const :: std :: os :: raw :: c_char) -> * mut MaaController) ;
 shim ! (MaaPlayCoverControllerCreate (address : * const :: std :: os :: raw :: c_char , uuid : * const :: std :: os :: raw :: c_char) -> * mut MaaController) ;
 shim ! (MaaWlRootsControllerCreate (wlr_socket_path : * const :: std :: os :: raw :: c_char , use_win32_vk_code : MaaBool) -> * mut MaaController) ;
-shim ! (MaaKWinControllerCreate (device_node : * const :: std :: os :: raw :: c_char , screen_width : :: std :: os :: raw :: c_int , screen_height : :: std :: os :: raw :: c_int) -> * mut MaaController) ;
+shim ! (MaaKWinControllerCreate (device_node : * const :: std :: os :: raw :: c_char , screen_width : :: std :: os :: raw :: c_int , screen_height : :: std :: os :: raw :: c_int , use_win32_vk_code : MaaBool) -> * mut MaaController) ;
 shim ! (MaaGamepadControllerCreate (hWnd : * mut :: std :: os :: raw :: c_void , gamepad_type : MaaGamepadType , screencap_method : MaaWin32ScreencapMethod) -> * mut MaaController) ;
 shim ! (MaaControllerDestroy (ctrl : * mut MaaController) -> ()) ;
 shim ! (MaaControllerAddSink (ctrl : * mut MaaController , sink : MaaEventCallback , trans_arg : * mut :: std :: os :: raw :: c_void) -> MaaSinkId) ;

maa-framework-sys/src/bindings/shims.rs

@@ -699,11 +699,12 @@ unsafe extern "C" {
     ) -> *mut MaaController;
 }
 unsafe extern "C" {
-    #[doc = " @brief Create a KWin (pure Wayland) controller for Linux.\n\n @param device_node The uinput device node path (e.g., \"/dev/uinput\").\n @param screen_width The screen width in pixels.\n @param screen_height The screen height in pixels.\n @return The controller handle, or nullptr on failure.\n\n @note This controller is designed for KWin (pure Wayland) on Linux.\n @note Input is simulated via /dev/uinput (kernel-level virtual touchscreen).\n @note Screencap is implemented via PipeWire / xdg-desktop-portal (KDE/KWin).\n       Captures the foreground monitor in fullscreen mode.\n @note Requires user authorization via the screen sharing dialog (xdg-desktop-portal).\n @note Requires write permission to /dev/uinput (typically via the \"input\" group).\n @note Only single touch is supported (contact must be 0)."]
+    #[doc = " @brief Create a KWin (pure Wayland) controller for Linux.\n\n @param device_node The uinput device node path (e.g., \"/dev/uinput\").\n @param screen_width The screen width in pixels.\n @param screen_height The screen height in pixels.\n @param use_win32_vk_code If true, key codes passed to click_key / key_down / key_up are\n        interpreted as Win32 Virtual-Key codes (VK_*) and translated to Linux evdev codes\n        internally. If false, key codes are passed through as raw evdev codes.\n @return The controller handle, or nullptr on failure.\n\n @note This controller is designed for KWin (pure Wayland) on Linux.\n @note Input is simulated via /dev/uinput (kernel-level virtual touchscreen).\n @note Screencap is implemented via PipeWire / xdg-desktop-portal (KDE/KWin).\n       Captures the foreground monitor in fullscreen mode.\n @note Requires user authorization via the screen sharing dialog (xdg-desktop-portal).\n @note Requires write permission to /dev/uinput (typically via the \"input\" group).\n @note Only single touch is supported (contact must be 0)."]
     pub fn MaaKWinControllerCreate(
         device_node: *const ::std::os::raw::c_char,
         screen_width: ::std::os::raw::c_int,
         screen_height: ::std::os::raw::c_int,
+        use_win32_vk_code: MaaBool,
     ) -> *mut MaaController;
 }
 unsafe extern "C" {

maa-framework-sys/src/bindings/static_bindings.rs

@@ -241,9 +241,36 @@ impl Controller {
     /// not exported by the Windows/macOS builds of MaaFramework.
     #[cfg(target_os = "linux")]
     pub fn new_kwin(device_node: &str, screen_width: i32, screen_height: i32) -> MaaResult<Self> {
+        Self::new_kwin_with_vk_code(device_node, screen_width, screen_height, false)
+    }
+
+    /// Create a new KWin (pure Wayland) controller for Linux.
+    ///
+    /// Same as [`new_kwin`](Self::new_kwin), but lets you control how key codes are
+    /// interpreted.
+    ///
+    /// # Arguments
+    /// * `device_node` - The uinput device node path (e.g. `/dev/uinput`)
+    /// * `screen_width` - The screen width in pixels
+    /// * `screen_height` - The screen height in pixels
+    /// * `use_win32_vk_code` - Interpret key codes as Win32 Virtual-Key codes and translate
+    ///   them to Linux evdev codes internally when set to `true`
+    #[cfg(target_os = "linux")]
+    pub fn new_kwin_with_vk_code(
+        device_node: &str,
+        screen_width: i32,
+        screen_height: i32,
+        use_win32_vk_code: bool,
+    ) -> MaaResult<Self> {
         let c_node = CString::new(device_node)?;
-        let handle =
-            unsafe { sys::MaaKWinControllerCreate(c_node.as_ptr(), screen_width, screen_height) };
+        let handle = unsafe {
+            sys::MaaKWinControllerCreate(
+                c_node.as_ptr(),
+                screen_width,
+                screen_height,
+                use_win32_vk_code as sys::MaaBool,
+            )
+        };
 
         Self::from_handle(handle)
     }