SDL_RequestAndroidPermission(3)

💖 SDL_RequestAndroidPermission(3) 💖

okay bestie, you're in the SDL3 FUNCTIONS section of the SDL3 manual, and today's main character is SDL_RequestAndroidPermission — the one that asks Android for permissions at runtime, asynchronously. no cap. 🫶

---

✨ NAME ✨

SDL_RequestAndroidPermission — Request permissions at runtime, asynchronously. 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_system.h>

bool SDL_RequestAndroidPermission(const char *permission, SDL_RequestAndroidPermissionCallback cb, void *userdata);

---

🦋 DESCRIPTION 🦋

okay so first things first, bestie: you do not need to call this for built-in functionality of SDL. like, recording from a microphone or reading images from a camera using standard SDL APIs? that already manages permission requests for you. SDL is the responsible older sibling here. 💅

This function never blocks. literally never. instead, the app-supplied callback gets called when a decision has been made. and lowkey, that callback may happen on a different thread, and possibly much later, because it might be waiting on a user to respond to a system dialog. like, the user is out here living their life, staring at a popup, deciding your fate. 😭

If permission has already been granted for a specific entitlement, the callback will still fire — probably on the current thread and before this function returns. so don't go assuming silence means nothing happened. 🙈

If the request submission fails, this function returns -1 and the callback will NOT be called. but ngl, that should only happen in catastrophic conditions, like memory running out. normally there will be a yes or no to the request through the callback. so most of the time it's giving... a decision. either way. 🍓

For the permission parameter, choose a value from here:

https://developer.android.com/reference/android/Manifest.permission

that's the vibe check for what string to actually pass in. 👑

---

🎀 FUNCTION PARAMETERS 🎀

• permission — the permission to request. 🌈
• cb — the callback to trigger when the request has a response. ✨
• userdata — an app-controlled pointer that is passed to the callback. 🫶

---

🔥 RETURN VALUE 🔥

Returns true if the request was submitted, false if there was an error submitting. The result of the request is only ever reported through the callback, not this return value. so do not — I repeat, do NOT — read this as the answer to your permission question. it's just "did we manage to send the ask". periodt. 💀

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. main character energy from any thread. slay. 💜

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older, no permission asking for you, bestie. 😭

---

okay that's the whole page, you ate it, go request some permissions responsibly. this was the SDL_RequestAndroidPermission(3) page from Simple Directmedia Layer, version SDL 3.4.18 — huge thanks to the SDL besties for keeping the docs iconic. bye babe! 💖✨🎀🦋