mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2026-06-15 16:13:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
95dafa2bcd90ee20a1103a9b6b2456e8b7455f8f
SDL/src/joystick/emscripten/SDL_sysjoystick.c
Nintorch 95dafa2bcd Don't modify the driver signature on the web
2026-06-12 07:43:07 -07:00

712 lines
23 KiB
C
Raw Blame History

/*
Simple DirectMedia Layer
Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
*/
#include "SDL_internal.h"
#ifdef SDL_JOYSTICK_EMSCRIPTEN
#include <stdio.h> // For the definition of NULL
#include "SDL_sysjoystick_c.h"
#include "../SDL_joystick_c.h"
#include "../usb_ids.h"
static SDL_joylist_item *JoystickByIndex(int index);
static SDL_joylist_item *SDL_joylist = NULL;
static SDL_joylist_item *SDL_joylist_tail = NULL;
static int numjoysticks = 0;
static int SDL_GetEmscriptenJoystickVendor(int device_index)
{
return MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
if (!gamepad) {
return 0;
}
// Chrome, Edge, Opera: Wireless Controller (STANDARD GAMEPAD Vendor: 054c Product: 09cc)
let vendor_str = 'Vendor: ';
if (gamepad['id']['indexOf'](vendor_str) > 0) {
let vendor_str_index = gamepad['id']['indexOf'](vendor_str) + vendor_str['length'];
return parseInt(gamepad['id']['substr'](vendor_str_index, 4), 16);
}
// Firefox, Safari: 046d-c216-Logitech Dual Action (or 46d-c216-Logicool Dual Action)
let id_split = gamepad['id']['split']('-');
if (id_split['length'] > 1 && !isNaN(parseInt(id_split[0], 16))) {
return parseInt(id_split[0], 16);
}
return 0;
}, device_index);
}
static int SDL_GetEmscriptenJoystickProduct(int device_index)
{
return MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
if (!gamepad) {
return 0;
}
// Chrome, Edge, Opera: Wireless Controller (STANDARD GAMEPAD Vendor: 054c Product: 09cc)
let product_str = 'Product: ';
if (gamepad['id']['indexOf'](product_str) > 0) {
let product_str_index = gamepad['id']['indexOf'](product_str) + product_str['length'];
return parseInt(gamepad['id']['substr'](product_str_index, 4), 16);
}
// Firefox, Safari: 046d-c216-Logitech Dual Action (or 46d-c216-Logicool Dual Action)
let id_split = gamepad['id']['split']('-');
if (id_split['length'] > 1 && !isNaN(parseInt(id_split[1], 16))) {
return parseInt(id_split[1], 16);
}
return 0;
}, device_index);
}
static int SDL_IsEmscriptenJoystickXInput(int device_index)
{
return MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
if (!gamepad) {
return 0;
}
// Chrome, Edge, Opera: Xbox 360 Controller (XInput STANDARD GAMEPAD)
// Firefox: xinput
// TODO: Safari
return gamepad['id']['toLowerCase']()['indexOf']('xinput') >= 0;
}, device_index);
}
static int SDL_GetEmscriptenOSID()
{
return MAIN_THREAD_EM_ASM_INT({
const os = ([
'Android',
'Linux',
'iPhone',
'Macintosh',
'Windows',
]);
const ua = navigator['userAgent'];
for (let i = 0; i < os.length; i++) {
if (ua['indexOf'](os[i]) >= 0) {
return i + 1;
}
}
return 0;
});
}
static EM_BOOL Emscripten_JoyStickConnected(int eventType, const EmscriptenGamepadEvent *gamepadEvent, void *userData)
{
SDL_joylist_item *item;
int i;
Uint16 bus;
Uint16 vendor, product;
Uint8 os_id;
bool is_xinput;
SDL_LockJoysticks();
if (JoystickByIndex(gamepadEvent->index) != NULL) {
goto done;
}
item = (SDL_joylist_item *)SDL_malloc(sizeof(SDL_joylist_item));
if (!item) {
goto done;
}
SDL_zerop(item);
item->index = gamepadEvent->index;
bus = SDL_HARDWARE_BUS_UNKNOWN;
vendor = SDL_GetEmscriptenJoystickVendor(gamepadEvent->index);
product = SDL_GetEmscriptenJoystickProduct(gamepadEvent->index);
is_xinput = SDL_IsEmscriptenJoystickXInput(gamepadEvent->index);
// Use a generic VID/PID representing an XInput controller
if (!vendor && !product && is_xinput) {
vendor = USB_VENDOR_MICROSOFT;
product = USB_PRODUCT_XBOX360_XUSB_CONTROLLER;
}
os_id = SDL_GetEmscriptenOSID();
if (os_id != 0) {
if (os_id == 1 || os_id == 3) { // Android or iOS (mobile)
bus = SDL_HARDWARE_BUS_BLUETOOTH;
} else { // Desktop
bus = SDL_HARDWARE_BUS_USB;
}
}
if (SDL_strcmp(gamepadEvent->mapping, "standard") == 0) {
// We should differentiate between devices that are mapped or unmapped by the browser.
os_id += 0x80;
}
item->name = SDL_CreateJoystickName(vendor, product, NULL, gamepadEvent->id);
if (!item->name) {
SDL_free(item);
goto done;
}
if (vendor && product) {
item->guid = SDL_CreateJoystickGUID(bus, vendor, product, 0, NULL, gamepadEvent->id, 0, os_id);
} else {
item->guid = SDL_CreateJoystickGUIDForName(item->name);
item->guid.data[15] = os_id;
}
item->mapping = SDL_strdup(gamepadEvent->mapping);
if (!item->mapping) {
SDL_free(item->name);
SDL_free(item);
goto done;
}
const int real_button_count = gamepadEvent->numButtons;
const int real_axis_count = gamepadEvent->numAxes;
int first_trigger_button = -1;
int first_hat_button = -1;
int num_buttons = gamepadEvent->numButtons;
int num_axes = gamepadEvent->numAxes;
bool triggers_are_buttons = false;
if ((SDL_strcmp(gamepadEvent->mapping, "standard") == 0) && (num_buttons >= 16)) { // maps to a game console gamepad layout, turn the d-pad into a hat, treat triggers as analog.
num_buttons -= 4; // 4 dpad buttons become a hat.
first_hat_button = 12;
if (num_axes == 4) { // Chrome gives the triggers analog button values, Firefox exposes them as extra axes. Both have the digital buttons.
num_axes += 2; // the two trigger "buttons"
triggers_are_buttons = true;
}
// dump the digital trigger buttons in any case.
first_trigger_button = 6;
num_buttons -= 2;
}
item->first_hat_button = first_hat_button;
item->first_trigger_button = first_trigger_button;
item->triggers_are_buttons = triggers_are_buttons;
item->nhats = (first_hat_button >= 0) ? 1 : 0;
item->naxes = num_axes;
item->nbuttons = num_buttons;
item->device_instance = SDL_GetNextObjectID();
item->timestamp = gamepadEvent->timestamp;
int buttonidx = 0;
for (i = 0; i < real_button_count; i++, buttonidx++) {
if (buttonidx == first_hat_button) {
buttonidx += 4; // skip these buttons, we're treating them as hat input.
} else if (buttonidx == first_trigger_button) {
buttonidx += 2; // skip these buttons, we're treating them as axes.
}
item->analogButton[i] = gamepadEvent->analogButton[buttonidx];
item->digitalButton[i] = gamepadEvent->digitalButton[buttonidx];
}
for (i = 0; i < real_axis_count; i++) {
item->axis[i] = gamepadEvent->axis[i];
}
if (item->triggers_are_buttons) {
item->axis[real_axis_count] = (gamepadEvent->analogButton[first_trigger_button] * 2.0f) - 1.0f;
item->axis[real_axis_count+1] = (gamepadEvent->analogButton[first_trigger_button+1] * 2.0f) - 1.0f;
}
SDL_assert(item->nhats <= 1); // there is (currently) only ever one of these, faked from the d-pad buttons.
if (first_hat_button != -1) {
Uint8 value = SDL_HAT_CENTERED;
// this currently expects the first button to be up, then down, then left, then right.
if (gamepadEvent->digitalButton[first_hat_button + 0]) {
value |= SDL_HAT_UP;
}
if (gamepadEvent->digitalButton[first_hat_button + 1]) {
value |= SDL_HAT_DOWN;
}
if (gamepadEvent->digitalButton[first_hat_button + 2]) {
value |= SDL_HAT_LEFT;
}
if (gamepadEvent->digitalButton[first_hat_button + 3]) {
value |= SDL_HAT_RIGHT;
}
item->hat = value;
}
if (!SDL_joylist_tail) {
SDL_joylist = SDL_joylist_tail = item;
} else {
SDL_joylist_tail->next = item;
SDL_joylist_tail = item;
}
++numjoysticks;
SDL_PrivateJoystickAdded(item->device_instance);
#ifdef DEBUG_JOYSTICK
SDL_Log("Number of joysticks is %d", numjoysticks);
#endif
#ifdef DEBUG_JOYSTICK
SDL_Log("Added joystick with index %d", item->index);
#endif
done:
SDL_UnlockJoysticks();
return 1;
}
static EM_BOOL Emscripten_JoyStickDisconnected(int eventType, const EmscriptenGamepadEvent *gamepadEvent, void *userData)
{
SDL_joylist_item *item = SDL_joylist;
SDL_joylist_item *prev = NULL;
SDL_LockJoysticks();
while (item) {
if (item->index == gamepadEvent->index) {
break;
}
prev = item;
item = item->next;
}
if (!item) {
goto done;
}
if (item->joystick) {
item->joystick->hwdata = NULL;
}
if (prev) {
prev->next = item->next;
} else {
SDL_assert(SDL_joylist == item);
SDL_joylist = item->next;
}
if (item == SDL_joylist_tail) {
SDL_joylist_tail = prev;
}
// Need to decrement the joystick count before we post the event
--numjoysticks;
SDL_PrivateJoystickRemoved(item->device_instance);
#ifdef DEBUG_JOYSTICK
SDL_Log("Removed joystick with id %d", item->device_instance);
#endif
SDL_free(item->name);
SDL_free(item->mapping);
SDL_free(item);
done:
SDL_UnlockJoysticks();
return 1;
}
// Function to perform any system-specific joystick related cleanup
static void EMSCRIPTEN_JoystickQuit(void)
{
SDL_joylist_item *item = NULL;
SDL_joylist_item *next = NULL;
for (item = SDL_joylist; item; item = next) {
next = item->next;
SDL_free(item->mapping);
SDL_free(item->name);
SDL_free(item);
}
SDL_joylist = SDL_joylist_tail = NULL;
numjoysticks = 0;
emscripten_set_gamepadconnected_callback(NULL, 0, NULL);
emscripten_set_gamepaddisconnected_callback(NULL, 0, NULL);
}
// Function to scan the system for joysticks.
static bool EMSCRIPTEN_JoystickInit(void)
{
int rc, i, numjs;
EmscriptenGamepadEvent gamepadState;
numjoysticks = 0;
rc = emscripten_sample_gamepad_data();
// Check if gamepad is supported by browser
if (rc == EMSCRIPTEN_RESULT_NOT_SUPPORTED) {
return SDL_SetError("Gamepads not supported");
}
numjs = emscripten_get_num_gamepads();
// handle already connected gamepads
if (numjs > 0) {
for (i = 0; i < numjs; i++) {
rc = emscripten_get_gamepad_status(i, &gamepadState);
if (rc == EMSCRIPTEN_RESULT_SUCCESS) {
Emscripten_JoyStickConnected(EMSCRIPTEN_EVENT_GAMEPADCONNECTED,
&gamepadState,
NULL);
}
}
}
rc = emscripten_set_gamepadconnected_callback(NULL,
0,
Emscripten_JoyStickConnected);
if (rc != EMSCRIPTEN_RESULT_SUCCESS) {
EMSCRIPTEN_JoystickQuit();
return SDL_SetError("Could not set gamepad connect callback");
}
rc = emscripten_set_gamepaddisconnected_callback(NULL,
0,
Emscripten_JoyStickDisconnected);
if (rc != EMSCRIPTEN_RESULT_SUCCESS) {
EMSCRIPTEN_JoystickQuit();
return SDL_SetError("Could not set gamepad disconnect callback");
}
return true;
}
// Returns item matching given SDL device index.
static SDL_joylist_item *JoystickByDeviceIndex(int device_index)
{
SDL_joylist_item *item = SDL_joylist;
while (0 < device_index) {
--device_index;
item = item->next;
}
return item;
}
// Returns item matching given HTML gamepad index.
static SDL_joylist_item *JoystickByIndex(int index)
{
SDL_joylist_item *item = SDL_joylist;
if (index < 0) {
return NULL;
}
while (item) {
if (item->index == index) {
break;
}
item = item->next;
}
return item;
}
static int EMSCRIPTEN_JoystickGetCount(void)
{
return numjoysticks;
}
static void EMSCRIPTEN_JoystickDetect(void)
{
}
static bool EMSCRIPTEN_JoystickIsDevicePresent(Uint16 vendor_id, Uint16 product_id, Uint16 version, const char *name)
{
// We don't override any other drivers
return false;
}
static const char *EMSCRIPTEN_JoystickGetDeviceName(int device_index)
{
return JoystickByDeviceIndex(device_index)->name;
}
static const char *EMSCRIPTEN_JoystickGetDevicePath(int device_index)
{
return NULL;
}
static int EMSCRIPTEN_JoystickGetDeviceSteamVirtualGamepadSlot(int device_index)
{
return -1;
}
static int EMSCRIPTEN_JoystickGetDevicePlayerIndex(int device_index)
{
return -1;
}
static void EMSCRIPTEN_JoystickSetDevicePlayerIndex(int device_index, int player_index)
{
}
static SDL_JoystickID EMSCRIPTEN_JoystickGetDeviceInstanceID(int device_index)
{
return JoystickByDeviceIndex(device_index)->device_instance;
}
static bool EMSCRIPTEN_JoystickOpen(SDL_Joystick *joystick, int device_index)
{
SDL_joylist_item *item = JoystickByDeviceIndex(device_index);
if (!item) {
return SDL_SetError("No such device");
}
if (item->joystick) {
return SDL_SetError("Joystick already opened");
}
joystick->hwdata = (struct joystick_hwdata *)item;
item->joystick = joystick;
// HTML5 Gamepad API doesn't offer hats, but we can fake it from the d-pad buttons on the "standard" mapping.
joystick->nhats = item->nhats;
joystick->nbuttons = item->nbuttons;
joystick->naxes = item->naxes;
item->rumble_available = MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
return gamepad && 'vibrationActuator' in gamepad; // Don't check the vibrationActuator.effects array here, because it's not defined in Safari
}, item->index);
if (item->rumble_available) {
SDL_SetBooleanProperty(SDL_GetJoystickProperties(joystick), SDL_PROP_JOYSTICK_CAP_RUMBLE_BOOLEAN, true);
}
item->trigger_rumble_available = MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
// This effect is not supported in Safari, so it's okay for us to check the vibrationActuator.effects array here for the browsers that do support it
return gamepad && 'vibrationActuator' in gamepad && 'effects' in gamepad['vibrationActuator'] && gamepad['vibrationActuator']['effects']['includes']('trigger-rumble');
}, item->index);
if (item->trigger_rumble_available) {
SDL_SetBooleanProperty(SDL_GetJoystickProperties(joystick), SDL_PROP_JOYSTICK_CAP_TRIGGER_RUMBLE_BOOLEAN, true);
}
return true;
}
/* Function to update the state of a joystick - called as a device poll.
* This function shouldn't update the joystick structure directly,
* but instead should call SDL_PrivateJoystick*() to deliver events
* and update joystick device state.
*/
static void EMSCRIPTEN_JoystickUpdate(SDL_Joystick *joystick)
{
EmscriptenGamepadEvent gamepadState;
SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata;
int i, result;
Uint64 timestamp = SDL_GetTicksNS();
emscripten_sample_gamepad_data();
if (item) {
result = emscripten_get_gamepad_status(item->index, &gamepadState);
if (result == EMSCRIPTEN_RESULT_SUCCESS) {
if (gamepadState.timestamp == 0 || gamepadState.timestamp != item->timestamp) {
const int first_hat_button = item->first_hat_button;
const int first_trigger_button = item->first_trigger_button;
const int real_button_count = gamepadState.numButtons;
const int real_axis_count = gamepadState.numAxes;
int buttonidx = 0;
for (i = 0; i < real_button_count; i++, buttonidx++) {
if (buttonidx == first_hat_button) {
buttonidx += 4; // skip these buttons, we're treating them as hat input.
} else if (buttonidx == first_trigger_button) {
buttonidx += 2; // skip these buttons, we're treating them as axes.
}
if (item->digitalButton[i] != gamepadState.digitalButton[buttonidx]) {
const bool down = (gamepadState.digitalButton[buttonidx] != 0);
SDL_SendJoystickButton(timestamp, item->joystick, i, down);
}
// store values to compare them in the next update
item->analogButton[i] = gamepadState.analogButton[buttonidx];
item->digitalButton[i] = gamepadState.digitalButton[buttonidx];
}
for (i = 0; i < real_axis_count; i++) {
if (item->axis[i] != gamepadState.axis[i]) {
SDL_SendJoystickAxis(timestamp, item->joystick, i, (Sint16)(32767.0f * gamepadState.axis[i]));
item->axis[i] = gamepadState.axis[i];
}
}
if (item->triggers_are_buttons) {
for (i = 0; i < 2; i++) {
if (item->axis[real_axis_count+i] != gamepadState.analogButton[first_trigger_button+i]) {
SDL_SendJoystickAxis(timestamp, item->joystick, real_axis_count+i, (Sint16)(32767.0f * ((gamepadState.analogButton[first_trigger_button+i] * 2.0f) - 1.0f)));
item->axis[real_axis_count+i] = gamepadState.analogButton[first_trigger_button+i];
}
}
}
SDL_assert(item->nhats <= 1); // there is (currently) only ever one of these, faked from the d-pad buttons.
if (item->nhats) {
Uint8 value = SDL_HAT_CENTERED;
// this currently expects the first button to be up, then down, then left, then right.
if (gamepadState.digitalButton[first_hat_button + 0]) {
value |= SDL_HAT_UP;
} else if (gamepadState.digitalButton[first_hat_button + 1]) {
value |= SDL_HAT_DOWN;
}
if (gamepadState.digitalButton[first_hat_button + 2]) {
value |= SDL_HAT_LEFT;
} else if (gamepadState.digitalButton[first_hat_button + 3]) {
value |= SDL_HAT_RIGHT;
}
if (item->hat != value) {
item->hat = value;
SDL_SendJoystickHat(timestamp, item->joystick, 0, value);
}
}
item->timestamp = gamepadState.timestamp;
}
}
}
}
// Function to close a joystick after use
static void EMSCRIPTEN_JoystickClose(SDL_Joystick *joystick)
{
SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata;
if (item) {
item->joystick = NULL;
}
}
static SDL_GUID EMSCRIPTEN_JoystickGetDeviceGUID(int device_index)
{
return JoystickByDeviceIndex(device_index)->guid;
}
static bool Emscripten_UpdateRumble(SDL_joylist_item *item)
{
bool result = MAIN_THREAD_EM_ASM_INT({
let gamepad = navigator['getGamepads']()[$0];
if (!gamepad) {
return false;
}
// We check if rumble is available in EMSCRIPTEN_JoystickRumble() and EMSCRIPTEN_JoystickRumbleTriggers().
// From my testing using "dual-rumble" here covers both main rumble and trigger rumble.
gamepad['vibrationActuator']['playEffect']('dual-rumble', {
'startDelay': 0,
'duration': 3000,
'weakMagnitude': $1 / 0xFFFF,
'strongMagnitude': $2 / 0xFFFF,
'leftTrigger': $3 / 0xFFFF,
'rightTrigger': $4 / 0xFFFF,
});
return true;
}, item->index, item->weak_magnitude_rumble, item->strong_magnitude_rumble, item->left_trigger_rumble, item->right_trigger_rumble);
return result;
}
static bool EMSCRIPTEN_JoystickRumble(SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble)
{
SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata;
if (!item || !item->rumble_available) {
return SDL_Unsupported();
}
item->strong_magnitude_rumble = low_frequency_rumble;
item->weak_magnitude_rumble = high_frequency_rumble;
return Emscripten_UpdateRumble(item);
}
static bool EMSCRIPTEN_JoystickRumbleTriggers(SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble)
{
SDL_joylist_item *item = (SDL_joylist_item *)joystick->hwdata;
if (!item || !item->trigger_rumble_available) {
return SDL_Unsupported();
}
item->left_trigger_rumble = left_rumble;
item->right_trigger_rumble = right_rumble;
return Emscripten_UpdateRumble(item);
}
static bool EMSCRIPTEN_JoystickGetGamepadMapping(int device_index, SDL_GamepadMapping *out)
{
return false;
}
static bool EMSCRIPTEN_JoystickSetLED(SDL_Joystick *joystick, Uint8 red, Uint8 green, Uint8 blue)
{
return SDL_Unsupported();
}
static bool EMSCRIPTEN_JoystickSendEffect(SDL_Joystick *joystick, const void *data, int size)
{
return SDL_Unsupported();
}
static bool EMSCRIPTEN_JoystickSetSensorsEnabled(SDL_Joystick *joystick, bool enabled)
{
return SDL_Unsupported();
}
SDL_JoystickDriver SDL_EMSCRIPTEN_JoystickDriver = {
EMSCRIPTEN_JoystickInit,
EMSCRIPTEN_JoystickGetCount,
EMSCRIPTEN_JoystickDetect,
EMSCRIPTEN_JoystickIsDevicePresent,
EMSCRIPTEN_JoystickGetDeviceName,
EMSCRIPTEN_JoystickGetDevicePath,
EMSCRIPTEN_JoystickGetDeviceSteamVirtualGamepadSlot,
EMSCRIPTEN_JoystickGetDevicePlayerIndex,
EMSCRIPTEN_JoystickSetDevicePlayerIndex,
EMSCRIPTEN_JoystickGetDeviceGUID,
EMSCRIPTEN_JoystickGetDeviceInstanceID,
EMSCRIPTEN_JoystickOpen,
EMSCRIPTEN_JoystickRumble,
EMSCRIPTEN_JoystickRumbleTriggers,
EMSCRIPTEN_JoystickSetLED,
EMSCRIPTEN_JoystickSendEffect,
EMSCRIPTEN_JoystickSetSensorsEnabled,
EMSCRIPTEN_JoystickUpdate,
EMSCRIPTEN_JoystickClose,
EMSCRIPTEN_JoystickQuit,
EMSCRIPTEN_JoystickGetGamepadMapping
};
#endif // SDL_JOYSTICK_EMSCRIPTEN
Reference in New Issue View Git Blame Copy Permalink