GameInput
Las API de GameInput se usan para capturar la entrada humana desde una amplia gama de dispositivos, como mandos de juego, sticks de vuelo, volantes de carreras y entrada táctil.Esta página documenta la API de GameInput actual (más reciente). El historial de versiones de cada miembro se indica en las páginas de referencia individuales. Los miembros que solo existían en versiones anteriores de la API se enumeran en la sección Miembros quitados que aparece a continuación. Tenga en cuenta que los tiempos de ejecución más recientes de la API admiten todas las versiones disponibles de la API, por lo que los miembros quitados todavía se pueden usar con los encabezados de las versiones anteriores.
Interfaces
| Interfaz | Descripción |
|---|---|
| IGameInputDevice | Define un dispositivo de entrada. |
| IGameInputDispatcher | Proporciona control manual sobre la programación de las tareas en segundo plano administradas por la API de GameInput. |
| IGameInputForceFeedbackEffect | Describe un efecto de retroalimentación de fuerza en un dispositivo de entrada compatible. |
| IGameInputMapper | Proporciona información sobre cómo GameInput asigna un dispositivo. |
| IGameInputRawDeviceReport | Representa un búfer de bytes sin procesar que se pasa a un dispositivo de entrada o desde este. |
| IGameInputReading | Contiene los datos de una única actualización de entrada. |
| IGameInput | Un singleton por proceso que proporciona acceso a la secuencia de entrada del dispositivo. |
Funciones
| Función | Descripción |
|---|---|
| GameInputCreate | Recupera una instancia de la interfaz IGameInput. |
| GameInputDeviceCallback | Define una devolución de llamada para los eventos de conexión y desconexión de dispositivos. |
| GameInputKeyboardLayoutCallback | Define una devolución de llamada para los eventos de cambio de distribución del teclado. |
| GameInputReadingCallback | Define una devolución de llamada para los eventos de llegada de nuevas lecturas. |
| GameInputSystemButtonCallback | Define una devolución de llamada para los eventos de presión y liberación del botón de guía o del botón de compartir. |
Estructuras
| Estructura | Descripción |
|---|---|
| GameInputArcadeStickInfo | Detalla las características de un stick arcade. |
| GameInputArcadeStickState | Proporciona el estado actual de un stick arcade. |
| GameInputAxisMapping | Describe cómo se asigna un eje al mando. |
| GameInputButtonMapping | Describe cómo se asigna un botón al mando. |
| GameInputControllerInfo | Detalla las características de un mando. |
| GameInputControllerSwitchInfo | Especifica un conmutador en un dispositivo de entrada. |
| GameInputDeviceInfo | Contiene información completa sobre un dispositivo de entrada. |
| GameInputFlightStickInfo | Detalla las características de un stick de vuelo. |
| GameInputFlightStickState | Proporciona el estado actual de un stick de vuelo. |
| GameInputForceFeedbackConditionParams | Define ciertos aspectos físicos de un efecto de retroalimentación de fuerza. |
| GameInputForceFeedbackConstantParams | Define un aspecto físico constante de un efecto de retroalimentación de fuerza. |
| GameInputForceFeedbackEnvelope | Define una envolvente que modifica un efecto de retroalimentación de fuerza. |
| GameInputForceFeedbackMagnitude | Define la magnitud de la fuerza ejercida por un efecto de retroalimentación de fuerza. |
| GameInputForceFeedbackMotorInfo | Proporciona información sobre el motor de retroalimentación de fuerza. |
| GameInputForceFeedbackParams | Define los atributos compatibles con la API de un efecto de retroalimentación de fuerza. |
| GameInputForceFeedbackPeriodicParams | Define los parámetros de un efecto periódico de retroalimentación de fuerza. |
| GameInputForceFeedbackRampParams | Define los parámetros de un efecto de rampa de retroalimentación de fuerza. |
| GameInputGamepadInfo | Detalla las características de un mando. |
| GameInputGamepadState | Proporciona el estado actual de un dispositivo de entrada de tipo mando. |
| GameInputHapticInfo | Detalla las características de un motor de retroalimentación háptica. |
| GameInputKeyState | Proporciona el estado actual de una tecla de un teclado. |
| GameInputKeyboardInfo | Detalla las características de un teclado. |
| GameInputMouseInfo | Detalla las características de un mouse. |
| GameInputMouseState | Proporciona el estado actual de un mouse. |
| GameInputRacingWheelInfo | Detalla las características de un volante de carreras. |
| GameInputRacingWheelState | Proporciona el estado actual de un volante de carreras. |
| GameInputRawDeviceReportInfo | Describe un informe de dispositivo sin procesar. |
| GameInputRumbleParams | Describe un efecto de vibración producido por un mando. |
| GameInputSensorsInfo | Detalla las características de los sensores disponibles. |
| GameInputSensorsState | Proporciona el estado actual de los sensores de un dispositivo. |
| GameInputUsage | Describe un uso HID específico. |
| GameInputVersion | Describe un número de versión de cuatro partes. |
Enumeraciones
| Enumeración | Descripción |
|---|---|
| GameInputArcadeStickButtons | Enumera las entradas de un stick arcade. |
| GameInputDeviceFamily | Enumera las familias de dispositivos de entrada. |
| GameInputDeviceStatus | Enumera los estados en los que puede encontrarse un dispositivo de entrada. |
| GameInputElementKind | Enumera el tipo de elemento de una entrada determinada. |
| GameInputEnumerationKind | Enumera los tipos de comportamiento para enumerar dispositivos de entrada. |
| GameInputFeedbackAxes | Enumera los tipos de dirección de los motores de retroalimentación de fuerza disponibles en un dispositivo de entrada. |
| GameInputFeedbackEffectState | Enumera los estados de un efecto de retroalimentación de fuerza. |
| GameInputFlightStickAxes | Enumera los ejes de un stick de vuelo. |
| GameInputFlightStickButtons | Enumera los botones de un stick de vuelo. |
| GameInputFocusPolicy | Enumera las directivas de foco de un dispositivo de entrada. |
| GameInputForceFeedbackEffectKind | Enumera los tipos de efectos de magnitud a lo largo del tiempo que se pueden aplicar a un efecto de retroalimentación de fuerza. |
| GameInputGamepadAxes | Enumera los ejes de un mando. |
| GameInputGamepadButtons | Enumera los botones del mando, incluida la cruz direccional. |
| GameInputKeyboardKind | Enumera los tipos de teclado por distribución de teclas. |
| GameInputKind | Enumera los tipos de dispositivos de GameInput válidos. |
| GameInputLabel | Enumera las etiquetas de botón compatibles. |
| GameInputMouseButtons | Enumera los botones del mouse. |
| GameInputMousePositions | Enumera los modos de posicionamiento del mouse. |
| GameInputRacingWheelAxes | Enumera los ejes de un volante de carreras. |
| GameInputRacingWheelButtons | Enumera los botones de un volante de carreras. |
| GameInputRawDeviceReportKind | Enumera los tipos de informes de dispositivo sin procesar. |
| GameInputRumbleMotors | Enumera los motores de vibración compatibles con la API para un dispositivo de entrada. |
| GameInputSensorAccuracy | Enumera los niveles de precisión de los sensores. |
| GameInputSensorsKind | Enumera los tipos de sensores válidos de GameInput. |
| GameInputSwitchKind | Enumera los tipos de conmutadores compatibles con un dispositivo de entrada. |
| GameInputSwitchPosition | Enumera las posiciones de un conmutador en un dispositivo de entrada. |
| GameInputSystemButtons | Enumera los botones que se usan para controlar el sistema. |
Miembros quitados
Los siguientes miembros estaban presentes en versiones anteriores de la API, pero se han quitado de la API actual. Para obtener la documentación completa de cada miembro quitado, consulte Miembros en desuso de la API de GameInput.Interfaces quitadas
No se ha quitado ninguna interfaz de forma permanente.IGameInputRawDeviceReport estaba ausente en v1 y v2, pero se ha vuelto a introducir en la API actual.
Funciones quitadas
| Función | Última versión | Descripción |
|---|---|---|
| GameInputGuideButtonCallback | v0 | Devolución de llamada definida por el título para los eventos del botón de guía. Reemplazada por GameInputSystemButtonCallback. |
Estructuras quitadas
| Estructura | Última versión | Descripción |
|---|---|---|
| GameInputBatteryState | v0 | Describía el estado de la batería de un dispositivo de entrada. |
| GameInputControllerAxisInfo | v2 | Describía un eje de un dispositivo de entrada. Reemplazada por campos de GameInputControllerInfo. |
| GameInputControllerButtonInfo | v2 | Describía un botón de un dispositivo de entrada. Reemplazada por campos de GameInputControllerInfo. |
| GameInputHapticFeedbackMotorInfo | v0 | Describía un motor de retroalimentación háptica. Reemplazada por GameInputHapticInfo. |
| GameInputHapticFeedbackParams | v0 | Describía un efecto de retroalimentación háptica. |
| GameInputHapticWaveformInfo | v0 | Describía las características de un efecto de retroalimentación háptica. |
| GameInputMotionInfo | v0 | Describía las propiedades medibles de un dispositivo de entrada habilitado para movimiento. |
| GameInputMotionState | v0 | Describía el estado de la entrada de movimiento. |
| GameInputRawDeviceItemCollectionInfo | v0 | Describía una colección de elementos de dispositivo sin procesar. |
| GameInputRawDeviceReportItemInfo | v0 | Describía un elemento de informe de dispositivo sin procesar. |
| GameInputString | v0 | Describía una cadena que contenía información sobre un dispositivo de entrada. |
| GameInputTouchSensorInfo | v0 | Describía un sensor táctil de un dispositivo de entrada. |
| GameInputTouchState | v0 | Describía el estado de un dispositivo de entrada táctil. |
| GameInputUiNavigationInfo | v2 | Especificaba las etiquetas de los botones de navegación en la interfaz de usuario. |
| GameInputUiNavigationState | v2 | Proporcionaba el estado actual de la entrada de navegación de la interfaz de usuario. |
Enumeraciones quitadas
| Enumeración | Última versión | Descripción |
|---|---|---|
| GameInputBatteryStatus | v0 | Enumeraba los estados de la batería de un dispositivo de entrada. |
| GameInputDeviceCapabilities | v0 | Enumeraba ciertas capacidades de un dispositivo de entrada. |
| GameInputLocation | v0 | Enumeraba las partes de un dispositivo de entrada. |
| GameInputMotionAccuracy | v0 | Enumeraba los niveles de precisión de los sensores de movimiento. |
| GameInputRawDeviceItemCollectionKind | v0 | Enumeraba los tipos de colecciones de elementos de dispositivo sin procesar. |
| GameInputRawDevicePhysicalUnitKind | v0 | Enumeraba las unidades físicas asociadas a la entrada de dispositivos. |
| GameInputRawDeviceReportItemFlags | v0 | Enumeraba los tipos de elementos de informe de dispositivo sin procesar. |
| GameInputTouchShape | v0 | Enumeraba las formas de un sensor táctil. |
| GameInputUiNavigationButtons | v2 | Enumeraba los botones de navegación de la interfaz de usuario. |
Historial de versiones
| Versión | Cambios |
|---|---|
| v3 | Se agregó la interfaz IGameInputMapper. Se volvió a introducir la interfaz IGameInputRawDeviceReport (estaba ausente en v1/v2). Se agregaron las estructuras GameInputAxisMapping, GameInputButtonMapping, GameInputControllerInfo y GameInputHapticInfo. Se volvieron a introducir la estructura GameInputRawDeviceReportInfo y la enumeración GameInputRawDeviceReportKind (ausentes en v1/v2). Se volvió a introducir la estructura GameInputVersion (ausente en v1/v2). Se agregaron las enumeraciones GameInputElementKind, GameInputFlightStickAxes, GameInputGamepadAxes y GameInputRacingWheelAxes. Se quitaron las estructuras GameInputControllerAxisInfo, GameInputControllerButtonInfo, GameInputUiNavigationInfo y GameInputUiNavigationState. Se quitó la enumeración GameInputUiNavigationButtons. |
| v2 | Se agregaron las estructuras GameInputSensorsInfo y GameInputSensorsState. Se agregaron las enumeraciones GameInputSensorsKind y GameInputSensorAccuracy. Se agregaron IGameInputDevice::DirectInputEscape e IGameInputDevice::GetHapticInfo. Se agregó IGameInputReading::GetSensorsState. Se volvió a introducir la estructura GameInputVersion (estaba ausente en v1). |
| v1 | Se quitaron la interfaz IGameInputRawDeviceReport, la estructura GameInputRawDeviceReportInfo y la enumeración GameInputRawDeviceReportKind. Se quitó la estructura GameInputVersion. Se agregó la enumeración GameInputMousePositions. Se quitaron los tipos de hápticos, movimiento y entrada táctil no implementados que existían solo en v0 (GameInputBatteryState, GameInputHapticFeedbackMotorInfo, GameInputHapticFeedbackParams, GameInputHapticWaveformInfo, GameInputMotionInfo, GameInputMotionState, GameInputTouchSensorInfo, GameInputTouchState, GameInputString, GameInputRawDeviceItemCollectionInfo, GameInputRawDeviceReportItemInfo). |
| v0 | Se introdujo. |