Leggere in inglese

Condividi tramite


Xamarin.Essentials:Vibrazione

La classe Vibration consente di avviare e arrestare la funzionalità di vibrazione per un periodo di tempo desiderato.

Operazioni preliminari

Per iniziare a usare questa API, leggere la guida introduttiva per Xamarin.Essentials assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Per accedere alla funzionalità Vibration, è necessaria la configurazione seguente specifica della piattaforma.

L'autorizzazione Vibrate è obbligatoria e deve essere configurata nel progetto Android. È possibile aggiungerla nei modi seguenti:

Aprire il file AssemblyInfo.cs nella cartella Proprietà e aggiungere:

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

OPPURE aggiornare il manifesto di Android:

Aprire il file AndroidManifest.xml nella cartella Proprietà e aggiungere quanto segue all'interno del nodo manifest.

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

Oppure fare clic con il pulsante destro del mouse sul progetto Android e aprire le proprietà del progetto. In Manifesto Android trovare l'area Autorizzazioni necessarie e selezionare l'autorizzazione VIBRATE. Il file AndroidManifest.xml verrà aggiornato automaticamente.

Uso di Vibration

Aggiungere un riferimento a Xamarin.Essentials nella classe :

C#
using Xamarin.Essentials;

La funzionalità Vibration può essere richiesta per un periodo di tempo impostato o per 500 millisecondi, che è l'impostazione predefinita.

C#
try
{
    // Use default vibration length
    Vibration.Vibrate();

    // Or use specified time
    var duration = TimeSpan.FromSeconds(1);
    Vibration.Vibrate(duration);
}
catch (FeatureNotSupportedException ex)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Other error has occurred.
}

L'annullamento della vibrazione del dispositivo può essere richiesto con il metodo Cancel:

C#
try
{
    Vibration.Cancel();
}
catch (FeatureNotSupportedException ex)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Other error has occurred.
}

Differenze tra le piattaforme

Non esistono differenze per questa piattaforma.

API

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.