GameController Spazio dei nomi

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.

Classi

Nome	Descrizione
GCColor	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCController	Un controller di gioco, con montaggio del modulo o wireless esteso.
GCController.Notifications	Notifiche inviate dalla GCController classe .
GCControllerAxisInput	Oggetto GCControllerElement che rappresenta un joystick.
GCControllerButtonInput	Oggetto GCControllerElement che rappresenta un pulsante del controller di gioco.
GCControllerDirectionPad	Oggetto GCControllerElement che rappresenta un riquadro di direzione.
GCControllerElement	Classe di base per gli elementi di input di un controller di gioco.
GCControllerHomeButtonSettingsManager	Fornisce l'accesso alle impostazioni di sistema per il comportamento del pulsante Home del controller.
GCControllerInputState	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerLiveInput	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerTouchpad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerUserCustomizations	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerUserCustomizations.Notifications	Notifiche inviate dalla GCControllerUserCustomizations classe .
GCDeviceBattery	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDeviceCursor	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDeviceHaptics	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDeviceLight	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDirectionalGamepad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseAdaptiveTrigger	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseGamepad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualShockGamepad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCEventInteraction	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCEventViewController	Visualizzare il controller che può cambiare il recapito degli eventi tra la catena del risponditore e il controller di gioco.
GCExtendedGamepad	Un game pad con due pulsanti a spalla, due trigger, due levette, un D-Pad e una matrice di pulsanti direzionali.
GCExtendedGamepadSnapshot	Snapshot serializzabile dello stato del controller di gioco.
GCGameControllerActivationContext	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCGameControllerSceneDelegate	Si tratta di una classe che implementa l'interfaccia IGCGameControllerSceneDelegate (per il protocollo `GCGameControllerSceneDelegate`). Sottoclasse questa classe per creare facilmente un tipo che implementa il protocollo. Un'alternativa consiste nel creare una sottoclasse di NSObject e quindi implementare l'interfaccia IGCGameControllerSceneDelegate.
GCGamepad	Un game pad con due pulsanti a spalla, un D-Pad e una matrice di pulsanti direzionali.
GCGamepadSnapshot	Snapshot serializzabile dello stato del controller di gioco.
GCGearShifterElement	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCHapticsLocality	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInput	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputAxisNameExtensions	Metodi di estensione per l'enumerazione GCInputAxisName .
GCInputButtonNameExtensions	Metodi di estensione per l'enumerazione GCInputButtonName .
GCInputDirectionalExtensions	Metodi di estensione per l'enumerazione GCInputDirectional .
GCInputDirectionPadNameExtensions	Metodi di estensione per l'enumerazione GCInputDirectionPadName .
GCInputElementNameExtensions	Metodi di estensione per l'enumerazione GCInputElementName .
GCInputMicroGamepadExtensions	Metodi di estensione per l'enumerazione GCInputMicroGamepad .
GCInputXbox	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCKey	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCKeyboard	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCKeyboard.Notifications	Notifiche inviate dalla GCKeyboard classe .
GCKeyboardInput	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCKeyCode	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCMicroGamepad	Mapping logico dei controlli controller hardware a un set di elementi nel gioco.
GCMicroGamepadSnapshot	Ottiene gli snapshot dello stato di un micro game pad.
GCMotion	Contiene i dati sulla posizione di un controller di gioco.
GCMouse	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCMouse.Notifications	Notifiche inviate dalla GCMouse classe .
GCMouseInput	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType>	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCPhysicalInputProfile	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCProductCategory	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCRacingWheel	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCRacingWheel.Notifications	Notifiche inviate dalla GCRacingWheel classe .
GCRacingWheelInput	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCRacingWheelInputState	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCSteeringWheelElement	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCVirtualController	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCVirtualControllerConfiguration	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCVirtualControllerElementConfiguration	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCXboxGamepad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
UISceneConnectionOptions_GameController	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.

Struct

Nome	Descrizione
GCAcceleration	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseAdaptiveTriggerPositionalAmplitudes	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseAdaptiveTriggerPositionalResistiveStrengths	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCExtendedGamepadSnapshotData	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCExtendedGamepadSnapShotDataV100	Stato di un oggetto GCExtendedGamepad. Prodotto da TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100).
GCGamepadSnapShotDataV100	Stato di un oggetto GCGamepad. Prodotto da TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100).
GCMicroGamepadSnapshotData	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCMicroGamepadSnapShotDataV100	Rappresenta lo stato istantaneo di un micro game pad in formato V100 in un momento specifico.
GCPoint2	Rappresenta una coppia ordinata di coordinate x a virgola mobile e y che definisce un punto in un piano bidimensionale.
GCQuaternion	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCRotationRate	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.

Interfacce

Nome	Descrizione
IGCAxis2DInput	Questa interfaccia rappresenta il protocollo `GCAxis2DInput`Objective-C .
IGCAxisElement	Questa interfaccia rappresenta il protocollo `GCAxisElement`Objective-C .
IGCAxisInput	Questa interfaccia rappresenta il protocollo `GCAxisInput`Objective-C .
IGCButtonElement	Questa interfaccia rappresenta il protocollo `GCButtonElement`Objective-C .
IGCDevice	Questa interfaccia rappresenta il protocollo `GCDevice`Objective-C .
IGCDevicePhysicalInput	Questa interfaccia rappresenta il protocollo `GCDevicePhysicalInput`Objective-C .
IGCDevicePhysicalInputState	Questa interfaccia rappresenta il protocollo `GCDevicePhysicalInputState`Objective-C .
IGCDevicePhysicalInputStateDiff	Questa interfaccia rappresenta il protocollo `GCDevicePhysicalInputStateDiff`Objective-C .
IGCDirectionPadElement	Questa interfaccia rappresenta il protocollo `GCDirectionPadElement`Objective-C .
IGCGameControllerSceneDelegate	Questa interfaccia rappresenta il protocollo `GCGameControllerSceneDelegate`Objective-C .
IGCLinearInput	Questa interfaccia rappresenta il protocollo `GCLinearInput`Objective-C .
IGCPhysicalInputElement	Questa interfaccia rappresenta il protocollo `GCPhysicalInputElement`Objective-C .
IGCPhysicalInputSource	Questa interfaccia rappresenta il protocollo `GCPhysicalInputSource`Objective-C .
IGCPressedStateInput	Questa interfaccia rappresenta il protocollo `GCPressedStateInput`Objective-C .
IGCRelativeInput	Questa interfaccia rappresenta il protocollo `GCRelativeInput`Objective-C .
IGCSwitchElement	Questa interfaccia rappresenta il protocollo `GCSwitchElement`Objective-C .
IGCSwitchPositionInput	Questa interfaccia rappresenta il protocollo `GCSwitchPositionInput`Objective-C .
IGCTouchedStateInput	Questa interfaccia rappresenta il protocollo `GCTouchedStateInput`Objective-C .

Enumerazioni

Nome	Descrizione
GCControllerHomeButtonSettingCustomizationStatus	Specifica se l'utente ha personalizzato un'impostazione del pulsante Home del controller.
GCControllerHomeButtonSettingInAppAction	Specifica il modo in cui il sistema risponde a un pulsante Home del controller mentre l'applicazione è all'inizio.
GCControllerHomeButtonSettingsCustomizationActivity	Specifica l'impostazione del pulsante Home del controller da personalizzare.
GCControllerHomeButtonSettingSystemAction	Specifica l'azione di sistema eseguita in risposta alla pressione del pulsante Home del controller.
GCControllerPlayerIndex	Enumera gli indici del controller del lettore.
GCDeviceBatteryState	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDevicePhysicalInputElementChange	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseAdaptiveTriggerMode	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCDualSenseAdaptiveTriggerStatus	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCExtendedGamepadSnapshotDataVersion	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputAxisName	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputButtonName	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputDirectional	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputDirectionPadName	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputElementName	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCInputMicroGamepad	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCMicroGamepadSnapshotDataVersion	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCPhysicalInputSourceDirection	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCSystemGestureState	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCTouchState	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCUIEventTypes	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.

Delegati

Nome	Descrizione
ElementValueDidChangeHandler	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCAxis2DInputValueDidChangeCallback	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerAxisValueChangedHandler	Delegato usato come gestore di modifica del valore per ValueChangedHandler.
GCControllerButtonTouchedChanged	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCControllerButtonValueChanged	Delegato per ValueChangedHandler e PressedChangedHandler.
GCControllerDirectionPadValueChangedHandler	Delegato usato come gestore di modifica del valore per ValueChangedHandler.
GCControllerHomeButtonSettingsDidChangeHandler	Gestore richiamato dopo la modifica delle impostazioni del pulsante Home del controller.
GCControllerTouchpadHandler	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCExtendedGamepadValueChangedHandler	Delegato usato come gestore di modifica del valore per ValueChangedHandler.
GCGamepadValueChangedHandler	Delegato usato come gestore di modifica del valore per ValueChangedHandler.
GCKeyboardValueChangedHandler	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCMicroGamepadValueChangedHandler	Gestore che viene chiamato ogni volta che viene modificato un singolo elemento di un controller.
GCMouseMoved	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
GCVirtualControllerElementUpdateBlock	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.
InputStateAvailableHandler	Lo spazio dei nomi GameController fornisce supporto per i controller di gioco esterni.

Commenti

I controller di gioco sono disponibili in due forme: controller "form-fitting" che contengono un dispositivo iOS e controller "wireless estesi" che si connettono in modalità wireless a un dispositivo iOS o a un Mac.

I controller di gioco devono essere componenti facoltativi: gli sviluppatori di giochi devono rendere il gioco riproducibile dagli utenti che non dispongono di controller di gioco.

I controller di adattamento del modulo vengono individuati automaticamente dal sistema. I controller wireless estesi vengono individuati dal sistema successivo alla chiamata StartWirelessControllerDiscovery dello sviluppatore dell'applicazione e causeranno l'incendio del ObserveDidConnect gestore delle notifiche. Quando i controller wireless si disconnettono, la ObserveDidDisconnect notifica viene attivata.

Esistono due profili supportati per i controller di gioco: GCGamepad e GCExtendedGamepad. Un GCController oggetto avrà un valore non Null per la relativa Gamepad proprietà o la relativa ExtendedGamepad proprietà. Lo sviluppatore dell'applicazione deve leggerli per determinare il tipo.

GCGamepads hanno due pulsanti a spalla, un D-pad (vedere GCControllerDirectionPad) e 4 pulsanti viso etichettati Y-B-A-X.

GCExtendedGamepads hanno gli stessi elementi, più due pulsanti trigger e due joystick (vedere GCControllerAxisInput). Gli schemi concettuali apple mostrano inoltre una matrice LED, ma attualmente non esiste alcun accesso a livello di codice a questo elemento.

Esistono tre modi per leggere i dati del controller di gioco:

Technique	Metodi	Utilizza
Sondaggio	Proprietà come IsPressed o XAxis	Leggere direttamente dal ciclo del gioco (vedere Update).
Guidata dagli eventi	Proprietà dell'elemento `ValueChangedHandler` (ad esempio ValueChangedHandler)	Game Controller elabora gli aggiornamenti sul thread principale. Il framework garantisce che gli eventi che si verificano simultaneamente generano una serie di singoli callback.
Snapshot coordinato	SaveSnapshot, SaveSnapshot	Snapshot dello stato del controller. Appropriato per il marshalling, la serializzazione o l'elaborazione ritardata.

Le classi principali nello spazio dei nomi Game Controller sono illustrate nella figura seguente: