输入系统

Unigine引擎提供的众多特征之一便是高级输入API，其允许使用各种不同的输入设备按照相同的方法进行工作（例如键盘，鼠标，控制杆，手柄等）并同时使用这些设备的性能。由于可用性，所有由引擎识别的输入设备具有通用接口。对输入设备的控制可分配给虚拟世界中确切的用户行为。应用程序需要对使用GUI激活的控制进行编辑。

输入脚本位于Unigine SDK的data/scripts/input目录下。

Input device

Input device（输入设备）#

Input

Input（输入）#

Action

Action（动作）#

保存在XML文件中的配置语法如下：

<controls>
	<action name="accelerate">
		<input device="Logitec Racing Wheel" state="3" min="1" max="-1"/>
		<input device="Keyboard" state="119"/>
	</action>
	<action name="brake">
		<input device="Logitec Racing Wheel" state="2" min="1" max="-1"/>
		<input device="Keyboard" state="115"/>
	</action>
</controls>

Сontrols 标签用来描述控制动作的贴图。Action标签也包括在此标签内。

Action标签描述动作配置，通过动作名称进行识别（需要名称属性）。Action标签可包含Input标签。

Input标签包含输入配置。其具有下列属性：

• Device（设备）是一种所需属性。其指定输入设备的名称并被用来识别输入设备。将键盘 和 鼠标指定为输入设备对于所有类型的键盘和鼠标已足够。
• State（状态）是一种所需属性。其指定输入设备状态号码并用来将输入映射到特定的输入设备轴或按钮上。
  注意

  无法直接使用按钮的名称，因为每种输入设备具有其自己的状态和状态名称。状态及状态名基于安装的驱动。考虑到这些因素，因而名称并不具有通用性。
  然而可使用GUI接口编辑控制。这种情况下，无需指定确切的状态编号且可以看见输入的状态名称。
• Min是一种可选属性。其指定最小输入设备轴的值。
• Max 是一种可选属性。其指定最大输入设备轴的值。
• Neutral 在输入不活跃时，指定中间值。默认为0。
• Threshold以十进制单位指定用于对输入设备进行响应的线程。默认值为0.2。
• Change_speed 是一种可选属性。其指定轴的更改速度。
• Return_speed 是一种可选属性。其指定轴的回退速度。

Step 1. Include the required input devices headers

第一步：包括所需输入设备的首部：#

#include <scripts/input/input_device.h>
#include <scripts/input/control.h>

Step 2. Add initialization, update and shutdown handlers to corresponding code sections

第二步：添加初始化，更新并关闭处理器来初始化代码：#

Unigine::Input::init();
Unigine::Input::update();
Unigine::Input::shutdown();

Step 3. Create controls config files

第三步：创建控制配置文件：#

<?xml version="1.0" encoding="utf-8"?>
<controls_def>
	<action_def name="accelerating" min="0" max="1" neutral="0" type="state"/>
</controls_def>

<?xml version="1.0" encoding="utf-8"?>
<controls definition="/config/controls/controls_def">
<controls>
	<action name="accelerate"/>
	<action name="brake"/>
	<!-- etc. -->
</controls>

Step 4. Adding and integrating controls

第四步。#

// 初始代码中的某处
Control control = new Control();
control.loadFromFile("you_config_file.xml");

// 更新代码中的某处
control.update(engine.game.getIFps())

Action action = control.getAction("accelerate");
current_car.setAccelerator(action.getState());
action = control.getActionByName("brake");
current_car.setBrake(action.getState());
// 等等。

Editing the controls using GUI interface

使用GUI接口编辑控制#

#include <scripts/input/control_setup_window.h>

Unigine::Input::ControlSetupWindow::init(engine.getGui());
Unigine::Input::ControlSetupWindow::update();
Unigine::Input::ControlSetupWindow::shutdown();

void cotroller_setup_button_clicked() {
	if(controller_setup_button.isToggled()) {
		// 显示窗口
		Unigine::Input::ControlSetupWindow::addOnHideCallback("TestCarGui::on_save_car_controls",NULL);
		Unigine::Input::ControlSetupWindow::show(control); // 参看上述控制定义
	} else {
		// 隐藏窗口
		Unigine::Input::ControlSetupWindow::hide();
	}
}