RawGameController.NonRoamableId Propriedade

Definição

Namespace:

Windows.Gaming.Input

Uma ID exclusiva que identifica o controlador. Enquanto o controlador estiver conectado, a ID nunca será alterada.

public:
 property Platform::String ^ NonRoamableId { Platform::String ^ get(); };

winrt::hstring NonRoamableId();

public string NonRoamableId { get; }

var string = rawGameController.nonRoamableId;

Public ReadOnly Property NonRoamableId As String

Valor da propriedade

String

Platform::String

winrt::hstring

Uma ID exclusiva que identifica o controlador. Enquanto o controlador estiver conectado, a ID nunca será alterada.

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

Essa ID tem um tempo de vida mais longo do que o aplicativo e a conexão do controlador. É garantido que ele não seja alterado para um determinado controlador, mesmo entre as reinicializações do dispositivo ao qual ele está conectado, desde que o controlador permaneça conectado à mesma porta USB no dispositivo. Um exemplo em que isso pode ser útil é para jogos como simuladores de voo, em que o usuário pode conectar vários dos mesmos tipos de controlador ao computador, como módulos com painéis de instrumentos. Quando o usuário atribui funções a esses controladores no jogo, o jogo precisa ser capaz de identificar cada controlador exclusivamente (o que ele não pode fazer apenas com as IDs do produto e do fornecedor) para que ele possa garantir que as funções certas sejam atribuídas aos controladores certos na próxima vez que ele for executado.

Essa ID também é exclusiva do aplicativo nesse dispositivo. O mesmo gamepad exato, conectado ao mesmo computador, terá uma NonRoamableId diferente em dois aplicativos diferentes. Da mesma forma, o mesmo gamepad exato, em execução no mesmo aplicativo, mas em computadores diferentes, terá diferentes NonRoamableIds.