sdl_gamepad 1.1.1

A Dart-friendly, cross-platform gamepads API that wraps SDL3 via the sdl3 package

sdl_gamepads

Read and control gamepads via the SDL3 backend (thanks to package:sdl3)

Features

• Open gamepads by their device ID or player index
• Extensive rumble support, including DualSense trigger rumble
• Query the current state of the gamepad and what buttons are pressed
• Query other USB, device, and power info from the gamepad.

Getting started

This package requires a compiled dynamically linked binary of SDL3 on your system. That means a .dll (Windows), .dylib (Mac), or .so (Linux). See the page on building SDL 3.0 for more details. When Native Assets are made generally available, this requirement will be handled for you.

Usage

if (!SdlLibrary.init()) {
  print("Could not open SDL");
  return;
};

final gamepad = SdlGamepad.fromPlayerIndex(0);
if (!gamepad.isConnected) {
  print("Gamepad is not connected");
  return;
}

final state = gamepad.getState();
print("Is A pressed? ${state.buttonA}");

SdlLibrary.dispose();

Additional information

This package is merely a wrapper on the amazing sdl3 package by sansuido, check out his other projects and support him!

This package is intending to be only a thin wrapper around the sdl3 package to just make the APIs more Dart-friendly. If something is missing, please file an issue, but adding features not already present in sdl3 is out-of-scope for this project.