Add support for checking if audio is played in a page.

Add support for checking if audio is played in a page, as well
as the ability to (un)mute the audio.

Modify demobrowser example to show (muted) in the tab title, if
the tab is muted, or (audible) if there is audio playing in the tab.
Fix HTML5 audio/video (un)mute to also work.

Change-Id: I7213645e67be2f9da1c5f96cdf6c7eef5341ae4b
Task-number: QTBUG-48788
Reviewed-by: Allan Sandfeld Jensen <allan.jensen@theqtcompany.com>

1 files changed, 34 insertions, 0 deletions

diff --git a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
index d3c540016..e09561bef 100644
--- a/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
+++ b/src/webenginewidgets/doc/src/qwebenginepage_lgpl.qdoc
@@ -690,3 +690,37 @@
 
     \sa iconUrl()
 */
+
+/*!
+    \property QWebEnginePage::audioMuted
+    \brief the state of whether the current page audio is muted.
+    \since 5.7
+*/
+
+/*!
+    \fn void QWebEnginePage::audioMutedChanged(bool muted)
+    \since 5.7
+
+    This signal is emitted when the page's audio is (un)muted using setAudioMuted method.
+    \note Not to be confused with a specific HTML5 audio / video element being muted.
+*/
+
+/*!
+    \fn bool QWebEnginePage::wasRecentlyAudible()
+    \since 5.7
+    \sa wasRecentlyAudibleChanged()
+
+    Returns the current page's audible state (audio was recently played, or not).
+*/
+
+/*!
+    \fn void QWebEnginePage::wasRecentlyAudibleChanged(bool wasRecentlyAudible);
+    \since 5.7
+
+    This signal is emitted when the page's audible state is changed, due to audio
+    being played or stopped.
+
+    \note The signal is also emitted when calling the setAudioMuted method.
+    Also if the audio is paused, this signal is emitted with an approximate \b{2 second
+    delay}, from the moment the audio is paused.
+*/