GameController 名前空間

重要

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

GameController 名前空間は、外部のゲームコントローラーをサポートします。

クラス

Name	説明
GCColor	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCController	フォームフィットまたは拡張ワイヤレスのいずれかのゲームコントローラー。
GCController.Notifications	GCController クラスによって投稿された通知。
GCControllerAxisInput	ジョイスティックを表す GCControllerElement 。
GCControllerButtonInput	ゲームコントローラーボタンを表す GCControllerElement 。
GCControllerDirectionPad	方向パッドを表す GCControllerElement 。
GCControllerElement	ゲームコントローラーの入力要素の基本クラス。
GCControllerHomeButtonSettingsManager	コントローラーの [ホーム] ボタンの動作に関するシステム設定へのアクセスを提供します。
GCControllerInputState	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerLiveInput	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerTouchpad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerUserCustomizations	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerUserCustomizations.Notifications	GCControllerUserCustomizations クラスによって投稿された通知。
GCDeviceBattery	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDeviceCursor	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDeviceHaptics	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDeviceLight	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDirectionalGamepad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseAdaptiveTrigger	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseGamepad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualShockGamepad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCEventInteraction	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCEventViewController	レスポンダーチェーンとゲームコントローラーの間でイベント配信を切り替えることができるコントローラーを表示します。
GCExtendedGamepad	2 つのショルダーボタン、2 つのトリガー、2 つのサムスティック、D パッド、方向ボタン配列を備えたゲームパッド。
GCExtendedGamepadSnapshot	ゲームコントローラーの状態のシリアル化可能なスナップショット。
GCGameControllerActivationContext	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCGameControllerSceneDelegate	これは、(プロトコル IGCGameControllerSceneDelegateの) インターフェイス `GCGameControllerSceneDelegate`を実装するクラスです。プロトコルを実装する型を簡単に作成するには、このクラスをサブクラス化します。別の方法として、 NSObject のサブクラスを作成し、インターフェイス IGCGameControllerSceneDelegateを実装します。
GCGamepad	2 つのショルダーボタン、D パッド、方向ボタン配列を含むゲームパッド。
GCGamepadSnapshot	ゲームコントローラーの状態のシリアル化可能なスナップショット。
GCGearShifterElement	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCHapticsLocality	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInput	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputAxisNameExtensions	GCInputAxisName列挙体の拡張メソッド。
GCInputButtonNameExtensions	GCInputButtonName列挙体の拡張メソッド。
GCInputDirectionalExtensions	GCInputDirectional列挙体の拡張メソッド。
GCInputDirectionPadNameExtensions	GCInputDirectionPadName列挙体の拡張メソッド。
GCInputElementNameExtensions	GCInputElementName列挙体の拡張メソッド。
GCInputMicroGamepadExtensions	GCInputMicroGamepad列挙体の拡張メソッド。
GCInputXbox	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCKey	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCKeyboard	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCKeyboard.Notifications	GCKeyboard クラスによって投稿された通知。
GCKeyboardInput	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCKeyCode	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCMicroGamepad	一連のゲーム内要素へのハードウェアコントローラーコントロールの論理マッピング。
GCMicroGamepadSnapshot	マイクロゲームパッドの状態のスナップショットを取得します。
GCMotion	ゲームコントローラーの位置データを保持します。
GCMouse	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCMouse.Notifications	GCMouse クラスによって投稿された通知。
GCMouseInput	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCPhysicalInputElementCollection<KeyIdentifierType,ElementIdentifierType>	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCPhysicalInputProfile	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCProductCategory	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCRacingWheel	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCRacingWheel.Notifications	GCRacingWheel クラスによって投稿された通知。
GCRacingWheelInput	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCRacingWheelInputState	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCSteeringWheelElement	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCVirtualController	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCVirtualControllerConfiguration	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCVirtualControllerElementConfiguration	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCXboxGamepad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
UISceneConnectionOptions_GameController	GameController 名前空間は、外部のゲームコントローラーをサポートします。

構造体

Name	説明
GCAcceleration	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseAdaptiveTriggerPositionalAmplitudes	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseAdaptiveTriggerPositionalResistiveStrengths	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCExtendedGamepadSnapshotData	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCExtendedGamepadSnapShotDataV100	GCExtendedGamepadの状態。 TryGetSnapShotData(NSData, GCExtendedGamepadSnapShotDataV100)によって生成されます。
GCGamepadSnapShotDataV100	GCGamepadの状態。 TryGetSnapshotData(NSData, GCGamepadSnapShotDataV100)によって生成されます。
GCMicroGamepadSnapshotData	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCMicroGamepadSnapShotDataV100	特定の時点でのマイクロゲームパッドの瞬間的な状態を V100 形式で表します。
GCPoint2	2 次元平面内の点を定義する浮動小数点 x 座標と y 座標の順序付きペアを表します。
GCQuaternion	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCRotationRate	GameController 名前空間は、外部のゲームコントローラーをサポートします。

インターフェイス

Name	説明
IGCAxis2DInput	このインターフェイスは、Objective-C プロトコル `GCAxis2DInput`を表します。
IGCAxisElement	このインターフェイスは、Objective-C プロトコル `GCAxisElement`を表します。
IGCAxisInput	このインターフェイスは、Objective-C プロトコル `GCAxisInput`を表します。
IGCButtonElement	このインターフェイスは、Objective-C プロトコル `GCButtonElement`を表します。
IGCDevice	このインターフェイスは、Objective-C プロトコル `GCDevice`を表します。
IGCDevicePhysicalInput	このインターフェイスは、Objective-C プロトコル `GCDevicePhysicalInput`を表します。
IGCDevicePhysicalInputState	このインターフェイスは、Objective-C プロトコル `GCDevicePhysicalInputState`を表します。
IGCDevicePhysicalInputStateDiff	このインターフェイスは、Objective-C プロトコル `GCDevicePhysicalInputStateDiff`を表します。
IGCDirectionPadElement	このインターフェイスは、Objective-C プロトコル `GCDirectionPadElement`を表します。
IGCGameControllerSceneDelegate	このインターフェイスは、Objective-C プロトコル `GCGameControllerSceneDelegate`を表します。
IGCLinearInput	このインターフェイスは、Objective-C プロトコル `GCLinearInput`を表します。
IGCPhysicalInputElement	このインターフェイスは、Objective-C プロトコル `GCPhysicalInputElement`を表します。
IGCPhysicalInputSource	このインターフェイスは、Objective-C プロトコル `GCPhysicalInputSource`を表します。
IGCPressedStateInput	このインターフェイスは、Objective-C プロトコル `GCPressedStateInput`を表します。
IGCRelativeInput	このインターフェイスは、Objective-C プロトコル `GCRelativeInput`を表します。
IGCSwitchElement	このインターフェイスは、Objective-C プロトコル `GCSwitchElement`を表します。
IGCSwitchPositionInput	このインターフェイスは、Objective-C プロトコル `GCSwitchPositionInput`を表します。
IGCTouchedStateInput	このインターフェイスは、Objective-C プロトコル `GCTouchedStateInput`を表します。

列挙型

Name	説明
GCControllerHomeButtonSettingCustomizationStatus	ユーザーがコントローラーの [ホーム] ボタンの設定をカスタマイズしたかどうかを指定します。
GCControllerHomeButtonSettingInAppAction	アプリケーションが最前面にある間に、システムがコントローラーの [ホーム] ボタン押下にどのように応答するかを指定します。
GCControllerHomeButtonSettingsCustomizationActivity	カスタマイズするコントローラーの [ホーム] ボタンの設定を指定します。
GCControllerHomeButtonSettingSystemAction	コントローラーの [ホーム] ボタンの押下に応答して実行されるシステムアクションを指定します。
GCControllerPlayerIndex	プレイヤーコントローラーのインデックスを列挙します。
GCDeviceBatteryState	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDevicePhysicalInputElementChange	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseAdaptiveTriggerMode	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCDualSenseAdaptiveTriggerStatus	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCExtendedGamepadSnapshotDataVersion	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputAxisName	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputButtonName	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputDirectional	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputDirectionPadName	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputElementName	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCInputMicroGamepad	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCMicroGamepadSnapshotDataVersion	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCPhysicalInputSourceDirection	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCSystemGestureState	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCTouchState	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCUIEventTypes	GameController 名前空間は、外部のゲームコントローラーをサポートします。

代理人

Name	説明
ElementValueDidChangeHandler	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCAxis2DInputValueDidChangeCallback	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerAxisValueChangedHandler	ValueChangedHandlerの値変更ハンドラーとして使用されるデリゲート。
GCControllerButtonTouchedChanged	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCControllerButtonValueChanged	ValueChangedHandlerとPressedChangedHandlerのデリゲート。
GCControllerDirectionPadValueChangedHandler	ValueChangedHandlerの値変更ハンドラーとして使用されるデリゲート。
GCControllerHomeButtonSettingsDidChangeHandler	コントローラーの [ホーム] ボタンの設定が変更された後に呼び出されるハンドラー。
GCControllerTouchpadHandler	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCExtendedGamepadValueChangedHandler	ValueChangedHandlerの値変更ハンドラーとして使用されるデリゲート。
GCGamepadValueChangedHandler	ValueChangedHandlerの値変更ハンドラーとして使用されるデリゲート。
GCKeyboardValueChangedHandler	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCMicroGamepadValueChangedHandler	コントローラーの 1 つの要素が変更されるたびに呼び出されるハンドラー。
GCMouseMoved	GameController 名前空間は、外部のゲームコントローラーをサポートします。
GCVirtualControllerElementUpdateBlock	GameController 名前空間は、外部のゲームコントローラーをサポートします。
InputStateAvailableHandler	GameController 名前空間は、外部のゲームコントローラーをサポートします。

注釈

ゲームコントローラーは、iOS デバイスを含む "フォームフィッティング" コントローラーと、iOS デバイスまたは Mac にワイヤレスで接続する "拡張ワイヤレス" コントローラーの 2 つの形式で提供されます。

ゲームコントローラーはオプションコンポーネントである必要があります。ゲーム開発者は、ゲームコントローラーを持たないユーザーがゲームをプレイできるようにする必要があります。

フォームフィットコントローラは、システムによって自動的に検出されます。拡張ワイヤレスコントローラーは、アプリケーション開発者が StartWirelessControllerDiscovery を呼び出した後にシステムによって検出され、 ObserveDidConnect 通知ハンドラーが起動します。ワイヤレスコントローラーが切断されると、 ObserveDidDisconnect 通知が発生します。

ゲームコントローラーには、 GCGamepad と GCExtendedGamepadの 2 つのプロファイルがサポートされています。 GCControllerは、そのGamepadまたはそのExtendedGamepadプロパティに対して null 以外の値を持つことになります。アプリケーション開発者は、型を決定するためにそれらを読み取る必要があります。

GCGamepads には、2 つのショルダーボタン、D パッド ( GCControllerDirectionPad参照)、Y-B-A-X というラベルが付いた 4 つの面ボタンがあります。

GCExtendedGamepads には、同じ要素に加えて、2 つのトリガーボタンと 2 つのジョイスティックがあります ( GCControllerAxisInputを参照)。 Apple の概念図ではさらに LED アレイが示されていますが、現在、この要素へのプログラムによるアクセスはありません。

ゲームコントローラーデータを読み取る方法は 3 つあります。

手法	メソッド（方法）	Use
ポーリング	IsPressedやXAxis	ゲームループから直接読み取ります ( Updateを参照)。
イベント駆動	要素の `ValueChangedHandler` プロパティ ( ValueChangedHandler など)	ゲームコントローラーは、メインスレッドで更新プログラムを処理します。このフレームワークにより、同時に発生するイベントによって、一連の単一のコールバックが発生します。
調整スナップショット	SaveSnapshot、SaveSnapshot	コントローラーの状態をスナップショットします。マーシャリング、シリアル化、または遅延処理に適しています。

ゲームコントローラー名前空間の主要なクラスを次の図に示します。