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
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, a partir da lista de números definida como "padrão". 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.
Para testar a aplicação corretamente, será necessário compilar e instalar o aplicativo no dispositivo móvel.