Share via


触覚フィードバック

Browse sample. サンプルを参照する

この記事では、.NET Multi-platform App UI (.NET MAUI) IHapticFeedback インターフェイスを使用して、デバイス上の触覚フィードバックを制御する方法について説明します。 触覚フィードバックは、一般に、ユーザーに応答を与えるためにデバイスによって提供される穏やかな振動感覚によって示されます。 触覚フィードバックの例としては、ユーザーが仮想キーボードで入力したときや、プレイヤーのキャラクターが敵のキャラクターと遭遇するゲームをプレイする場合などがあります。

IHapticFeedback インターフェイスの既定の実装は、HapticFeedback.Default プロパティを通じて利用できます。 IHapticFeedback インターフェイスと HapticFeedback クラスはどちらも Microsoft.Maui.Devices 名前空間に含まれます。

作業の開始

触覚フィードバック機能にアクセスするには、次のプラットフォーム固有の設定が必要です。

Vibrate アクセス許可が必要です。Android プロジェクト内で構成する必要があります。 これは次の方法で追加できます。

  • アセンブリベースのアクセス許可を追加します。

    Platforms/Android/MainApplication.cs ファイルを開き、using ディレクティブの後に次のアセンブリ属性を追加します。

    [assembly: UsesPermission(Android.Manifest.Permission.Vibrate)]
    

    または

  • Android マニフェストを更新します。

    Platforms/Android/AndroidManifest.xml ファイルを開き、manifest ノードに次を追加します。

    <uses-permission android:name="android.permission.VIBRATE" />
    

    または

  • マニフェスト エディターで Android マニフェストを更新します。

    Visual Studio で、Platforms/Android/AndroidManifest.xml ファイルをダブルクリックして、Android マニフェスト エディターを開きます。 次に、[必要なアクセス許可] で、[バイブレーション] アクセス許可をチェックします。 これにより、AndroidManifest.xml ファイルが自動的に更新されます。

触覚フィードバックを使用する

触覚フィードバック機能は、短い Click または LongPress の 2 つのモードで実行されます。 次のコード例では、ユーザーがどの Button をクリックしたかに基づいて、Click または LongPress の触覚フィードバック応答をユーザーに開始します。

private void HapticShortButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.Click);

private void HapticLongButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.LongPress);