触觉反馈

GitHub npm crates.io

API Reference

Android 和 iOS 上的触觉反馈和振动。

Android 上的振动支持没有标准/要求，因此反馈 API 在更实惠的手机（包括最近发布的手机）上可能无法正常工作。

支持的平台

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

设置

安装触觉反馈插件以开始使用。

自动

使用项目的包管理器添加依赖项：

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

手动

1. 在 src-tauri 文件夹中运行以下命令，将插件添加到 Cargo.toml 中的项目依赖项中：

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

2. 修改 lib.rs 以初始化插件：

   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. 使用你喜欢的 JavaScript 包管理器安装 JavaScript Guest 绑定：

   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

用法

触觉反馈插件在 JavaScript 中可用。

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

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

权限

默认情况下，所有潜在危险的插件命令和范围都被阻止，无法访问。你必须修改 capabilities 配置中的权限以启用这些功能。

有关更多信息，请参阅 功能概述 和 使用插件权限的步骤指南。

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"
  ]
}

Permission Table

Identifier	Description
haptics:allow-impact-feedback	Enables the impact_feedback command without any pre-configured scope.
haptics:deny-impact-feedback	Denies the impact_feedback command without any pre-configured scope.
haptics:allow-notification-feedback	Enables the notification_feedback command without any pre-configured scope.
haptics:deny-notification-feedback	Denies the notification_feedback command without any pre-configured scope.
haptics:allow-selection-feedback	Enables the selection_feedback command without any pre-configured scope.
haptics:deny-selection-feedback	Denies the selection_feedback command without any pre-configured scope.
haptics:allow-vibrate	Enables the vibrate command without any pre-configured scope.
haptics:deny-vibrate	Denies the vibrate command without any pre-configured scope.