Udostępnij za pośrednictwem


wibracje;

Browse sample. Przeglądanie przykładu

W tym artykule opisano sposób używania interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI). IVibration Ten interfejs umożliwia uruchamianie i zatrzymywanie funkcji wibracyjnych przez żądany czas.

Domyślna implementacja interfejsu IVibration jest dostępna za pośrednictwem Vibration.Default właściwości . Zarówno interfejs, jak IVibration i Vibration klasa są zawarte w Microsoft.Maui.Devices przestrzeni nazw.

Rozpocznij

Aby uzyskać dostęp do funkcji Vibration, wymagana jest następująca konfiguracja specyficzna dla platformy.

Wymagane VIBRATE jest uprawnienie i musi być skonfigurowane w projekcie systemu Android. To uprawnienie można dodać w następujący sposób:

  • Dodaj uprawnienie oparte na zestawie:

    Otwórz plik Platforms/Android/MainApplication.cs i dodaj następujące atrybuty zestawu po using dyrektywach:

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

    - lub -

  • Zaktualizuj manifest systemu Android:

    Otwórz plik Platforms/Android/AndroidManifest.xml i dodaj następujące elementy w węźlemanifest:

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

    - lub -

  • Zaktualizuj manifest systemu Android w edytorze manifestu:

    W programie Visual Studio kliknij dwukrotnie plik Platforms/Android/AndroidManifest.xml , aby otworzyć edytor manifestu systemu Android. Następnie w obszarze Wymagane uprawnienia sprawdź uprawnienie WIBE . Spowoduje to automatyczne zaktualizowanie pliku AndroidManifest.xml .

Wibrowanie urządzenia

Funkcjonalność drgań można zażądać przez określony czas lub wartość domyślną wynoszącą 500 milisekund. Poniższy przykład kodu losowo wibruje urządzenie z zakresu od jednego do siedmiu sekund przy użyciu polecenia 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();

Różnice między platformami

W tej sekcji opisano różnice specyficzne dla platformy dotyczące interfejsu API drgań.

Brak różnic między platformami.