refactor: control unit进一步细分 (#1191)

Author: MistEO

docs/en_us/2.2-IntegratedInterfaceOverview.md

@@ -463,7 +463,8 @@ Asynchronously scroll. This is an asynchronous operation that immediately return
 
 > [!NOTE]
 >
-> - Only Win32 Controller supports scroll operations. Adb Controller does not support scrolling.
+> - Win32 controllers and custom controllers that implement `scroll` support scroll operations.
+> - Posting scroll to a controller that does not implement `scroll` will cause the action to fail.
 > - The `dx`/`dy` values are sent directly as scroll increments. The Windows standard wheel increment is 120 (WHEEL_DELTA) per notch. Using multiples of 120 is recommended for best compatibility.
 
 ### MaaControllerPostInactive

docs/en_us/3.1-PipelineProtocol.md

@@ -1094,7 +1094,8 @@ Additional properties for this action:
 
 > [!NOTE]
 >
-> - Adb Controller and PlayCover Controller do not support scroll operations. Only Win32 Controller is supported.
+> - Win32 controllers and custom controllers that implement `scroll` support scroll operations.
+> - Posting a `Scroll` action to a controller that does not implement `scroll` will cause the action to fail.
 > - The `dx`/`dy` values are sent directly as scroll increments. The Windows standard wheel increment is 120 (WHEEL_DELTA) per notch. Using multiples of 120 is recommended for best compatibility.
 
 ### `ClickKey`

docs/zh_cn/2.2-集成接口一览.md

@@ -463,7 +463,7 @@
 
 > [!NOTE]
 >
-> - 仅 Win32 控制器支持滚动操作，Adb 控制器不支持。
+> - Win32 控制器，以及实现了 `scroll` 的自定义控制器支持滚动操作。
 > - `dx`/`dy` 的值会直接作为滚动增量发送。Windows 标准滚轮每格增量为 120（WHEEL_DELTA），建议使用 120 的整数倍以获得最佳兼容性。
 
 ### MaaControllerPostInactive

docs/zh_cn/3.1-任务流水线协议.md

@@ -1103,7 +1103,7 @@ Pipeline v2 时，将这些字段放到 `recognition.param` 中即可。
 
 > [!NOTE]
 >
-> - Adb 控制器和 PlayCover 控制器不支持滚动操作。仅 Win32 控制器支持。
+> - Win32 控制器，以及实现了 `scroll` 的自定义控制器支持滚动操作。
 > - `dx`/`dy` 的值会直接作为滚动增量发送。Windows 标准滚轮每格增量为 120（WHEEL_DELTA），建议使用 120 的整数倍以获得最佳兼容性。
 
 ### `ClickKey`

include/MaaFramework/Instance/MaaController.h

@@ -171,7 +171,9 @@ extern "C"
      * @param dy The vertical scroll delta. Positive values scroll up, negative values scroll down.
      * @return The control id of the scroll action.
      *
-     * @note Not all controllers support scroll. If not supported, the action will fail.
+     * @note Scroll is supported by Win32 controllers and custom controllers that implement scroll.
+     * @note If the controller does not support scroll, the action will fail. Use MaaControllerStatus or
+     * MaaControllerWait to check the result.
      * @note The dx/dy values are sent directly as scroll increments. Using multiples of 120 (WHEEL_DELTA) is
      * recommended for best compatibility.
      */

source/LibraryHolder/ControlUnit/ControlUnit.cpp

@@ -135,7 +135,7 @@ std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>
     return std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
 }
 
-std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>
+std::shared_ptr<MAA_CTRL_UNIT_NS::CustomControlUnitAPI>
     CustomControlUnitLibraryHolder::create_control_unit(MaaCustomControllerCallbacks* controller, void* controller_arg)
 {
     if (!load_library(library_dir() / libname_)) {
@@ -164,7 +164,7 @@ std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>
         return nullptr;
     }
 
-    return std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
+    return std::shared_ptr<MAA_CTRL_UNIT_NS::CustomControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
 }
 
 std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>
@@ -199,7 +199,7 @@ std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>
     return std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
 }
 
-std::shared_ptr<MAA_CTRL_UNIT_NS::Win32ControlUnitAPI>
+std::shared_ptr<MAA_CTRL_UNIT_NS::GamepadControlUnitAPI>
     GamepadControlUnitLibraryHolder::create_control_unit(void* hWnd, MaaGamepadType gamepad_type, MaaWin32ScreencapMethod screencap_method)
 {
     if (!load_library(library_dir() / libname_)) {
@@ -228,7 +228,7 @@ std::shared_ptr<MAA_CTRL_UNIT_NS::Win32ControlUnitAPI>
         return nullptr;
     }
 
-    return std::shared_ptr<MAA_CTRL_UNIT_NS::Win32ControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
+    return std::shared_ptr<MAA_CTRL_UNIT_NS::GamepadControlUnitAPI>(control_unit_handle, destroy_control_unit_func);
 }
 
 std::shared_ptr<MAA_CTRL_UNIT_NS::ControlUnitAPI> WlRootsControlUnitLibraryHolder::create_control_unit(const char* wlr_socket_path)

source/MaaAdbControlUnit/Base/UnitBase.h

@@ -99,7 +99,6 @@ class InputBase
     virtual bool key_down(int key) = 0;
     virtual bool key_up(int key) = 0;
 
-    virtual bool scroll(int dx, int dy) = 0;
 };
 
 MAA_CTRL_UNIT_NS_END

source/MaaAdbControlUnit/EmulatorExtras/MuMuPlayerExtras.cpp

@@ -379,12 +379,6 @@ bool MuMuPlayerExtras::key_up(int key)
     return true;
 }
 
-bool MuMuPlayerExtras::scroll(int dx, int dy)
-{
-    LogError << "Scroll is not supported on MuMuPlayerExtras" << VAR(dx) << VAR(dy);
-    return false;
-}
-
 void MuMuPlayerExtras::on_app_started(const std::string& intent)
 {
     std::string package = string_split(intent, '/').front();

source/MaaAdbControlUnit/EmulatorExtras/MuMuPlayerExtras.h

@@ -46,8 +46,6 @@ class MuMuPlayerExtras
     virtual bool key_down(int key) override;
     virtual bool key_up(int key) override;
 
-    virtual bool scroll(int dx, int dy) override;
-
 public: // from ControlUnitSink
     virtual void on_app_started(const std::string& intent) override;
     virtual void on_app_stopped(const std::string& intent) override;

source/MaaAdbControlUnit/Input/AdbShellInput.cpp

@@ -125,10 +125,4 @@ bool AdbShellInput::key_up(int key)
     return false;
 }
 
-bool AdbShellInput::scroll(int dx, int dy)
-{
-    LogError << "Scroll is not supported on Adb controller" << VAR(dx) << VAR(dy);
-    return false;
-}
-
 MAA_CTRL_UNIT_NS_END