SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS(3)

💖 SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS 🍎📺

---

✨ NAME ✨

SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS — a variable that controls whether controllers used with the Apple TV generate UI events 🎮💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_APPLE_TV_CONTROLLER_UI_EVENTS "SDL_APPLE_TV_CONTROLLER_UI_EVENTS"

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — when UI events are generated by controller input, the app will get backgrounded when the Apple TV remote's menu button is pressed, and also when the pause or B buttons on gamepads are pressed. literally just yeeted to the background, no cap 😭

if you want more info about properly making use of controllers for the Apple TV, it's all right here:

https://developer.apple.com/tvos/human-interface-guidelines/remote-and-controllers/

the variable can be set to the following values, bestie:

• "0" — controller input does not generate UI events. (this is the default 👑)
• "1" — controller input does generate UI events. slay ✨

this hint can be set anytime, so you're never locked out fr fr 🫶

---

⭐ AVAILABILITY ⭐

this hint is available since SDL 3.2.0 — so if you're on anything older, it's giving vintage, and not in the cute way 🙈

---

and that's the whole vibe check 💜 made with love by Simple Directmedia Layer, hanging out in SDL 3.4.18. go forth and press buttons, icon queen 👑💅🎀