Xamarin.Essentials:Vibração

  • Artigo

A classe Vibration permite iniciar e interromper a funcionalidade de vibrar por um tempo desejado.

Introdução

Para começar a usar essa API, leia o guia de introdução para Xamarin.Essentials para garantir que a biblioteca esteja instalada e configurada corretamente em seus projetos.

Para acessar a funcionalidade de Vibração, a seguinte configuração específica da plataforma é necessária.

A permissão de Vibração é necessária e deve ser configurada no projeto do Android. Isso pode ser usado das seguintes maneiras:

Abra o arquivo AssemblyInfo.cs na pasta Propriedades e adicione:

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

OU Atualize o Manifesto do Android:

Abra o arquivo AndroidManifest.xml na pasta Propriedades e adicione o seguinte dentro do nó de manifesto .

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

Ou clique com o botão direito do mouse no projeto do Android e abra as propriedades do projeto. Em Manifesto do Android, localize a área Permissões necessárias: e marque a permissão VIBRAR. Isso atualizará automaticamente o arquivo AndroidManifest.xml.

Como usar a Vibração

Adicione uma referência a Xamarin.Essentials em sua classe:

using Xamarin.Essentials;

A funcionalidade de vibração pode ser solicitada por um determinado tempo ou pelo padrão de 500 milissegundos.

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.
}

O cancelamento da vibração do dispositivo pode ser solicitado com o método Cancel:

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

Diferenças entre plataformas

Sem diferenças entre plataformas.

API

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.