共用方式為

觸覺回饋

  • 發行項

瀏覽範例。 瀏覽範例

本文說明如何使用 .NET 多平臺應用程式 UI （.NET MAUI） IHapticFeedback 介面來控制裝置上的觸覺回饋。 觸覺回饋通常以裝置提供的溫和震動感覺來向使用者提供回應。 觸覺回饋的一些範例是當使用者在虛擬鍵盤上打字，或當他們玩遊戲時，玩家角色遇到敵方角色。

IHapticFeedback 介面的預設實作可透過 HapticFeedback.Default 屬性取得。 IHapticFeedback 介面和 HapticFeedback 類別都包含在 Microsoft.Maui.Devices 命名空間中。

開始使用

若要存取觸覺回饋功能，需要下列平臺特定設定。

需要 Vibrate 許可權，而且必須在Android項目中設定。 這可以透過下列方式新增：

  • 新增基於組件的權限：

    開啟 Platform/Android/MainApplication.cs 檔案，並在 using 指示詞之後新增下列元件屬性：

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

    -或-

  • 更新 Android Manifest：

    開啟 Platform/Android/AndroidManifest.xml 檔案，並在 [manifest] 節點中新增下列內容：

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

    -或-

  • 更新 Android Manifest 檔案，在清單編輯器中：

    在 Visual Studio 中，按兩下 Platform/Android/AndroidManifest.xml 檔案，以開啟 Android 指令清單編輯器。 然後，在 [必要許可權] 底下， 檢查 VIBRATE 許可權。 這會自動更新 AndroidManifest.xml 檔案。

使用觸覺回饋

觸覺回饋功能會以兩種模式執行：簡短 Click 或 LongPress。 下列程式碼範例會根據使用者點擊的 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 線程上執行。