VibrationDevice Classe

Definição

Namespace:

Windows.Phone.Devices.Notification

Vibra o telefone.

public ref class VibrationDevice sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Phone.PhoneContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class VibrationDevice final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Phone.PhoneContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class VibrationDevice

Public NotInheritable Class VibrationDevice

Herança

Object Platform::Object IInspectable VibrationDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows Mobile Extension SDK (introduzida na 10.0.10240.0)
API contract	Windows.Phone.PhoneContract (introduzida na v1.0)

Exemplos

Você vibra o telefone chamando o método Vibrate da classe VibrationDevice.

1. Importe o namespace Windows.Phone.Devices.Notification .

using Windows.Phone.Devices.Notification;

1. Obtenha uma referência ao controlador de vibração chamando o método GetDefault estático da classe VibrationDevice.

VibrationDevice testVibrationDevice = VibrationDevice.GetDefault();

1. Inicie a vibração chamando o método Vibrate da classe VibrationDevice. Especifique a duração como um valor TimeSpan .

testVibrationDevice.Vibrate(TimeSpan.FromSeconds(3));

1. Se necessário, interrompa a vibração chamando o método Cancel da classe VibrationDevice.

testVibrationDevice.Cancel();

Comentários

Windows Phone dispositivos incluem um controlador de vibração. Seu aplicativo pode vibrar o telefone por até 5 segundos para notificar o usuário sobre um evento importante.

Use o recurso de vibração com moderação. Não confie no recurso de vibração para notificações críticas, pois o usuário pode desabilitar a vibração.

Para testar um aplicativo que usa o controlador de vibração com eficiência, você precisa testá-lo em um dispositivo físico. O emulador não pode simular a vibração e não fornece comentários audíveis ou visuais de que a vibração está ocorrendo.

Um aplicativo em execução em segundo plano não pode vibrar o telefone. Se o código tentar usar vibração enquanto o aplicativo estiver em execução em segundo plano, nada acontecerá, mas nenhuma exceção será gerada. Se você quiser vibrar o telefone enquanto o aplicativo estiver em execução em segundo plano, será necessário implementar uma notificação do sistema.

Métodos

Cancel()	Interrompe a vibração do telefone.
GetDefault()	Obtém uma instância da classe VibrationDevice .
Vibrate(TimeSpan)	Vibra o telefone pela duração especificada (de 0 a 5 segundos).