Gamepad Classe

Definição

Namespace:

Windows.Gaming.Input

Representa um gamepad.

public ref class Gamepad sealed : IGameControllerBatteryInfo

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Gamepad final : IGameControllerBatteryInfo

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Gamepad : IGameControllerBatteryInfo

Public NotInheritable Class Gamepad
Implements IGameControllerBatteryInfo

Herança

Object Platform::Object IInspectable Gamepad

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IGameController IGameControllerBatteryInfo

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O snippet de código a seguir mostra como percorrer a lista Gamepad.Gamepads e adicionar cada um a um vetor. Você precisará colocar um bloqueio no vetor, pois as coisas podem mudar a qualquer momento (um controlador pode ser desconectado ou reconectado, por exemplo).

#include <concrt.h>
#include <winrt/Windows.Gaming.Input.h>
using namespace winrt;
using namespace Windows::Gaming::Input;
...
std::vector<Gamepad> myGamepads;
concurrency::critical_section myLock{};

for (auto const& gamepad : Gamepad::Gamepads())
{
    // Test whether the gamepad is already in myGamepads; if it isn't, add it.
    concurrency::critical_section::scoped_lock lock{ myLock };
    auto it{ std::find(begin(myGamepads), end(myGamepads), gamepad) };

    if (it == end(myGamepads))
    {
        // This code assumes that you're interested in all gamepads.
        myGamepads.push_back(gamepad);
    }
}

auto myGamepads = ref new Vector<Gamepad^>();
critical_section myLock{};

for (auto gamepad : Gamepad::Gamepads)
{
    // Test whether the gamepad is already in myGamepads; if it isn't, add it.
    critical_section::scoped_lock lock{ myLock };
    auto it = std::find(begin(myGamepads), end(myGamepads), gamepad);

    if (it == end(myGamepads))
    {
        // This code assumes that you're interested in all gamepads.
        myGamepads->Append(gamepad);
    }
}

Comentários

As instâncias da classe Gamepad não podem ser criadas diretamente; Em vez disso, as instâncias da classe Gamepad são recuperadas por meio da propriedade Gamepad.Gamepads listando todos os gamepads conectados ou por meio do evento Gamepad.GamepadAdded .

Dispositivos com suporte

O Gamepad dá suporte a qualquer GIP (Protocolo de Entrada de Jogos) ou gamepad compatível com XUSB.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	GetButtonLabel
1703	15063	FromGameController
1703	15063	TryGetBatteryReport

Propriedades

Gamepads	A lista de todos os gamepads conectados.
Headset	O fone de ouvido de áudio anexado ao gamepad.
IsWireless	Obtém um valor que indica o estado sem fio do gamepad.
User	O usuário associado ao gamepad.
Vibration	Descreve a velocidade do motor do gamepad.

Métodos

FromGameController(IGameController)	Retorna o controlador de jogo especificado como um gamepad.
GetButtonLabel(GamepadButtons)	Recupera o rótulo do botão para o botão especificado.
GetCurrentReading()	Obtém uma instantâneo do estado do gamepad.
TryGetBatteryReport()	Obtém informações sobre o estado atual da bateria do gamepad.

Eventos

GamepadAdded	Sinaliza quando um novo gamepad está conectado.
GamepadRemoved	Sinaliza quando um gamepad é desconectado.
HeadsetConnected	Sinaliza quando um headset é anexado ao gamepad.
HeadsetDisconnected	Sinaliza quando um headset é desconectado do gamepad.
UserChanged	Sinaliza quando o usuário associado ao gamepad é alterado.

Confira também

• IGameController
• Gamepad e vibração
• Práticas de entrada para jogos