GameController Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
O espaço de nomes GameController oferece suporte para comandos externos de jogos.
Classes
| Nome | Descrição |
|---|---|
| GCColor |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCController |
Um comando de jogo, seja ajustado ou sem fios estendido. |
| GCController.Notifications |
Notificações publicadas pela GCController turma. |
| GCControllerAxisInput |
A GCControllerElement representa um joystick. |
| GCControllerButtonInput |
A GCControllerElement representa um botão de comando de jogo. |
| GCControllerDirectionPad |
A GCControllerElement representa um direcional. |
| GCControllerElement |
A classe base para os elementos de entrada de um comando de jogo. |
| GCControllerHomeButtonSettingsManager |
Dá acesso às definições do sistema para o comportamento do botão Home do comando. |
| GCControllerInputState |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerLiveInput |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerTouchpad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerUserCustomizations |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerUserCustomizations.Notifications |
Notificações publicadas pela GCControllerUserCustomizations turma. |
| GCDeviceBattery |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDeviceCursor |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDeviceHaptics |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDeviceLight |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDirectionalGamepad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseAdaptiveTrigger |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseGamepad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualShockGamepad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCEventInteraction |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCEventViewController |
Controlador de visualização que pode alternar a entrega de eventos entre a cadeia de respondentes e o controlador do jogo. |
| GCExtendedGamepad |
Um comando com dois botões de ombro, dois gatilhos, dois analógicos, um D-Pad e uma matriz de botões direcionais. |
| GCExtendedGamepadSnapshot |
Um instantâneo serializável do estado do comando do jogo. |
| GCGameControllerActivationContext |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCGameControllerSceneDelegate |
Esta é uma classe que implementa a interface IGCGameControllerSceneDelegate (para o protocolo Subclasse esta classe para criar facilmente um tipo que implemente o protocolo. Uma alternativa é criar uma subclasse de NSObject e depois implementar a interface IGCGameControllerSceneDelegate. |
| GCGamepad |
Um comando com dois botões de ombro, um D-Pad e uma matriz de botões direcionais... |
| GCGamepadSnapshot |
Um instantâneo serializável do estado do comando do jogo. |
| GCGearShifterElement |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCHapticsLocality |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInput |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputAxisNameExtensions |
Métodos de extensão para a GCInputAxisName enumeração. |
| GCInputButtonNameExtensions |
Métodos de extensão para a GCInputButtonName enumeração. |
| GCInputDirectionalExtensions |
Métodos de extensão para a GCInputDirectional enumeração. |
| GCInputDirectionPadNameExtensions |
Métodos de extensão para a GCInputDirectionPadName enumeração. |
| GCInputElementNameExtensions |
Métodos de extensão para a GCInputElementName enumeração. |
| GCInputMicroGamepadExtensions |
Métodos de extensão para a GCInputMicroGamepad enumeração. |
| GCInputXbox |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCKey |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCKeyboard |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCKeyboard.Notifications |
Notificações publicadas pela GCKeyboard turma. |
| GCKeyboardInput |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCKeyCode |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCMicroGamepad |
Um mapeamento lógico dos controlos de hardware do comando para um conjunto de elementos dentro do jogo. |
| GCMicroGamepadSnapshot |
Obtém instantâneos do estado de um micro comando. |
| GCMotion |
Contém dados de posição de um comando de jogo. |
| GCMouse |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCMouse.Notifications |
Notificações publicadas pela GCMouse turma. |
| GCMouseInput |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType> |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCPhysicalInputProfile |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCProductCategory |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCRacingWheel |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCRacingWheel.Notifications |
Notificações publicadas pela GCRacingWheel turma. |
| GCRacingWheelInput |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCRacingWheelInputState |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCSteeringWheelElement |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCVirtualController |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCVirtualControllerConfiguration |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCVirtualControllerElementConfiguration |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCXboxGamepad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| UISceneConnectionOptions_GameController |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
Estruturas
| Nome | Descrição |
|---|---|
| GCAcceleration |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseAdaptiveTriggerPositionalAmplitudes |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseAdaptiveTriggerPositionalResistiveStrengths |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCExtendedGamepadSnapshotData |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCExtendedGamepadSnapShotDataV100 |
O estado de um GCExtendedGamepad. Produzido por TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100). |
| GCGamepadSnapShotDataV100 |
O estado de um GCGamepad. Produzido por TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100). |
| GCMicroGamepadSnapshotData |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCMicroGamepadSnapShotDataV100 |
Representa o estado instantâneo de um microcomando em formato V100 num dado momento. |
| GCPoint2 |
Representa um par ordenado de coordenadas x e y de ponto flutuante que define um ponto num plano bidimensional. |
| GCQuaternion |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCRotationRate |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
Interfaces
| Nome | Descrição |
|---|---|
| IGCAxis2DInput |
Esta interface representa o protocolo |
| IGCAxisElement |
Esta interface representa o protocolo |
| IGCAxisInput |
Esta interface representa o protocolo |
| IGCButtonElement |
Esta interface representa o protocolo |
| IGCDevice |
Esta interface representa o protocolo |
| IGCDevicePhysicalInput |
Esta interface representa o protocolo |
| IGCDevicePhysicalInputState |
Esta interface representa o protocolo |
| IGCDevicePhysicalInputStateDiff |
Esta interface representa o protocolo |
| IGCDirectionPadElement |
Esta interface representa o protocolo |
| IGCGameControllerSceneDelegate |
Esta interface representa o protocolo |
| IGCLinearInput |
Esta interface representa o protocolo |
| IGCPhysicalInputElement |
Esta interface representa o protocolo |
| IGCPhysicalInputSource |
Esta interface representa o protocolo |
| IGCPressedStateInput |
Esta interface representa o protocolo |
| IGCRelativeInput |
Esta interface representa o protocolo |
| IGCSwitchElement |
Esta interface representa o protocolo |
| IGCSwitchPositionInput |
Esta interface representa o protocolo |
| IGCTouchedStateInput |
Esta interface representa o protocolo |
Enumerações
| Nome | Descrição |
|---|---|
| GCControllerHomeButtonSettingCustomizationStatus |
Especifica se o utilizador personalizou uma definição do botão Home do comando. |
| GCControllerHomeButtonSettingInAppAction |
Especifica como o sistema responde ao pressionar do botão Home do comando enquanto a aplicação está na frente. |
| GCControllerHomeButtonSettingsCustomizationActivity |
Especifica a definição do botão Home do comando para personalizar. |
| GCControllerHomeButtonSettingSystemAction |
Especifica a ação do sistema realizada em resposta ao pressionar do botão Home do comando. |
| GCControllerPlayerIndex |
Enumera índices de controladores do jogador. |
| GCDeviceBatteryState |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDevicePhysicalInputElementChange |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseAdaptiveTriggerMode |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCDualSenseAdaptiveTriggerStatus |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCExtendedGamepadSnapshotDataVersion |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputAxisName |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputButtonName |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputDirectional |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputDirectionPadName |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputElementName |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCInputMicroGamepad |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCMicroGamepadSnapshotDataVersion |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCPhysicalInputSourceDirection |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCSystemGestureState |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCTouchState |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCUIEventTypes |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
Delegados
| Nome | Descrição |
|---|---|
| ElementValueDidChangeHandler |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCAxis2DInputValueDidChangeCallback |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerAxisValueChangedHandler |
O delegado usava como manipulador de valor alterado para ValueChangedHandler. |
| GCControllerButtonTouchedChanged |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCControllerButtonValueChanged |
Delegar para ValueChangedHandler e PressedChangedHandler. |
| GCControllerDirectionPadValueChangedHandler |
O delegado usava como manipulador de valor alterado para ValueChangedHandler. |
| GCControllerHomeButtonSettingsDidChangeHandler |
Handler invocado após alterações nas definições do botão Home. |
| GCControllerTouchpadHandler |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCExtendedGamepadValueChangedHandler |
O delegado usava como manipulador de valor alterado para ValueChangedHandler. |
| GCGamepadValueChangedHandler |
O delegado usava como manipulador de valor alterado para ValueChangedHandler. |
| GCKeyboardValueChangedHandler |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCMicroGamepadValueChangedHandler |
Um handler que é chamado sempre que qualquer elemento individual de um controlador muda. |
| GCMouseMoved |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| GCVirtualControllerElementUpdateBlock |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
| InputStateAvailableHandler |
O espaço de nomes GameController oferece suporte para comandos externos de jogos. |
Observações
Os comandos de jogos existem em duas formas: comandos "ajustados" que contêm um dispositivo iOS e comandos "wireless estendidos" que se ligam sem fios a um dispositivo iOS ou a um Mac.
Os comandos de jogo devem ser componentes opcionais: os desenvolvedores de jogos devem tornar o seu jogo jogável por utilizadores que não têm comandos.
Controladores ajustados são automaticamente descobertos pelo sistema. Comandos wireless estendidos são detetados pelo sistema após a chamada StartWirelessControllerDiscovery do programador da aplicação e fazem com que o ObserveDidConnect manipulador de notificações dispare. Quando os comandos sem fios se desligam, a ObserveDidDisconnect notificação dispara.
Existem dois perfis suportados para comandos de jogos: GCGamepad e GCExtendedGamepad. A GCController terá um valor não nulo para a sua Gamepad ou a sua ExtendedGamepad propriedade, o desenvolvedor da aplicação deve ler esses valores para determinar o tipo.
GCGamepads têm dois botões de ombro, um D-pad (ver GCControllerDirectionPad) e 4 botões frontais rotulados Y-B-A-X.
GCExtendedGamepads têm os mesmos elementos, mais dois botões de gatilho e dois joysticks (ver GCControllerAxisInput). Os esquemas conceptuais da Apple também mostram um array de LEDs, mas atualmente não existe acesso programático a este elemento.
Existem três formas de ler os dados dos comandos do jogo:
| Technique | Método(s) | Utilizar |
|---|---|---|
| Votação | Propriedades como IsPressed ou XAxis | Lido diretamente do ciclo do jogo (ver Update). |
| Orientado por eventos | Propriedade do ValueChangedHandler elemento (como ValueChangedHandler) | O Controlador de Jogo processa as atualizações no tópico principal. A estrutura assegura que eventos que ocorrem simultaneamente resultam numa série de callbacks únicos. |
| Instantâneo Coordenado | SaveSnapshot, SaveSnapshot | Faz snapshots do estado do controlador. Apropriado para marshalling, serialização ou processamento atrasado. |
As principais classes no espaço de nomes do Game Controller são mostradas na ilustração seguinte:
