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: Texto / String
• 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 1000ms, espere por 500ms e vibre por 2000ms.

Figura 2 - Exemplo de uso do bloco Vibrar