Hi,
This is exactly what you assumed
--qt-auto-raise {0 (Never), 1 (Video), 2 (Audio), 3 (Audio/Video)}
When to raise the interface
This option allows the interface to be raised automatically when a
video/audio playback starts, or never.
The exact behaviour as of future 4.0 (and probably 3.0 too) is called when input change and is:
+ if there is no new input, do nothing
+ if we chose to never raise, do nothing
+ if we have video and we didn't choose to raise when there is video, do nothing
+ if we haven't chosen to raise on new audio input, do nothing
+ in any other case, ask to raise window
If the window is raised, it will call this function in particular: https://doc.qt.io/qt-5/qwidget.html#activateWindow
Then, the exact behaviour depends on the platform and on Windows, the behaviour is what you describe:
On Windows, if you are calling this when the application is not currently the active one then it will not make it the active window. It will change the color of the taskbar entry to indicate that the window has changed in some way. This is because Microsoft does not allow an application to interrupt what the user is currently doing in another application.
The behaviour you're looking for might be implemented through [1] but is a Windows-only code that must be maintain and is not an idiomatic behaviour, so I don't think it's a really good addition to the code base.
https://doc.qt.io/qt-5/qwindowswindowfunctions.html#WindowActivationBehavior-enum