mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2026-09-02 03:43:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

aaudio: Make input preset into a hint, don't set it by default.

Browse Source 
Fixes #16130.
Reference Issue #13402.

(cherry picked from commit 22e42e6e1e)
This commit is contained in:
Ryan C. Gordon
2026-09-01 14:03:05 -04:00
parent 4aa40070ef
commit aba2d16233
2 changed files with 34 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
include/SDL3/SDL_hints.h
View File

@@ -117,6 +117,33 @@ extern "C" {
*/
#define SDL_HINT_ANDROID_LOW_LATENCY_AUDIO "SDL_ANDROID_LOW_LATENCY_AUDIO"
/**
* A variable to control Android's AAudio input preset.
*
* This hint only applies to SDL's "aaudio" backend on Android 9+ devices.
*
* Some devices choose the wrong microphone by default (between the one meant
* to be spoken in when the phone is held to the user's ear for a phone call,
* or an external microphone that's meant to be used when recording video),
* or have DSP effects applied to the recorded audio, and changing the input
* preset can help control this.
*
* This can be any number that maps to an `AAUDIO_INPUT_PRESET_*` enum from
* the Android NDK headers. The most reasonable choices are 5 ("camcorder",
* for external microphones) and 7 ("voice communication", for speaking
* directly into the device like a mobile phone). 6 ("voice recognition")
* might also be a useful choice.
*
* If unset (the default), SDL will not specify an input preset at all, which
* lets the system choose. This is usually the correct thing to do unless
* your app is having problems.
*
* This hint should be set before a recording audio device is opened.
*
* \since This hint is available since SDL 3.4.16.
*/
#define SDL_HINT_ANDROID_AAUDIO_INPUT_PRESET "SDL_ANDROID_AAUDIO_INPUT_PRESET"
/**
* A variable to control whether we trap the Android back button to handle it
* manually.