震動

流覽範例

本文說明如何使用 .NET 多平臺應用程式 UI （.NET MAUI） IVibration 介面。 此介面可讓您啟動和停止所需的時間振動功能。

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

開始使用

若要存取 Vibration 功能，需要下列平臺特定的設定。

Android

需要 VIBRATE 許可權，而且必須在 Android 專案中設定。 您可以透過下列方式新增此許可權：

• 新增元件型許可權：

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

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

  - 或 -

• 更新 Android 資訊清單：

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

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

  - 或 -

• 更新資訊清單編輯器中的 Android 資訊清單：

  在 Visual Studio 中按兩下 [平臺/Android/AndroidManifest.xml ] 檔案，以開啟 Android 資訊清單編輯器。 然後，在 [必要許可權 ] 底下 ，檢查 [震盪 ] 許可權。 這將會自動更新 AndroidManifest.xml 檔案。

iOS/Mac Catalyst

不需要任何設定。

Windows

不需要任何設定。

震動裝置

您可以針對一組時間或預設值 500 毫秒要求震動功能。 下列程式碼範例會使用 Vibrate(TimeSpan) ，在一到七秒之間隨機振動裝置：

private void VibrateStartButton_Clicked(object sender, EventArgs e)
{
    int secondsToVibrate = Random.Shared.Next(1, 7);
    TimeSpan vibrationLength = TimeSpan.FromSeconds(secondsToVibrate);
    
    Vibration.Default.Vibrate(vibrationLength);
}

private void VibrateStopButton_Clicked(object sender, EventArgs e) =>
    Vibration.Default.Cancel();

平臺差異

本節說明與震動 API 的平臺特定差異。

Android

無平台差異。

iOS/Mac Catalyst

• 僅在裝置設定為「鈴響時震動」時震動。
• 一律震動 500 毫秒。
• 無法取消震動。

Windows

無平台差異。