RawGameController.NonRoamableId プロパティ

定義

名前空間:

Windows.Gaming.Input

コントローラーを識別する一意の ID。 コントローラーが接続されている限り、ID は変更されません。

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

プロパティ値

String

Platform::String

winrt::hstring

コントローラーを識別する一意の ID。 コントローラーが接続されている限り、ID は変更されません。

Windows の要件

デバイス ファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

この ID の有効期間は、アプリケーションとコントローラーの接続の両方よりも長くなります。 コントローラーがデバイス上の同じ USB ポートに接続されている限り、接続されているデバイスの再起動の間でも、特定のコントローラーに対して変更しないことが保証されます。 これが役に立つ可能性がある例は、フライト シミュレーターなどのゲームで、ユーザーが同じ種類のコントローラーをいくつか、インストルメント パネル付きのモジュールのように PC に接続する場合です。 ユーザーがゲーム内のこれらのコントローラーに関数を割り当てると、ゲームは各コントローラーを一意に識別できる必要があります (製品 ID とベンダー ID だけでは実行できません)。これにより、次回の実行時に適切な機能が適切なコントローラーに割り当てられていることを確認できます。

この ID は、そのデバイス上のアプリケーションにも一意です。 同じ PC に接続された同じ正確なゲームパッドは、2 つの異なるアプリケーションで異なる NonRoamableId を 持ちます。 同様に、同じアプリケーションで実行されているが、異なる PC で実行されている同じ正確なゲームパッドでは、 NonRoamableIdが異なります。