New extension: Pause specific audio channels when game is out of focus

[github-actions]

Description

This extension gives you the ability to pause specific sound channels when the game is out of focus, either because you switch windows, open another tab in the browser, or for any other reason.

When focus is regained, the specified sound channel(s) will resume playback.

How to use the extension

Simply add a "Pause a sound channel if game isn't focused" action on an event sheet, and then specify which sound channel to pause.

Checklist

• I've followed all of the best practices.
• I confirm that this extension can be integrated to this GitHub repository, distributed and MIT licensed.
• I am aware that the extension may be updated by anyone, and do not need my explicit consent to do so.

What tier of review do you aim for your extension?

Community (Unreviewed)

Example file

PauseASoundChannelExample.zip

Extension file

PauseSoundNotFocus.zip

[D8H]

Thank you for submitting an extension.

Why did you use Javascript?
It seems that the following events do something similar.

[luthfialdi99]

Hi, @D8H

In exported HTML5 build, the built-in "The window is focused" conditions in GDevelop 5 currently doesn't properly detect the browser's current tab or something. I'm assuming that particular condition only works on Windows, Linux, etc. But unfortunately not on Internet browsers. Hence why I'm using JavaScript.

I'm developing a HTML5 game which I plan to publish on gd.games and one of the game's musical minigames requires hitting precise notes according to a specified offset of a song. So, I had to write it in simple JavaScript. Without this extension, the musical minigame became unplayable because when I switched to another tab, the game just pauses/stops (doesn't render?) but not the sound. As a result, upon returning to the game's tab, the game was very much late to the party and the song is already over.

I thought since currently there isn't any function within GDevelop that can pause a sound channel when a player is on a different focus on a web browser, I decided to share one.

Edit: wording