Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 25, 2023
Merged

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

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bb31420
Add hint reg. Safari audio autoplay restriction when exporting for th…
Daniel-The-Fox Nov 18, 2023
8ee61d1
Apply suggestions from code review
Calinou Nov 18, 2023
d537253
Apply suggestions from code review
Calinou Nov 18, 2023
c692d7b
Update tutorials/export/exporting_for_web.rst
mhilbrunner Nov 25, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions tutorials/export/exporting_for_web.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>`.

Expand Down