https://g1r-mp.com/wiki/index.php?action=history&feed=atom&title=SetGameSoundPausedSetGameSoundPaused - Revision history2026-10-01T15:28:20ZRevision history for this page on the wikiMediaWiki 1.46.0https://g1r-mp.com/wiki/index.php?title=SetGameSoundPaused&diff=1187&oldid=prevQCherry: Document upcoming 0.1.7 game audio: 11 client APIs, result event, limits and complete dialogue catalog; not a release2026-10-01T10:20:52Z<p>Document upcoming 0.1.7 game audio: 11 client APIs, result event, limits and complete dialogue catalog; not a release</p>
<p><b>New page</b></p><div>= setGameSoundPaused =<br />
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"><br />
<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">PLANNED FOR UPDATE 0.1.7</div><br />
<div style="color:#111111; margin-top:0.25rem;">This function is planned for G1R:MP 0.1.7. It is not included in the public 0.1.6 release.</div><br />
</div><br />
<br />
Requests that a game sound owned by the current client resource pause or resume.<br />
<br />
== Syntax ==<br />
<syntaxhighlight lang="lua"><br />
number|false setGameSoundPaused(number handle, bool paused)<br />
</syntaxhighlight><br />
<br />
== Parameters ==<br />
{| class="wikitable"<br />
! Name !! Type !! Required !! Description<br />
|-<br />
| <code>handle</code> || <code>number</code> || yes || Positive integer handle returned by [[playSoundFromGame]] or [[playSound3DFromGame]], owned by the current resource. Valid IDs do not exceed 9007199254740991.<br />
|-<br />
| <code>paused</code> || <code>bool</code> || yes || true pauses playback; false resumes it.<br />
|}<br />
<br />
== Returns ==<br />
Returns a positive integer request ID when the command is accepted for asynchronous processing, or <code>false</code> when rejected locally. The request ID identifies this command; it is not a new sound handle. Observe [[onClientGameSoundResult]] for the result.<br />
<br />
== Examples ==<br />
Pause a campfire sound after one second, resume after two seconds, and stop after four seconds:<br />
<syntaxhighlight lang="lua" line><br />
local sound = playSoundFromGame("event:/SFX/Objects/Fire/SFX_OBJ_Fire_Campfire_BurnLoop", {volume = 0.3})<br />
if sound then<br />
setTimer(function() setGameSoundPaused(sound, true) end, 1000, 1)<br />
setTimer(function() setGameSoundPaused(sound, false) end, 2000, 1)<br />
setTimer(function() stopGameSound(sound) end, 4000, 1)<br />
end<br />
</syntaxhighlight><br />
<br />
== Notes ==<br />
* Planned for update 0.1.7; not included in public 0.1.6.<br />
* Available only in client-side resource scripts. See [[Game audio]] for ownership, lifecycle, limits and server-triggered playback.<br />
* Controls require a nonterminal handle owned by the current resource. Unknown, expired, foreign-resource or terminal handles are rejected.<br />
* A return value of <code>false</code> has no result event for that attempted command. Rejection can also mean the game is not ready or a request limit has been reached.<br />
* Control acceptance does not change the cached playback state immediately. Native acknowledgements and observed state changes arrive asynchronously.<br />
* A successful command acknowledgement is followed by state observation. Use [[getGameSoundState]] or [[onClientGameSoundResult]] to observe <code>paused</code> or <code>playing</code>.<br />
* Pausing preserves the handle and still counts toward the active sound limit. Resuming cannot restart a terminal sound.<br />
<br />
[[Category:Lua Functions]]<br />
[[Category:Client Functions]]<br />
[[Category:Audio Functions]]</div>QCherry