次の方法で共有


触覚フィードバック

サンプルを参照。 サンプル を参照

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

IHapticFeedback インターフェイスの既定の実装は、HapticFeedback.Default プロパティを使用して使用できます。 IHapticFeedback インターフェイスと HapticFeedback クラスの両方が、Microsoft.Maui.Devices 名前空間に含まれています。

作業の開始

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

  • Android
  • iOS/Mac Catalyst
  • Windows

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 マニフェスト エディターを開きます。 次に、必要なアクセス許可 の項目で、「VIBRATE」 のアクセス許可を確認します。 これにより、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);

大事な

Apple プラットフォームでは、触覚フィードバック機能を UI スレッドで実行する必要があります。