Qt for HarmonyOS/qtohosextras doc/Audio Stream Usage Hint Example: Difference between revisions
Publish example source listings and restore Files lists (QTFOROH-2307) |
Drop manual breadcrumb, MediaWiki renders it automatically (QTFOROH-2307) |
||
| Line 1: | Line 1: | ||
= Audio Stream Usage Hint Example = | = Audio Stream Usage Hint Example = | ||
Latest revision as of 05:20, 17 September 2026
Audio Stream Usage Hint Example
Demonstrates tagging Qt sound playback with an OHOS audio stream usage hint.
A combo box lists all QtOhosExtras::Multimedia::AudioStreamUsageHint values. Two buttons play a bundled sound either through QSoundEffect or through QSound; before playback the selected hint is applied with Multimedia::setAudioStreamUsageHintProperty(). The hint influences how the system routes the audio and which volume policy applies.
For QSoundEffect the hint is set before the source is assigned and playback starts:
auto *soundEffect = new QSoundEffect(this);
QtOhosExtras::Multimedia::setAudioStreamUsageHintProperty(soundEffect, selectedAudioRole());
soundEffect->setSource(QUrl(QString::fromLatin1("qrc:/test.wav")));
soundEffect->setLoopCount(1);
The same function works for QSound:
auto *sound = new QSound(QString::fromLatin1(":/test.wav"), this);
QtOhosExtras::Multimedia::setAudioStreamUsageHintProperty(sound, selectedAudioRole());
Note: The target object must be a QSoundEffect or QSound instance; other object types are rejected with an error log. The example sets the hint before starting playback.
Files: