RawGameController クラス

リファレンス

定義

名前空間:: Windows.Gaming.Input

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

任意の種類のゲームコントローラーを表します。

public ref class RawGameController sealed : IGameControllerBatteryInfo

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

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

Public NotInheritable Class RawGameController
Implements IGameControllerBatteryInfo

継承: Object Platform::Object IInspectable RawGameController

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装: IGameController IGameControllerBatteryInfo

Windows の要件

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

例

次のコードスニペットは、 RawGameController.RawGameControllers リストをループ処理し、各 RawGameController をベクターに追加する方法を示しています。状況はいつでも変化する可能性があるため、ベクターにロックを設定する必要があります (たとえば、コントローラーが切断または再接続される可能性があります)。

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

for (auto const& rawGameController : RawGameController::RawGameControllers())
{
    // Test whether the raw game controller is already in myRawGameControllers; if it isn't, add it.
    concurrency::critical_section::scoped_lock lock{ myLock };
    auto it{ std::find(begin(myRawGameControllers), end(myRawGameControllers), rawGameController) };

    if (it == end(myRawGameControllers))
    {
        // This code assumes that you're interested in all raw game controllers.
        myRawGameControllers.push_back(rawGameController);
    }
}

注釈

RawGameController クラスのインスタンスを直接作成することはできません。代わりに、クラスのインスタンスは、接続されているすべてのゲームコントローラーを一覧表示する RawGameController.RawGameControllers プロパティまたは RawGameController.RawGameControllerAdded イベントを通じて取得されます。

RawGameController で使用できるすべての入力は、名前のないボタン、スイッチ、軸の単純な配列として公開されます。このクラスを使用すると、ユーザーが使用しているコントローラーの種類に関係なく、カスタム入力マッピングを作成できます。

これらの配列を自分で作成し、 GetCurrentReading を使用して入力して、ボタン、スイッチ、軸の状態を決定する必要があります。詳細については、その関数のドキュメントを参照してください。

RawGameController クラスの使用方法については、「Raw ゲームコントローラー」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1709	16299	DisplayName
1709	16299	NonRoamableId
1709	16299	SimpleHapticsControllers

プロパティ

AxisCount	生のゲームコントローラー上の軸の数。
ButtonCount	生のゲームコントローラー上のボタンの数。
DisplayName	ハードウェアによって提供されるコントローラーの名前。
ForceFeedbackMotors	生ゲームコントローラーの力フィードバックモーターの一覧。
HardwareProductId	生ゲームコントローラーのハードウェア製品 ID。
HardwareVendorId	生のゲームコントローラーのハードウェアベンダー ID。
Headset	生のゲームコントローラーに接続されているオーディオヘッドセット。
IsWireless	生のゲームコントローラーのワイヤレス状態を示す値を取得します。
NonRoamableId	コントローラーを識別する一意の ID。コントローラーが接続されている限り、ID は変更されません。
RawGameControllers	接続されているすべての未加工ゲームコントローラーの一覧。
SimpleHapticsControllers	デバイスで使用可能なすべてのハプティクスフィードバックモーターを表す SimpleHapticsController オブジェクトのコレクション。
SwitchCount	生ゲームコントローラー上のスイッチの数。
User	生のゲームコントローラーに関連付けられているユーザー。

メソッド

FromGameController(IGameController)	指定されたゲームコントローラーを生のゲームコントローラーとして返します。
GetButtonLabel(Int32)	指定したボタンのボタンラベルを取得します。
GetCurrentReading(Boolean[], GameControllerSwitchPosition[], Double[])	生のゲームコントローラーの状態のスナップショットを取得します。
GetSwitchKind(Int32)	生のゲームコントローラーで指定されたスイッチの種類を取得します。
TryGetBatteryReport()	生のゲームコントローラーの現在のバッテリー状態に関する情報を取得します。

イベント

HeadsetConnected	ヘッドセットが未加工のゲームコントローラーに接続されたときに通知します。
HeadsetDisconnected	ヘッドセットが未加工のゲームコントローラーから切断されたときに通知します。
RawGameControllerAdded	新しい生ゲームコントローラーが接続されたときに通知します。
RawGameControllerRemoved	未加工のゲームコントローラーが切断されたときに通知します。
UserChanged	生のゲームコントローラーに関連付けられているユーザーが変更されたときに通知します。

適用対象