A plugin for Tauri that provides a polyfill for Gamepad Web API that works on most common platforms.
npm install tauri-plugin-gamepad-apiA plugin for Tauri that provides a polyfill for Gamepad Web API that works on most common platforms.
!demo
It's built on top of gilrs library.
| Tauri version | git |
|---------------|-------|
| 1.x | 0.0.2 |
| 2.0.0-beta | 0.0.3 |
| 2.0.0-rc | 0.0.4 |
| 2.0.x | 0.0.5 |
By default WebKit does not support all the joysticks and gamepads, especially on Safari (macOS and iOS). It does support a bit more in Chrome's version of WebKit, but that's not the one used by Tauri.
Therefore this plugin was created to bridge this gap and provide same access via homogenous Gamepad API that's already available in most browsers.
YouTube
On the javascript side, simply call import 'tauri-plugin-gamepad-api'.
On the rust side, add .plugin(tauri_plugin_gamepad::init()) to your main's Tauri builder call.
See example for more.
- Haptic funcionality is not available (because gilrs doesn't support it, though sdl2 does).
- You'll get double ongamepadconnected for some of the devices (one from native implementation, and one from this plugin).
- tauri-plugin-gamepad on crates
- tauri-plugin-gamepad-api on npm
gilrs)| | Input | Hotplugging | Force feedback |
|------------------|:-----:|:-----------:|:--------------:|
| Linux/BSD (evdev)| ✓ | ✓ | ✓ |
| Windows (XInput) | ✓ | ✓ | ✓ |
| macOS | ✓ | ✓ | ✕ |
| iOS | ✓ | ✓ | ✕ |
| Android | ✕ | ✕ | ✕ |
Run npm run watch to transpile TypeScript API layer.
Run example demo using these commands:
``shell`
cd examples/tauri-app
npm run tauri dev
Make sure to include proper permissions to enable the plugin to share events with the webpage.
`json``
{
"$schema": "../gen/schemas/desktop-schema.json",
"identifier": "default",
"description": "Capability for the main window",
"windows": ["main"],
"permissions": [
"core:app:default",
"core:event:allow-listen",
"gamepad:default"
]
}
Copyright (c) 2023-2024 Eugene Hauptmann