SuperAPI AI 工具集

enhanced-input

编程与开发

查看项目

更新于 11-06 16:23

技能介绍

该技能面向虚幻引擎(Unreal Engine)的增强输入系统,通过 Python 脚本调用 InputService 类完成输入资产的创建与配置。主要能力包括:创建输入动作(Input Action)并指定值类型(Boolean、Axis1D、Axis2D、Axis3D);创建映射上下文(Mapping Context)并设置优先级;在映射上下文中为输入动作添加按键映射,支持键盘、鼠标和游戏手柄按键;按索引为映射添加或移除触发器(如 Pressed、Released、Down、Hold、Tap、Pulse)与修饰器(如 Negate、DeadZone、Scalar、SwizzleAxis 等);查询现有输入动作、映射上下文、映射、修饰器和触发器的信息;通过 discover_types、get_available_keys、get_available_modifier_types、get_available_trigger_types 等方法发现可用的类型与按键。使用方式为在虚幻编辑器 Python 环境中(如 execute_python_code)导入 unreal 模块并调用 unreal.InputService 的静态方法,操作后通过 unreal.EditorAssetLibrary.save_asset 保存资产。资料还提供了示例脚本 scripts/setup_input.txt。适用场景包括以编程方式搭建或批量修改增强输入配置、检查输入资产结构等。限制与注意事项:InputService 类文档字符串中列出的 MCP 风格动作标识(如 action_create)并非实际 Python 方法名,不要用 discover_python_class 按这些名称搜索;信息结构体的属性名需使用正确字段(如 value_types 应改为 action_value_types,key 应改为 key_name,modifier_type 应改为 type_name 或 display_name,trigger_type 应改为 type_name 或 display_name);按键名称需使用准确写法,不确定时用 get_available_keys 配合子串过滤验证;修饰器和触发器通过映射索引操作,需先获取映射列表。资料提及可选的外部 MCP 工具 unreal-engine-skills-manager,若当前会话存在则可加载以获取领域知识,若不存在则跳过,不影响本技能使用。