GameController Espace de noms

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

L’espace de noms GameController prend en charge les contrôleurs de jeu externes.

Classes

Nom	Description
GCColor	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCController	Un contrôleur de jeu, adapté aux formulaires ou étendu sans fil.
GCController.Notifications	Notifications publiées par la GCController classe.
GCControllerAxisInput	Représentant GCControllerElement un joystick.
GCControllerButtonInput	Représentant GCControllerElement un bouton de contrôleur de jeu.
GCControllerDirectionPad	Représentant GCControllerElement un panneau de direction.
GCControllerElement	Classe de base pour les éléments d’entrée d’un contrôleur de jeu.
GCControllerHomeButtonSettingsManager	Fournit l’accès aux paramètres système pour le comportement du bouton Accueil du contrôleur.
GCControllerInputState	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerLiveInput	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerTouchpad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerUserCustomizations	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerUserCustomizations.Notifications	Notifications publiées par la GCControllerUserCustomizations classe.
GCDeviceBattery	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDeviceCursor	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDeviceHaptics	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDeviceLight	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDirectionalGamepad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseAdaptiveTrigger	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseGamepad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualShockGamepad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCEventInteraction	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCEventViewController	Affichez le contrôleur qui peut basculer la distribution d’événements entre la chaîne de répondeur et le contrôleur de jeu.
GCExtendedGamepad	Boîtier de commande avec deux boutons d’épaule, deux déclencheurs, deux bâtons de pouce, un D-Pad et un tableau de boutons directionnels.
GCExtendedGamepadSnapshot	Capture instantanée sérialisable de l’état du contrôleur de jeu.
GCGameControllerActivationContext	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCGameControllerSceneDelegate	Il s’agit d’une classe qui implémente l’interface IGCGameControllerSceneDelegate (pour le protocole `GCGameControllerSceneDelegate`). Sous-classe cette classe pour créer facilement un type qui implémente le protocole. Une alternative consiste à créer une sous-classe de NSObject l’interface, puis à implémenter l’interface IGCGameControllerSceneDelegate.
GCGamepad	Un boîtier de commande avec deux boutons d’épaule, un D-Pad et un tableau de boutons directionnels..
GCGamepadSnapshot	Capture instantanée sérialisable de l’état du contrôleur de jeu.
GCGearShifterElement	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCHapticsLocality	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInput	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputAxisNameExtensions	Méthodes d’extension pour l’énumération GCInputAxisName .
GCInputButtonNameExtensions	Méthodes d’extension pour l’énumération GCInputButtonName .
GCInputDirectionalExtensions	Méthodes d’extension pour l’énumération GCInputDirectional .
GCInputDirectionPadNameExtensions	Méthodes d’extension pour l’énumération GCInputDirectionPadName .
GCInputElementNameExtensions	Méthodes d’extension pour l’énumération GCInputElementName .
GCInputMicroGamepadExtensions	Méthodes d’extension pour l’énumération GCInputMicroGamepad .
GCInputXbox	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCKey	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCKeyboard	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCKeyboard.Notifications	Notifications publiées par la GCKeyboard classe.
GCKeyboardInput	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCKeyCode	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCMicroGamepad	Mappage logique des contrôles de contrôleur de matériel à un ensemble d’éléments dans le jeu.
GCMicroGamepadSnapshot	Obtient des captures instantanées de l’état d’un micro-boîtier de commande.
GCMotion	Contient les données de position d’un contrôleur de jeu.
GCMouse	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCMouse.Notifications	Notifications publiées par la GCMouse classe.
GCMouseInput	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType>	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCPhysicalInputProfile	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCProductCategory	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCRacingWheel	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCRacingWheel.Notifications	Notifications publiées par la GCRacingWheel classe.
GCRacingWheelInput	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCRacingWheelInputState	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCSteeringWheelElement	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCVirtualController	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCVirtualControllerConfiguration	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCVirtualControllerElementConfiguration	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCXboxGamepad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
UISceneConnectionOptions_GameController	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.

Structures

Nom	Description
GCAcceleration	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseAdaptiveTriggerPositionalAmplitudes	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseAdaptiveTriggerPositionalResistiveStrengths	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCExtendedGamepadSnapshotData	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCExtendedGamepadSnapShotDataV100	État d’un GCExtendedGamepad. Produit par TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100).
GCGamepadSnapShotDataV100	État d’un GCGamepad. Produit par TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100).
GCMicroGamepadSnapshotData	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCMicroGamepadSnapShotDataV100	Représente l’état instantané d’un micro boîtier de commande au format V100 à un moment donné.
GCPoint2	Représente une paire ordonnée de coordonnées x et y à virgule flottante qui définit un point dans un plan bidimensionnel.
GCQuaternion	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCRotationRate	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.

Interfaces

Nom	Description
IGCAxis2DInput	Cette interface représente le protocole `GCAxis2DInput`Objective-C .
IGCAxisElement	Cette interface représente le protocole `GCAxisElement`Objective-C .
IGCAxisInput	Cette interface représente le protocole `GCAxisInput`Objective-C .
IGCButtonElement	Cette interface représente le protocole `GCButtonElement`Objective-C .
IGCDevice	Cette interface représente le protocole `GCDevice`Objective-C .
IGCDevicePhysicalInput	Cette interface représente le protocole `GCDevicePhysicalInput`Objective-C .
IGCDevicePhysicalInputState	Cette interface représente le protocole `GCDevicePhysicalInputState`Objective-C .
IGCDevicePhysicalInputStateDiff	Cette interface représente le protocole `GCDevicePhysicalInputStateDiff`Objective-C .
IGCDirectionPadElement	Cette interface représente le protocole `GCDirectionPadElement`Objective-C .
IGCGameControllerSceneDelegate	Cette interface représente le protocole `GCGameControllerSceneDelegate`Objective-C .
IGCLinearInput	Cette interface représente le protocole `GCLinearInput`Objective-C .
IGCPhysicalInputElement	Cette interface représente le protocole `GCPhysicalInputElement`Objective-C .
IGCPhysicalInputSource	Cette interface représente le protocole `GCPhysicalInputSource`Objective-C .
IGCPressedStateInput	Cette interface représente le protocole `GCPressedStateInput`Objective-C .
IGCRelativeInput	Cette interface représente le protocole `GCRelativeInput`Objective-C .
IGCSwitchElement	Cette interface représente le protocole `GCSwitchElement`Objective-C .
IGCSwitchPositionInput	Cette interface représente le protocole `GCSwitchPositionInput`Objective-C .
IGCTouchedStateInput	Cette interface représente le protocole `GCTouchedStateInput`Objective-C .

Énumérations

Nom	Description
GCControllerHomeButtonSettingCustomizationStatus	Spécifie si l’utilisateur a personnalisé un paramètre de bouton Accueil du contrôleur.
GCControllerHomeButtonSettingInAppAction	Spécifie la façon dont le système répond à un bouton Accueil du contrôleur pendant que l’application est la plus frontale.
GCControllerHomeButtonSettingsCustomizationActivity	Spécifie le paramètre du bouton Accueil du contrôleur à personnaliser.
GCControllerHomeButtonSettingSystemAction	Spécifie l’action système effectuée en réponse à une pression sur le bouton Accueil du contrôleur.
GCControllerPlayerIndex	Énumère les index du contrôleur de lecteur.
GCDeviceBatteryState	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDevicePhysicalInputElementChange	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseAdaptiveTriggerMode	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCDualSenseAdaptiveTriggerStatus	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCExtendedGamepadSnapshotDataVersion	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputAxisName	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputButtonName	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputDirectional	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputDirectionPadName	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputElementName	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCInputMicroGamepad	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCMicroGamepadSnapshotDataVersion	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCPhysicalInputSourceDirection	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCSystemGestureState	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCTouchState	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCUIEventTypes	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.

Délégués

Nom	Description
ElementValueDidChangeHandler	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCAxis2DInputValueDidChangeCallback	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerAxisValueChangedHandler	Délégué utilisé comme gestionnaire modifié par valeur pour ValueChangedHandler.
GCControllerButtonTouchedChanged	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCControllerButtonValueChanged	Délégué pour ValueChangedHandler et PressedChangedHandler.
GCControllerDirectionPadValueChangedHandler	Délégué utilisé comme gestionnaire modifié par valeur pour ValueChangedHandler.
GCControllerHomeButtonSettingsDidChangeHandler	Gestionnaire appelé après la modification des paramètres du bouton Accueil du contrôleur.
GCControllerTouchpadHandler	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCExtendedGamepadValueChangedHandler	Délégué utilisé comme gestionnaire modifié par valeur pour ValueChangedHandler.
GCGamepadValueChangedHandler	Délégué utilisé comme gestionnaire modifié par valeur pour ValueChangedHandler.
GCKeyboardValueChangedHandler	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCMicroGamepadValueChangedHandler	Gestionnaire appelé chaque fois qu’un seul élément d’un contrôleur change.
GCMouseMoved	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
GCVirtualControllerElementUpdateBlock	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.
InputStateAvailableHandler	L’espace de noms GameController prend en charge les contrôleurs de jeu externes.

Remarques

Les contrôleurs de jeu sont fournis sous deux formes : les contrôleurs « ajustement de formulaire » qui contiennent un appareil iOS et des contrôleurs « sans fil étendus » qui se connectent sans fil à un appareil iOS ou à un Mac.

Les contrôleurs de jeu doivent être des composants facultatifs : les développeurs de jeux doivent rendre leur jeu jouable par les utilisateurs qui n’ont pas de contrôleurs de jeu.

Les contrôleurs d’ajustement de formulaire sont automatiquement détectés par le système. Les contrôleurs sans fil étendus sont découverts par le système après l’appel StartWirelessControllerDiscovery du développeur d’applications et entraînent le déclenchement du ObserveDidConnect gestionnaire de notification. Lorsque les contrôleurs sans fil se déconnectent, la ObserveDidDisconnect notification se déclenche.

Il existe deux profils pris en charge pour les contrôleurs de jeu : GCGamepad et GCExtendedGamepad. Une GCController valeur non null est définie pour sa propriété ou sa Gamepad ExtendedGamepad propriété, le développeur de l’application doit les lire pour déterminer le type.

GCGamepaddeux boutons d’épaule, un pavé D (voir GCControllerDirectionPad) et 4 boutons visages étiquetés Y-B-A-X.

GCExtendedGamepadont les mêmes éléments, plus deux boutons de déclencheur et deux joysticks (voir GCControllerAxisInput). Les schémas conceptuels Apple affichent également un tableau LED, mais il n’existe actuellement aucun accès programmatique à cet élément.

Il existe trois façons de lire les données du contrôleur de jeu :

Technique	Méthode(s)	Utiliser
Sondages	Propriétés telles que IsPressed ou XAxis	Lecture directe à partir de la boucle de jeu (voir Update).
Piloté par les événements	Propriété de l’élément `ValueChangedHandler` (par exemple ValueChangedHandler)	Game Controller traite les mises à jour sur le thread principal. L’infrastructure garantit que les événements qui se produisent simultanément entraînent une série de rappels uniques.
Instantané coordonné	SaveSnapshot, SaveSnapshot	Capture un instantané de l’état du contrôleur. Approprié pour le marshaling, la sérialisation ou le traitement différé.

Les classes principales de l’espace de noms Game Controller sont présentées dans l’illustration suivante :