Vibra o dispositivo móvel por um determinado período de tempo. Esse tempo é definido em milissegundos (ms). Importante destacar que dispositivos IOS ignoram o valor de tempo passado como parâmetro, utilizando um tempo predeterminado para vibração.


Figura 1 - Bloco Vibrar


Para que a vibração do dispositivo móvel seja perceptível, é necessário que o dispositivo não esteja no modo silencioso.

Compatibilidade

  • Bloco cliente mobile: cronapi.cordova.vibrate()

Retorno

Bloco sem retorno.

Parâmetros

Milissegundos

Período de tempo em milissegundos que o dispositivo irá vibrar. Para dispositivos Android, é possível especificar um padrão de vibração. Esse padrão é recebido pela função na forma de uma lista de números, como pode-se observar no tópico Exemplo.

  • Posição: 1
  • Inglês: Milliseconds
  • Tipo: Objeto / Object
  • Exemplo: "1000"

Exemplo

A função abaixo mostra um exemplo de uso do bloco Vibrar. Nela criamos um padrão de vibração, utilizando o bloco criar lista com. Para este exemplo, a lista faz com que o dispositivo vibre da seguinte maneira: vibre por 500ms, espere por 200ms, vibre por 800ms, espere por 500ms e vibre por 1100ms.


Figura 2 - Exemplo de uso do bloco Vibrar

Nesta página