GameController Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos.
Clases
| Nombre | Description |
|---|---|
| GCColor |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCController |
Un controlador de juego, ya sea de ajuste de formulario o inalámbrico extendido. |
| GCController.Notifications |
Notificaciones publicadas por la GCController clase . |
| GCControllerAxisInput |
que GCControllerElement representa un joystick. |
| GCControllerButtonInput |
que GCControllerElement representa un botón de controlador de juego. |
| GCControllerDirectionPad |
que GCControllerElement representa un panel de dirección. |
| GCControllerElement |
Clase base para los elementos de entrada de un controlador de juego. |
| GCControllerHomeButtonSettingsManager |
Proporciona acceso a la configuración del sistema para el comportamiento del botón Inicio del controlador. |
| GCControllerInputState |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerLiveInput |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerTouchpad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerUserCustomizations |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerUserCustomizations.Notifications |
Notificaciones publicadas por la GCControllerUserCustomizations clase . |
| GCDeviceBattery |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDeviceCursor |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDeviceHaptics |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDeviceLight |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDirectionalGamepad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseAdaptiveTrigger |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseGamepad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualShockGamepad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCEventInteraction |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCEventViewController |
Ver controlador que puede cambiar la entrega de eventos entre la cadena del respondedor y el controlador del juego. |
| GCExtendedGamepad |
Un controlador para juegos con dos botones de hombro, dos gatillos, dos sticks pulgares, un panel D y una matriz de botones direccionales. |
| GCExtendedGamepadSnapshot |
Instantánea serializable del estado del controlador de juego. |
| GCGameControllerActivationContext |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCGameControllerSceneDelegate |
Se trata de una clase que implementa la interfaz IGCGameControllerSceneDelegate (para el protocolo Subclase esta clase para crear fácilmente un tipo que implemente el protocolo. Una alternativa es crear una subclase de NSObject y, a continuación, implementar la interfaz IGCGameControllerSceneDelegate. |
| GCGamepad |
Controlador para juegos con dos botones de hombro, un D-Pad y una matriz de botones direccionales. |
| GCGamepadSnapshot |
Instantánea serializable del estado del controlador de juego. |
| GCGearShifterElement |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCHapticsLocality |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInput |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputAxisNameExtensions |
Métodos de extensión para la GCInputAxisName enumeración. |
| GCInputButtonNameExtensions |
Métodos de extensión para la GCInputButtonName enumeración. |
| GCInputDirectionalExtensions |
Métodos de extensión para la GCInputDirectional enumeración. |
| GCInputDirectionPadNameExtensions |
Métodos de extensión para la GCInputDirectionPadName enumeración. |
| GCInputElementNameExtensions |
Métodos de extensión para la GCInputElementName enumeración. |
| GCInputMicroGamepadExtensions |
Métodos de extensión para la GCInputMicroGamepad enumeración. |
| GCInputXbox |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCKey |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCKeyboard |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCKeyboard.Notifications |
Notificaciones publicadas por la GCKeyboard clase . |
| GCKeyboardInput |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCKeyCode |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCMicroGamepad |
Asignación lógica de controles de controlador de hardware a un conjunto de elementos en el juego. |
| GCMicroGamepadSnapshot |
Obtiene instantáneas del estado de un micro controlador para juegos. |
| GCMotion |
Contiene datos de posición de un controlador de juego. |
| GCMouse |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCMouse.Notifications |
Notificaciones publicadas por la GCMouse clase . |
| GCMouseInput |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType> |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCPhysicalInputProfile |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCProductCategory |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCRacingWheel |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCRacingWheel.Notifications |
Notificaciones publicadas por la GCRacingWheel clase . |
| GCRacingWheelInput |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCRacingWheelInputState |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCSteeringWheelElement |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCVirtualController |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCVirtualControllerConfiguration |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCVirtualControllerElementConfiguration |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCXboxGamepad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| UISceneConnectionOptions_GameController |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
Estructuras
| Nombre | Description |
|---|---|
| GCAcceleration |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseAdaptiveTriggerPositionalAmplitudes |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseAdaptiveTriggerPositionalResistiveStrengths |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCExtendedGamepadSnapshotData |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCExtendedGamepadSnapShotDataV100 |
Estado de .GCExtendedGamepad Generado por TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100). |
| GCGamepadSnapShotDataV100 |
Estado de .GCGamepad Generado por TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100). |
| GCMicroGamepadSnapshotData |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCMicroGamepadSnapShotDataV100 |
Representa el estado instantáneo de un micro controlador para juegos en formato V100 en un momento dado. |
| GCPoint2 |
Representa un par ordenado de coordenadas X e Y de punto flotante que define un punto en un plano bidimensional. |
| GCQuaternion |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCRotationRate |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
Interfaces
| Nombre | Description |
|---|---|
| IGCAxis2DInput |
Esta interfaz representa el protocolo |
| IGCAxisElement |
Esta interfaz representa el protocolo |
| IGCAxisInput |
Esta interfaz representa el protocolo |
| IGCButtonElement |
Esta interfaz representa el protocolo |
| IGCDevice |
Esta interfaz representa el protocolo |
| IGCDevicePhysicalInput |
Esta interfaz representa el protocolo |
| IGCDevicePhysicalInputState |
Esta interfaz representa el protocolo |
| IGCDevicePhysicalInputStateDiff |
Esta interfaz representa el protocolo |
| IGCDirectionPadElement |
Esta interfaz representa el protocolo |
| IGCGameControllerSceneDelegate |
Esta interfaz representa el protocolo |
| IGCLinearInput |
Esta interfaz representa el protocolo |
| IGCPhysicalInputElement |
Esta interfaz representa el protocolo |
| IGCPhysicalInputSource |
Esta interfaz representa el protocolo |
| IGCPressedStateInput |
Esta interfaz representa el protocolo |
| IGCRelativeInput |
Esta interfaz representa el protocolo |
| IGCSwitchElement |
Esta interfaz representa el protocolo |
| IGCSwitchPositionInput |
Esta interfaz representa el protocolo |
| IGCTouchedStateInput |
Esta interfaz representa el protocolo |
Enumeraciones
| Nombre | Description |
|---|---|
| GCControllerHomeButtonSettingCustomizationStatus |
Especifica si el usuario ha personalizado una configuración del botón Inicio del controlador. |
| GCControllerHomeButtonSettingInAppAction |
Especifica cómo responde el sistema a un botón Inicio del controlador mientras la aplicación está delante. |
| GCControllerHomeButtonSettingsCustomizationActivity |
Especifica la configuración del botón Inicio del controlador que se va a personalizar. |
| GCControllerHomeButtonSettingSystemAction |
Especifica la acción del sistema realizada en respuesta a la pulsación del botón Inicio del controlador. |
| GCControllerPlayerIndex |
Enumera los índices del controlador del reproductor. |
| GCDeviceBatteryState |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDevicePhysicalInputElementChange |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseAdaptiveTriggerMode |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCDualSenseAdaptiveTriggerStatus |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCExtendedGamepadSnapshotDataVersion |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputAxisName |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputButtonName |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputDirectional |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputDirectionPadName |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputElementName |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCInputMicroGamepad |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCMicroGamepadSnapshotDataVersion |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCPhysicalInputSourceDirection |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCSystemGestureState |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCTouchState |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCUIEventTypes |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
Delegados
| Nombre | Description |
|---|---|
| ElementValueDidChangeHandler |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCAxis2DInputValueDidChangeCallback |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerAxisValueChangedHandler |
Delegado que se usa como controlador de cambio de valor para ValueChangedHandler. |
| GCControllerButtonTouchedChanged |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCControllerButtonValueChanged |
Delegado para ValueChangedHandler y PressedChangedHandler. |
| GCControllerDirectionPadValueChangedHandler |
Delegado que se usa como controlador de cambio de valor para ValueChangedHandler. |
| GCControllerHomeButtonSettingsDidChangeHandler |
Controlador invocado después de cambiar la configuración del botón Inicio del controlador. |
| GCControllerTouchpadHandler |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCExtendedGamepadValueChangedHandler |
Delegado que se usa como controlador de cambio de valor para ValueChangedHandler. |
| GCGamepadValueChangedHandler |
Delegado que se usa como controlador de cambio de valor para ValueChangedHandler. |
| GCKeyboardValueChangedHandler |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCMicroGamepadValueChangedHandler |
Controlador al que se llama cada vez que cambia cualquier elemento único de un controlador. |
| GCMouseMoved |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| GCVirtualControllerElementUpdateBlock |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
| InputStateAvailableHandler |
El espacio de nombres GameController proporciona compatibilidad con controladores de juegos externos. |
Comentarios
Los controladores de juegos vienen en dos formas: controladores de "ajuste de formulario" que contienen un dispositivo iOS y controladores "inalámbricos extendidos" que se conectan de forma inalámbrica a un dispositivo iOS o un Equipo Mac.
Los controladores de juegos deben ser componentes opcionales: los desarrolladores de juegos deben hacer que los usuarios que no tengan controladores de juego puedan jugar.
El sistema detecta automáticamente los controladores de ajuste de formulario. El sistema detecta controladores inalámbricos extendidos posteriores a la llamada StartWirelessControllerDiscovery del desarrollador de aplicaciones y hará que el ObserveDidConnect controlador de notificaciones se active. Cuando los controladores inalámbricos se desconectan, se activa la ObserveDidDisconnect notificación.
Hay dos perfiles admitidos para controladores de juegos: GCGamepad y GCExtendedGamepad. Un GCController tendrá un valor distinto de null para su propiedad o para su ExtendedGamepadGamepad propiedad, el desarrollador de la aplicación debe leerlos para determinar el tipo.
GCGamepadtienen dos botones de hombro, una almohadilla D (vea GCControllerDirectionPad) y 4 botones de cara etiquetados como Y-B-A-X.
GCExtendedGamepadtienen los mismos elementos, además de dos botones de desencadenador y dos joysticks (vea GCControllerAxisInput). Además, los esquemas conceptuales de Apple muestran una matriz LED, pero actualmente no hay acceso mediante programación a este elemento.
Hay tres maneras de leer los datos del controlador de juego:
| Technique | Métodos | Use |
|---|---|---|
| Encuesta | Propiedades como IsPressed o XAxis | Lee directamente desde el bucle del juego (consulta Update). |
| Impulsado por eventos | Propiedad del ValueChangedHandler elemento (como ValueChangedHandler) | El controlador de juegos procesa las actualizaciones en el subproceso principal. El marco garantiza que los eventos que se producen simultáneamente dan lugar a una serie de devoluciones de llamada únicas. |
| Instantánea coordinada | SaveSnapshot, SaveSnapshot | Instantáneas del estado del controlador. Adecuado para serializar, serializar o retrasar el procesamiento. |
Las clases principales del espacio de nombres game controller se muestran en la siguiente ilustración:
