Vibración

GitHubnpmcrates.io

Referencia de API

Retroalimentación háptica y vibraciones en Android e iOS.

No existen estándares/requisitos para el soporte de vibración en Android, por lo que las API de retroalimentación pueden no funcionar correctamente en teléfonos más económicos, incluidos algunos lanzados recientemente.

Plataformas Soportadas

Este plugin requiere una versión de Rust de al menos 1.77.2

Plataforma	Nivel	Notas
windows
linux
macos
android
ios

Configuración

Instala el plugin de haptics para comenzar.

Automático

Usa el gestor de paquetes de tu proyecto para agregar la dependencia:

npm

npm run tauri add haptics

yarn

yarn run tauri add haptics

pnpm

pnpm tauri add haptics

deno

deno task tauri add haptics

bun

bun tauri add haptics

cargo

cargo tauri add haptics

Manual

1. Ejecuta el siguiente comando en la carpeta src-tauri para agregar el plugin a las dependencias del proyecto en Cargo.toml:

   cargo add tauri-plugin-haptics --target 'cfg(any(target_os = "android", target_os = "ios"))'

2. Modifica lib.rs para inicializar el plugin:

   src-tauri/src/lib.rs

   #[cfg_attr(mobile, tauri::mobile_entry_point)]
   pub fn run() {
       tauri::Builder::default()
           .setup(|app| {
               #[cfg(mobile)]
               app.handle().plugin(tauri_plugin_haptics::init());
               Ok(())
           })
           .run(tauri::generate_context!())
           .expect("error while running tauri application");
   }

3. Instala los bindings de JavaScript utilizando tu gestor de paquetes de JavaScript preferido:

   npm

   npm install @tauri-apps/plugin-haptics

   yarn

   yarn add @tauri-apps/plugin-haptics

   pnpm

   pnpm add @tauri-apps/plugin-haptics

   deno

   deno add npm:@tauri-apps/plugin-haptics

   bun

   bun add @tauri-apps/plugin-haptics

Uso

El plugin de haptics está disponible en JavaScript.

import {
  vibrate,
  impactFeedback,
  notificationFeedback,
  selectionFeedback,
} from '@tauri-apps/plugin-haptics';

await vibrate(1);
await impactFeedback('medium');
await notificationFeedback('warning');
await selectionFeedback();

Permisos

De forma predeterminada, todos los comandos y alcances (scopes) potencialmente peligrosos del plugin están bloqueados y no se puede acceder a ellos. Debes modificar los permisos en tu configuración de capabilities para habilitarlos.

Consulta la Visión General de Capacidades para obtener más información y la guía paso a paso para usar permisos de plugins.

src-tauri/capabilities/mobile.json

{
  "$schema": "../gen/schemas/mobile-schema.json",
  "identifier": "mobile-capability",
  "windows": ["main"],
  "platforms": ["iOS", "android"],
  "permissions": [
    "haptics:allow-impact-feedback",
    "haptics:allow-notification-feedback",
    "haptics:allow-selection-feedback",
    "haptics:allow-vibrate"
  ]
}

Tabla de Permisos

Identificador	Descripción
haptics:allow-impact-feedback	Habilita el comando impact_feedback sin ningún alcance preconfigurado.
haptics:deny-impact-feedback	Deniega el comando impact_feedback sin ningún alcance preconfigurado.
haptics:allow-notification-feedback	Habilita el comando notification_feedback sin ningún alcance preconfigurado.
haptics:deny-notification-feedback	Deniega el comando notification_feedback sin ningún alcance preconfigurado.
haptics:allow-selection-feedback	Habilita el comando selection_feedback sin ningún alcance preconfigurado.
haptics:deny-selection-feedback	Deniega el comando selection_feedback sin ningún alcance preconfigurado.
haptics:allow-vibrate	Habilita el comando vibrate sin ningún alcance preconfigurado.
haptics:deny-vibrate	Deniega el comando vibrate sin ningún alcance preconfigurado.