NativeScript Vibrate

Un plugin para NativeScript que facilita la vibración de dispositivos Android e iOS

Instalación

Ejecuta el siguiente comando desde la raíz de tu proyecto:

1
$ tns plugin add nativescript-vibrate

Este comando instala automáticamente los archivos necesarios, así como almacena nativescript-vibrate como una dependencia en el archivo package.json de tu proyecto.

Permisos

Android

Para usar la funcionalidad de vibración en Android, tu aplicación debe solicitar permiso para acceder al vibrador del dispositivo. El plugin agrega automáticamente los permisos necesarios que se muestran a continuación para que no tenga que preocuparse por editar el Manifiesto de Android.

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

Uso

Para usar el módulo de vibración debes primero importarlo usando require():

1
2
var Vibrate = require('nativescript-vibrate').Vibrate;
var vibrator = new Vibrate();

Si usas Typescript, puedes importarlo de esta manera:

1
2
import { Vibrate } from 'nativescript-vibrate';
let vibrator = new Vibrate();

Después de tener una referencia al módulo, puede llamar a su método vibrate(milliseconds).

1
2
// my-page.js
vibrator.vibrate(2000);

Si prefieres usar un patrón de vibración, puedes intentar:

1
2
// my-page.js
vibrator.vibrate([1000, 300, 500, 2000]);

Notas

iOS

No hay una API para vibrar durante una cantidad de tiempo o un patrón de vibración, por lo que vibrará durante el período de tiempo predeterminado no importa lo que pase.

API

Solo hay un método disponible: vibrate(), con las siguientes propiedades:

Propiedad Valor Predeterminado Descripción Android iOS
time 300 La cantidad en milisegundos para hacer vibrar el dispositivo. También puede ser un arreglo de longs para activar o desactivar el vibrador. ✔︎
repeat -1 El índice que indica cuantas veces se debe repetir la vibración, o -1 si no deseas repetir. ✔︎