> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Axis

> Axis

# Axis

触控控件到等效物理模拟控件的映射定义。

## 属性

[`input`- *string*](#inputs)。该控件接受的触控[输入](#inputs)类型。\
[`output` - *string*](#outputs)。该控件所映射到的手柄轴、单轴或极坐标操纵杆操作。\
[`deadzone`](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone) - [*object*](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone)，*可选*。不读取或不映射任何输入的区域的大小和形状。\
`sensitivity` - *number*，*可选*。响应曲线计算后应用的乘数。\
[`responseCurve` - *object*](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve)，*可选*。[响应曲线](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve)的形状。

### 输入值

| 常量 | 描述 |
| :- | :- |
| axisXY | 完整的 2D 输入，同时读取 X 轴和 Y 轴的值。 |
| axisX | 1D 输入，仅读取 X 轴值。 |
| axisY | 1D 输入，仅读取 Y 轴值。 |
| axisUp | 极坐标输入。 |
| axisDown | 极坐标输入。 |
| axisLeft | 极坐标输入。 |
| axisRight | 极坐标输入。 |

### 输出值

| 常量 | 描述 |
| :- | :- |
| leftJoystick | 到左操纵杆的 2D 输出。 |
| rightJoystick | 到右操纵杆的 2D 输出。 |
| leftJoystickX | 到左操纵杆 X 轴的 1D 输出。 |
| leftJoystickY | 到左操纵杆 Y 轴的 1D 输出。 |
| rightJoystickX | 到右操纵杆 X 轴的 1D 输出。 |
| rightJoystickY | 到左操纵杆 Y 轴的 1D 输出。 |
| leftJoystickLeft | 到左操纵杆左方向的极坐标输出。 |
| leftJoystickRight | 到左操纵杆右方向的极坐标输出。 |
| leftJoystickUp | 到左操纵杆上方向的极坐标输出。 |
| leftJoystickDown | 到左操纵杆下方向的极坐标输出。 |
| rightJoystickLeft | 到右操纵杆左方向的极坐标输出。 |
| rightJoystickRight | 到右操纵杆右方向的极坐标输出。 |
| rightJoystickUp | 到右操纵杆上方向的极坐标输出。 |
| rightJoystickDown | 到右操纵杆下方向的极坐标输出。 |
| relativeMouse | 到鼠标的 2D 输出。 |
| relativeMouseX | 到鼠标 X 轴的 1D 输出。 |
| relativeMouseY | 到鼠标 Y 轴的 2D 输出。 |
| relativeMouseLeft | 到鼠标左方向的极坐标输出。 |
| relativeMouseRight | 到鼠标右方向的极坐标输出。 |
| relativeMouseUp | 到鼠标上方向的极坐标输出。 |
| relativeMouseDown | 到鼠标下方向的极坐标输出。 |

## 备注

2D 输入必须映射到 2D 输出，同样 1D 输入必须映射到 1D 输出，单一方向必须映射到极坐标输出。

## 相关控件

[Accelerometer](/zh-CN/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-accelerometer)\
[Gyroscope](/zh-CN/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-gyroscope)\
[Joystick](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick)\
[Throttle](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle)
[Touchpad](/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-touchpad)

## 另请参阅

[Touch Adaptation Kit 参考](/zh-CN/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Deadzone](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone)\
[Response Curve](/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve)


## Related topics

- [GetExtraAxisIndexes](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)
- [GameInputAxisMapping](/reference/input/gameinput/structs/gameinputaxismapping.md)