> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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`](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone) - [*object*](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone.md)，*可选*。不读取或不映射任何输入的区域的大小和形状。\
`sensitivity` - *number*，*可选*。响应曲线计算后应用的乘数。\
[`responseCurve` - *object*](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve)，*可选*。[响应曲线](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve.md)的形状。

### 输入值

| 常量 | 描述 |
| :- | :- |
| 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](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-accelerometer.md)\
[Gyroscope](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-gyroscope.md)\
[Joystick](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick.md)\
[Throttle](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle.md)
[Touchpad](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/controls/game-streaming-touch-touchpad.md)

## 另请参阅

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


## Related topics

- [ThrottleAxis](https://docs.xbox.com/zh-CN/reference/system/touchadaptationkit/types/game-streaming-touch-throttle-axis.md)
- [GetControllerAxisCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxiscount.md)
- [GetControllerAxisState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)
- [GameInputControllerAxisInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [D3D12_AXIS_SHADING_RATE (XBOX Series consoles)](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/enums/d3d12_axis_shading_rate_public.md)