Input API

作用

Input API 允许 mod 注册触摸和键盘事件回调，也可以请求显示或隐藏软键盘。

头文件

#include <pl/c/PreloaderInput.h>

C++ 也可以使用：

#include <pl/cpp/PreloaderInput.hpp>

类型签名

typedef bool (*PreloaderInput_OnTouch_Fn)(int action, int pointerId,
                                          float x, float y);

typedef bool (*PreloaderInput_OnKeyEvent_Fn)(int keyCode,
                                             unsigned int unicodeChar,
                                             bool isKeyDown);

typedef struct PreloaderInput_Interface {
  void (*RegisterTouchCallback)(PreloaderInput_OnTouch_Fn callback);
  void (*RegisterKeyEventCallback)(PreloaderInput_OnKeyEvent_Fn callback);
  void (*ShowKeyboard)(void);
  void (*HideKeyboard)(void);
} PreloaderInput_Interface;

PLAPI PreloaderInput_Interface *GetPreloaderInput(void);

GetPreloaderInput

作用

返回输入接口表。mod 通过这个接口注册回调或控制软键盘。

参数

无。

返回值

返回 PreloaderInput_Interface *。

示例

static bool on_touch(int action, int pointerId, float x, float y) {
  (void)action;
  (void)pointerId;
  (void)x;
  (void)y;
  return false;
}

bool MyMod::enable() {
  PreloaderInput_Interface *input = GetPreloaderInput();
  input->RegisterTouchCallback(on_touch);
  return true;
}

RegisterTouchCallback

作用

注册触摸事件回调。

参数

参数	说明
callback	触摸事件回调函数

回调参数：

参数	说明
action	Android MotionEvent action
pointerId	指针 ID
x	当前指针 X 坐标
y	当前指针 Y 坐标

返回值

注册函数无返回值。回调返回 true 表示消费事件，返回 false 表示继续传递。

RegisterKeyEventCallback

作用

注册键盘事件回调。

参数

参数	说明
callback	键盘事件回调函数

回调参数：

参数	说明
keyCode	Android key code
unicodeChar	Unicode 字符码
isKeyDown	true 表示按下，false 表示抬起

返回值

注册函数无返回值。回调返回 true 表示消费事件。

ShowKeyboard / HideKeyboard

作用

调用当前 Activity 的 showSoftKeyboard 或 hideSoftKeyboard 方法。

参数

无。

返回值

无。

示例

PreloaderInput_Interface *input = GetPreloaderInput();
input->ShowKeyboard();
input->HideKeyboard();

注意事项

• 回调列表当前没有注销接口，避免重复注册同一个回调。
• 回调应保持简短，避免长时间阻塞。
• 软键盘调用只在游戏 Activity 可用时生效。