GameController Przestrzeń nazw
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier.
Klasy
| Nazwisko | Opis |
|---|---|
| GCColor |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCController |
Kontroler gry, dopasowany do formularza lub rozszerzony bezprzewodowy. |
| GCController.Notifications |
Powiadomienia opublikowane przez klasę GCController . |
| GCControllerAxisInput |
Reprezentującego GCControllerElement bardzo dużo jędy. |
| GCControllerButtonInput |
Reprezentujący GCControllerElement przycisk kontrolera gry. |
| GCControllerDirectionPad |
Element GCControllerElement reprezentujący podkładkę kierunkową. |
| GCControllerElement |
Klasa bazowa dla elementów wejściowych kontrolera gry. |
| GCControllerHomeButtonSettingsManager |
Zapewnia dostęp do ustawień systemowych dla zachowania przycisku Strona główna kontrolera. |
| GCControllerInputState |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerLiveInput |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerTouchpad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerUserCustomizations |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerUserCustomizations.Notifications |
Powiadomienia opublikowane przez klasę GCControllerUserCustomizations . |
| GCDeviceBattery |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDeviceCursor |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDeviceHaptics |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDeviceLight |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDirectionalGamepad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseAdaptiveTrigger |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseGamepad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualShockGamepad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCEventInteraction |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCEventViewController |
Wyświetl kontroler, który może przełączać dostarczanie zdarzeń między łańcuchem odpowiedzi a kontrolerem gry. |
| GCExtendedGamepad |
Gamepad z dwoma przyciskami barku, dwoma wyzwalaczami, dwoma szminkami, D-Pad i tablicą przycisków kierunkowych. |
| GCExtendedGamepadSnapshot |
Serializowalne migawki stanu kontrolera gry. |
| GCGameControllerActivationContext |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCGameControllerSceneDelegate |
Jest to klasa, która implementuje interfejs IGCGameControllerSceneDelegate (dla protokołu Podklasa tej klasy, aby łatwo utworzyć typ, który implementuje protokół. Alternatywą jest utworzenie podklasy , NSObject a następnie zaimplementowanie interfejsu IGCGameControllerSceneDelegate. |
| GCGamepad |
Gamepad z dwoma przyciskami barku, D-Pad i tablicą przycisków kierunkowych. |
| GCGamepadSnapshot |
Serializowalne migawki stanu kontrolera gry. |
| GCGearShifterElement |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCHapticsLocality |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInput |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputAxisNameExtensions |
Metody rozszerzenia dla GCInputAxisName wyliczenia. |
| GCInputButtonNameExtensions |
Metody rozszerzenia dla GCInputButtonName wyliczenia. |
| GCInputDirectionalExtensions |
Metody rozszerzenia dla GCInputDirectional wyliczenia. |
| GCInputDirectionPadNameExtensions |
Metody rozszerzenia dla GCInputDirectionPadName wyliczenia. |
| GCInputElementNameExtensions |
Metody rozszerzenia dla GCInputElementName wyliczenia. |
| GCInputMicroGamepadExtensions |
Metody rozszerzenia dla GCInputMicroGamepad wyliczenia. |
| GCInputXbox |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCKey |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCKeyboard |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCKeyboard.Notifications |
Powiadomienia opublikowane przez klasę GCKeyboard . |
| GCKeyboardInput |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCKeyCode |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCMicroGamepad |
Logiczne mapowanie kontrolek kontrolera sprzętu na zestaw elementów w grze. |
| GCMicroGamepadSnapshot |
Pobiera migawki stanu mikro gamepadu. |
| GCMotion |
Przechowuje dane pozycji kontrolera gry. |
| GCMouse |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCMouse.Notifications |
Powiadomienia opublikowane przez klasę GCMouse . |
| GCMouseInput |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType> |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCPhysicalInputProfile |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCProductCategory |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCRacingWheel |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCRacingWheel.Notifications |
Powiadomienia opublikowane przez klasę GCRacingWheel . |
| GCRacingWheelInput |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCRacingWheelInputState |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCSteeringWheelElement |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCVirtualController |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCVirtualControllerConfiguration |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCVirtualControllerElementConfiguration |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCXboxGamepad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| UISceneConnectionOptions_GameController |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
Struktury
| Nazwisko | Opis |
|---|---|
| GCAcceleration |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseAdaptiveTriggerPositionalAmplitudes |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseAdaptiveTriggerPositionalResistiveStrengths |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCExtendedGamepadSnapshotData |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCExtendedGamepadSnapShotDataV100 |
Stan obiektu GCExtendedGamepad. Wyprodukowany przez program TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100). |
| GCGamepadSnapShotDataV100 |
Stan obiektu GCGamepad. Wyprodukowany przez program TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100). |
| GCMicroGamepadSnapshotData |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCMicroGamepadSnapShotDataV100 |
Reprezentuje stan natychmiastowego mikro gamepadu w formacie V100 w danym momencie. |
| GCPoint2 |
Reprezentuje uporządkowaną parę współrzędnych zmiennoprzecinkowych x-i y, które definiują punkt na dwuwymiarowej płaszczyźnie. |
| GCQuaternion |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCRotationRate |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
Interfejsy
| Nazwisko | Opis |
|---|---|
| IGCAxis2DInput |
Ten interfejs reprezentuje protokół |
| IGCAxisElement |
Ten interfejs reprezentuje protokół |
| IGCAxisInput |
Ten interfejs reprezentuje protokół |
| IGCButtonElement |
Ten interfejs reprezentuje protokół |
| IGCDevice |
Ten interfejs reprezentuje protokół |
| IGCDevicePhysicalInput |
Ten interfejs reprezentuje protokół |
| IGCDevicePhysicalInputState |
Ten interfejs reprezentuje protokół |
| IGCDevicePhysicalInputStateDiff |
Ten interfejs reprezentuje protokół |
| IGCDirectionPadElement |
Ten interfejs reprezentuje protokół |
| IGCGameControllerSceneDelegate |
Ten interfejs reprezentuje protokół |
| IGCLinearInput |
Ten interfejs reprezentuje protokół |
| IGCPhysicalInputElement |
Ten interfejs reprezentuje protokół |
| IGCPhysicalInputSource |
Ten interfejs reprezentuje protokół |
| IGCPressedStateInput |
Ten interfejs reprezentuje protokół |
| IGCRelativeInput |
Ten interfejs reprezentuje protokół |
| IGCSwitchElement |
Ten interfejs reprezentuje protokół |
| IGCSwitchPositionInput |
Ten interfejs reprezentuje protokół |
| IGCTouchedStateInput |
Ten interfejs reprezentuje protokół |
Wyliczenia
| Nazwisko | Opis |
|---|---|
| GCControllerHomeButtonSettingCustomizationStatus |
Określa, czy użytkownik dostosować ustawienie przycisku Strona główna kontrolera. |
| GCControllerHomeButtonSettingInAppAction |
Określa sposób, w jaki system reaguje na naciśnięcie przycisku Strona główna kontrolera, gdy aplikacja jest z przodu. |
| GCControllerHomeButtonSettingsCustomizationActivity |
Określa ustawienie przycisku Strona główna kontrolera w celu dostosowania. |
| GCControllerHomeButtonSettingSystemAction |
Określa akcję systemową wykonywaną w odpowiedzi na naciśnięcie przycisku Strona główna kontrolera. |
| GCControllerPlayerIndex |
Wylicza indeksy kontrolera odtwarzacza. |
| GCDeviceBatteryState |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDevicePhysicalInputElementChange |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseAdaptiveTriggerMode |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCDualSenseAdaptiveTriggerStatus |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCExtendedGamepadSnapshotDataVersion |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputAxisName |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputButtonName |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputDirectional |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputDirectionPadName |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputElementName |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCInputMicroGamepad |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCMicroGamepadSnapshotDataVersion |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCPhysicalInputSourceDirection |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCSystemGestureState |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCTouchState |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCUIEventTypes |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
Delegaci
| Nazwisko | Opis |
|---|---|
| ElementValueDidChangeHandler |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCAxis2DInputValueDidChangeCallback |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerAxisValueChangedHandler |
Delegat używany jako procedura obsługi zmienionej wartości dla elementu ValueChangedHandler. |
| GCControllerButtonTouchedChanged |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCControllerButtonValueChanged |
Delegowanie dla i ValueChangedHandlerPressedChangedHandler. |
| GCControllerDirectionPadValueChangedHandler |
Delegat używany jako procedura obsługi zmienionej wartości dla elementu ValueChangedHandler. |
| GCControllerHomeButtonSettingsDidChangeHandler |
Procedura obsługi wywoływana po zmianie ustawień przycisku Strona główna kontrolera. |
| GCControllerTouchpadHandler |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCExtendedGamepadValueChangedHandler |
Delegat używany jako procedura obsługi zmienionej wartości dla elementu ValueChangedHandler. |
| GCGamepadValueChangedHandler |
Delegat używany jako procedura obsługi zmienionej wartości dla elementu ValueChangedHandler. |
| GCKeyboardValueChangedHandler |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCMicroGamepadValueChangedHandler |
Procedura obsługi wywoływana za każdym razem, gdy zmienia się dowolny pojedynczy element kontrolera. |
| GCMouseMoved |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| GCVirtualControllerElementUpdateBlock |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
| InputStateAvailableHandler |
Przestrzeń nazw GameController zapewnia obsługę zewnętrznych kontrolerów gier. |
Uwagi
Kontrolery gier są dostępne w dwóch formach: "dopasowane" kontrolery, które zawierają urządzenie z systemem iOS i "rozszerzone bezprzewodowe" kontrolery, które łączą się bezprzewodowo z urządzeniem z systemem iOS lub mac.
Kontrolery gier muszą być opcjonalnymi składnikami: deweloperzy gier muszą sprawić, że ich gry będą odtwarzane przez użytkowników, którzy nie mają kontrolerów gier.
Kontrolery montażu formularzy są automatycznie wykrywane przez system. Rozszerzone kontrolery bezprzewodowe są wykrywane przez system po wywołaniu StartWirelessControllerDiscovery dewelopera aplikacji i spowoduje ObserveDidConnect , że program obsługi powiadomień zostanie wyzwolony. Po rozłączeniu ObserveDidDisconnect kontrolerów bezprzewodowych powiadomienie zostanie wyzwolone.
Istnieją dwa obsługiwane profile dla kontrolerów gier: GCGamepad i GCExtendedGamepad. Obiekt GCController będzie miał wartość inną niż null dla jej Gamepad właściwości lub jej ExtendedGamepad właściwości, deweloper aplikacji musi odczytać te, aby określić typ.
GCGamepads mają dwa przyciski ramię, d-pad (patrz GCControllerDirectionPad), i 4 przyciski twarzy oznaczone Y-B-A-X.
GCExtendedGamepads mają te same elementy, a także dwa przyciski wyzwalacza i dwa przełączniki (zobacz GCControllerAxisInput). Schematy koncepcyjne firmy Apple dodatkowo pokazują tablicę LED, ale obecnie nie ma programowego dostępu do tego elementu.
Istnieją trzy sposoby odczytywania danych kontrolera gier:
| Technique | Metody | Używanie |
|---|---|---|
| Sondowanie | Właściwości, takie jak IsPressed lub XAxis | Bezpośrednio odczytaj z pętli gry (zobacz Update). |
| Sterowane zdarzeniami |
ValueChangedHandler Właściwość elementu (na przykład ValueChangedHandler) | Game Controller przetwarza aktualizacje w głównym wątku. Platforma zapewnia, że zdarzenia występujące jednocześnie powodują serię pojedynczych wywołań zwrotnych. |
| Koordynowana migawka | SaveSnapshot, SaveSnapshot | Tworzy migawki stanu kontrolera. Odpowiednie do marshalingu, serializacji lub opóźnionego przetwarzania. |
Główne klasy w przestrzeni nazw Kontrolera gry są pokazane na poniższej ilustracji:
