Add hint reg. Safari audio autoplay restriction when exporting for the web (#8499)

* Add hint reg. Safari audio autoplay restriction when exporting for the web

* Apply suggestions from code review

* Apply suggestions from code review

* Update tutorials/export/exporting_for_web.rst

Co-authored-by: Matthew <matthewehr@hotmail.com>

---------

Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>
Co-authored-by: Max Hilbrunner <mhilbrunner@users.noreply.github.com>
Co-authored-by: Matthew <matthewehr@hotmail.com>
This commit is contained in:
Daniel The Fox
2023-11-25 19:16:53 +01:00
committed by GitHub
parent 0a01baec10
commit a0822839f6

View File

@@ -133,12 +133,15 @@ engine is started from within a valid input event handler. This requires
Audio
~~~~~
Chrome restricts how websites may play audio. It may be necessary for the
player to click or tap or press a key to enable audio.
Some browsers restrict autoplay for audio on websites. The easiest way around this limitation is to request the
player to click, tap or press a key/button to enable audio, for instance when displaying a splash screen at the start of your game.
.. seealso:: Google offers additional information about their `Web Audio autoplay
policies <https://sites.google.com/a/chromium.org/dev/audio-video/autoplay>`__.
Apple's Safari team also posted additional information about their `Auto-Play Policy Changes for macOS
<https://webkit.org/blog/7734/auto-play-policy-changes-for-macos/>`__.
.. warning:: Access to microphone requires a
:ref:`secure context <doc_javascript_secure_contexts>`.