Haptics（ハプティクス／触覚）

《訳注》

Plugin 説明内容の英語表記部分について　Plugin の各章は、原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

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

セットアップ

はじめに、「haptics」プラグインをインストールしてください。

自動で設定
手動で設定

自分のプロジェクトのパッケージ・マネージャーを使用して依存関係を追加します：

npm run tauri add haptics

yarn run tauri add haptics

pnpm tauri add haptics

deno task tauri add haptics

bun tauri add haptics

cargo tauri add haptics

src-tauri フォルダで次のコマンドを実行して、このプラグインを Cargo.toml 内のプロジェクトの依存関係に追加します：
```
cargo add tauri-plugin-haptics --target 'cfg(any(target_os = "android", target_os = "ios"))'
`
```

追加したプラグインを初期化するために 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");
}

お好みの JavaScript パッケージ・マネージャーを使用して、「JavaScript Guest」バインディングをインストールします：

npm install @tauri-apps/plugin-haptics

yarn add @tauri-apps/plugin-haptics

pnpm add @tauri-apps/plugin-haptics

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

bun add @tauri-apps/plugin-haptics

Usage

「haptics」プラグインは JavaScript で利用できます。

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

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

アクセス権限 Permissions

デフォルトでは、潜在的に危険なプラグイン・コマンドとそのスコープ（有効範囲）はすべてブロックされており、アクセスできません。これらを有効にするには、capabilities 設定でアクセス権限を変更する必要があります。

詳細については「セキュリティ・レベル Capabilities」の章を参照してください。また、プラグインのアクセス権限を設定するには「プライグン・アクセス権の使用」の章のステップ・バイ・ステップ・ガイドを参照してください。

{
  "$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.

【※ この日本語版は、「Nov 19, 2025 英語版」に基づいています】

Support on Open Collective Sponsor on GitHub