GameController Naamruimte
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers.
Klassen
| Naam | Description |
|---|---|
| GCColor |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCController |
Een gamecontroller, zowel form-fitting als extended wireless. |
| GCController.Notifications |
Meldingen die door de GCController klas zijn gepost. |
| GCControllerAxisInput |
Een GCControllerElement vertegenwoordiging van een joystick. |
| GCControllerButtonInput |
Een GCControllerElement weergave van een gamecontrollerknop. |
| GCControllerDirectionPad |
Een GCControllerElement vertegenwoordiging van een direction-pad. |
| GCControllerElement |
De basisklasse voor invoerelementen van een gamecontroller. |
| GCControllerHomeButtonSettingsManager |
Biedt toegang tot de systeeminstellingen voor het gedrag van de startknop van de controller. |
| GCControllerInputState |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerLiveInput |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerTouchpad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerUserCustomizations |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerUserCustomizations.Notifications |
Meldingen die door de GCControllerUserCustomizations klas zijn gepost. |
| GCDeviceBattery |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDeviceCursor |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDeviceHaptics |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDeviceLight |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDirectionalGamepad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseAdaptiveTrigger |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseGamepad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualShockGamepad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCEventInteraction |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCEventViewController |
De controller weergeven waarmee de levering van gebeurtenissen tussen de responderketen en de gamecontroller kan worden overgeschakeld. |
| GCExtendedGamepad |
Een gamepad met twee schouderknoppen, twee triggers, twee duimsticks, een D-Pad en een directionele knopmatrix. |
| GCExtendedGamepadSnapshot |
Een serialiseerbare momentopname van de status van de gamecontroller. |
| GCGameControllerActivationContext |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCGameControllerSceneDelegate |
Dit is een klasse die de interface IGCGameControllerSceneDelegate implementeert (voor het protocol Subklasse van deze klasse om eenvoudig een type te maken waarmee het protocol wordt geïmplementeerd. Een alternatief is om een subklasse van NSObject en vervolgens de interface IGCGameControllerSceneDelegatete implementeren. |
| GCGamepad |
Een gamepad met twee schouderknoppen, een D-Pad en een directionele knopmatrix.. |
| GCGamepadSnapshot |
Een serialiseerbare momentopname van de status van de gamecontroller. |
| GCGearShifterElement |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCHapticsLocality |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInput |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputAxisNameExtensions |
Extensiemethoden voor de GCInputAxisName opsomming. |
| GCInputButtonNameExtensions |
Extensiemethoden voor de GCInputButtonName opsomming. |
| GCInputDirectionalExtensions |
Extensiemethoden voor de GCInputDirectional opsomming. |
| GCInputDirectionPadNameExtensions |
Extensiemethoden voor de GCInputDirectionPadName opsomming. |
| GCInputElementNameExtensions |
Extensiemethoden voor de GCInputElementName opsomming. |
| GCInputMicroGamepadExtensions |
Extensiemethoden voor de GCInputMicroGamepad opsomming. |
| GCInputXbox |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCKey |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCKeyboard |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCKeyboard.Notifications |
Meldingen die door de GCKeyboard klas zijn gepost. |
| GCKeyboardInput |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCKeyCode |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCMicroGamepad |
Een logische toewijzing van hardwarecontrollerbesturingselementen aan een set in-game elementen. |
| GCMicroGamepadSnapshot |
Hiermee worden momentopnamen van de status van een micro-gamepad ophaalt. |
| GCMotion |
Bevat positiegegevens van een gamecontroller. |
| GCMouse |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCMouse.Notifications |
Meldingen die door de GCMouse klas zijn gepost. |
| GCMouseInput |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType> |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCPhysicalInputProfile |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCProductCategory |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCRacingWheel |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCRacingWheel.Notifications |
Meldingen die door de GCRacingWheel klas zijn gepost. |
| GCRacingWheelInput |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCRacingWheelInputState |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCSteeringWheelElement |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCVirtualController |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCVirtualControllerConfiguration |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCVirtualControllerElementConfiguration |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCXboxGamepad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| UISceneConnectionOptions_GameController |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
Structs
| Naam | Description |
|---|---|
| GCAcceleration |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseAdaptiveTriggerPositionalAmplitudes |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseAdaptiveTriggerPositionalResistiveStrengths |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCExtendedGamepadSnapshotData |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCExtendedGamepadSnapShotDataV100 |
De toestand van een GCExtendedGamepad. Geproduceerd door TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100). |
| GCGamepadSnapShotDataV100 |
De toestand van een GCGamepad. Geproduceerd door TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100). |
| GCMicroGamepadSnapshotData |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCMicroGamepadSnapShotDataV100 |
Vertegenwoordigt de onmiddellijke status van een micro gamepad in V100-indeling op een bepaald moment. |
| GCPoint2 |
Vertegenwoordigt een geordende paar drijvendekomma x- en y-coördinaten die een punt in een tweedimensionaal vlak definiëren. |
| GCQuaternion |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCRotationRate |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
Interfaces
| Naam | Description |
|---|---|
| IGCAxis2DInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCAxisElement |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCAxisInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCButtonElement |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCDevice |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCDevicePhysicalInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCDevicePhysicalInputState |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCDevicePhysicalInputStateDiff |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCDirectionPadElement |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCGameControllerSceneDelegate |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCLinearInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCPhysicalInputElement |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCPhysicalInputSource |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCPressedStateInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCRelativeInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCSwitchElement |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCSwitchPositionInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
| IGCTouchedStateInput |
Deze interface vertegenwoordigt het Objective-C-protocol |
Enums
| Naam | Description |
|---|---|
| GCControllerHomeButtonSettingCustomizationStatus |
Hiermee geeft u op of de gebruiker een instelling voor de knop Start van de controller heeft aangepast. |
| GCControllerHomeButtonSettingInAppAction |
Hiermee geeft u op hoe het systeem reageert op een knop Start van de controller terwijl de toepassing het meest vooraan staat. |
| GCControllerHomeButtonSettingsCustomizationActivity |
Hiermee geeft u de instelling van de knop Start van de controller op die u wilt aanpassen. |
| GCControllerHomeButtonSettingSystemAction |
Hiermee geeft u de systeemactie uitgevoerd in reactie op een knop Start van de controller. |
| GCControllerPlayerIndex |
Inventariseert indexen van de spelercontroller. |
| GCDeviceBatteryState |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDevicePhysicalInputElementChange |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseAdaptiveTriggerMode |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCDualSenseAdaptiveTriggerStatus |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCExtendedGamepadSnapshotDataVersion |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputAxisName |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputButtonName |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputDirectional |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputDirectionPadName |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputElementName |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCInputMicroGamepad |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCMicroGamepadSnapshotDataVersion |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCPhysicalInputSourceDirection |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCSystemGestureState |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCTouchState |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCUIEventTypes |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
Gedelegeerden
| Naam | Description |
|---|---|
| ElementValueDidChangeHandler |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCAxis2DInputValueDidChangeCallback |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerAxisValueChangedHandler |
De gemachtigde die wordt gebruikt als de handler ValueChangedHandlervoor waarde gewijzigd. |
| GCControllerButtonTouchedChanged |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCControllerButtonValueChanged |
Gemachtigde voor ValueChangedHandler en PressedChangedHandler. |
| GCControllerDirectionPadValueChangedHandler |
De gemachtigde die wordt gebruikt als de handler ValueChangedHandlervoor waarde gewijzigd. |
| GCControllerHomeButtonSettingsDidChangeHandler |
Handler die wordt aangeroepen nadat de knopinstellingen van de controller zijn gewijzigd. |
| GCControllerTouchpadHandler |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCExtendedGamepadValueChangedHandler |
De gemachtigde die wordt gebruikt als de handler ValueChangedHandlervoor waarde gewijzigd. |
| GCGamepadValueChangedHandler |
De gemachtigde die wordt gebruikt als de handler ValueChangedHandlervoor waarde gewijzigd. |
| GCKeyboardValueChangedHandler |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCMicroGamepadValueChangedHandler |
Een handler die wordt aangeroepen wanneer één element van een controller wordt gewijzigd. |
| GCMouseMoved |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| GCVirtualControllerElementUpdateBlock |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
| InputStateAvailableHandler |
De GameController-naamruimte biedt ondersteuning voor externe gamecontrollers. |
Opmerkingen
Gamecontrollers worden geleverd in twee vormen: "form-fitting" controllers die een iOS-apparaat en "uitgebreide draadloze" controllers bevatten die draadloos verbinding maken met een iOS-apparaat of een Mac.
Gamecontrollers moeten optionele onderdelen zijn: gameontwikkelaars moeten hun game speelbaar maken door gebruikers die geen gamecontrollers hebben.
Formulierinrichtingscontrollers worden automatisch gedetecteerd door het systeem. Uitgebreide draadloze controllers worden gedetecteerd door het systeem na het aanroepen StartWirelessControllerDiscovery van de toepassingsontwikkelaar en zorgen ervoor dat de ObserveDidConnect meldingshandler wordt geactiveerd. Wanneer draadloze controllers de verbinding verbreken, wordt de ObserveDidDisconnect melding geactiveerd.
Er zijn twee ondersteunde profielen voor Game Controllers: GCGamepad en GCExtendedGamepad. A GCController heeft een niet-null-waarde voor Gamepad de eigenschap of ExtendedGamepad eigenschap, de ontwikkelaar van de toepassing moet deze lezen om het type te bepalen.
GCGamepads hebben twee schouderknoppen, een D-pad (zie GCControllerDirectionPad) en 4 gezichtsknoppen met het label Y-B-A-X.
GCExtendedGamepads hebben dezelfde elementen, plus twee triggerknoppen en twee joysticks (zie GCControllerAxisInput). Apple-conceptuele schema's tonen bovendien een LED-matrix, maar er is momenteel geen programmatische toegang tot dit element.
Er zijn drie manieren om gamecontrollergegevens te lezen:
| Technique | Methode(en) | Gebruiken |
|---|---|---|
| Navragen | Eigenschappen zoals IsPressed of XAxis | Rechtstreeks lezen uit de game-lus (zie Update). |
| Gebeurtenisgestuurd | Eigenschap van ValueChangedHandler element (zoals ValueChangedHandler) | Game Controller verwerkt updates op de hoofdthread. Het framework zorgt ervoor dat gelijktijdig optredende gebeurtenissen resulteren in een reeks enkele callbacks. |
| Gecoördineerde momentopname | SaveSnapshot, SaveSnapshot | Momentopnamen van de controllerstatus. Geschikt voor marshalling, serialisatie of vertraagde verwerking. |
De belangrijkste klassen in de gamecontrollernaamruimte worden weergegeven in de volgende afbeelding:
