https://wiki.wowcube.com/index.php?action=history&feed=atom&title=SDK_6.3%2FC%2B%2B%2FSound 2026-07-26T22:46:45Z Revision history for this page on the wiki MediaWiki 1.33.0 https://wiki.wowcube.com/index.php?title=SDK_6.3/C%2B%2B/Sound&diff=16968&oldid=prev 2026-07-26T09:47:46Z

<p>Split C++ Native API into per-module pages with minimal examples (WowBot)</p> <p><b>New page</b></p><div>{{notice|'''Official WOWCube SDK documentation.''' SDK 6.3, C++ (WebAssembly) API. Signatures are extracted from the canonical SDK headers shipped with the WOWCube Development Kit; the headers remain authoritative.}}<br /> <br /> {{SDK 6.3 nav}}<br /> <br /> <br /> ''← [[SDK 6.3]] · [[SDK 6.3/C++/Native API|C++ Native API]] / Sound''<br /> <br /> Sound asset playback and caching.<br /> <br /> Shared types, enums and constants are listed on the [[SDK 6.3/C++/Native API#Types and data structures|Native API overview]].<br /> <br /> == Minimal example ==<br /> <br /> Play a packed sound asset:<br /> <br /> soundID_t sfx = SND_getAssetId(&quot;hit.wav&quot;);<br /> SND_play(sfx, 100);<br /> <br /> == Functions ==<br /> <br /> ===SND_getAssetId===<br /> Syntax:<br /> i32_t SND_getAssetId(const char* soundName)<br /> <br /> Description:<br /> : Get a sound ID by the filename.<br /> <br /> Return values:<br /> : The ID of sound with a given filename or -1 in case of error.<br /> <br /> History:<br /> : v5.0 - renamed from SND_getId() to SND_getAssetId()<br /> : v6.0 - truncate asset name in WASM API<br /> <br /> ===SND_play===<br /> Syntax:<br /> i32_t SND_play(soundID_t soundID, u32_t volume)<br /> <br /> Description:<br /> : Play sound by ID.<br /> : Play any sound by its ID. Platform does not support audio mixing, so<br /> : previously playing sound will be stopped if it has not yet finished.<br /> : Supported audio formats:<br /> :* WAV<br /> :* MP3<br /> :* MIDI<br /> <br /> ===SND_cacheSounds===<br /> Syntax:<br /> i32_t SND_cacheSounds(soundID_t* soundIDs, u32_t count)<br /> <br /> Description:<br /> : Force platform to cache application sounds.<br /> : Platform automatically reads and caches sounds from flash when the<br /> : application plays a sound. Flash operations are synchronous and may cause<br /> : delays especially when reading large portions of data. To prevent the<br /> : application from lags it is possible to cache sound data in advance.<br /> : However if application requests to play a non-cached sound and there is not<br /> : enough memory then oldest accessed sounds will be removed from cache. Also<br /> : there is a limit of 256 for a total number of cached sounds.<br /> <br /> Return values:<br /> : Number of cached sounds or negative value if an error happened. Error<br /> : codes:<br /> : * -1 invalid function arguments count<br /> : * -2 invalid soundList array<br /> <br /> History:<br /> : v5.0 - moved from appCtrl module to sound<br /> <br /> ===SND_isPlaying===<br /> Syntax:<br /> i32_t SND_isPlaying()<br /> <br /> Description:<br /> : Check if audio is playing.<br /> <br /> Return values:<br /> : True if audio is playing, false otherwise.<br /> <br /> History:<br /> : v6.0 - added<br /> <br /> ===SND_stop===<br /> Syntax:<br /> i32_t SND_stop()<br /> <br /> Description:<br /> : Stop playing sound if any.<br /> <br /> History:<br /> : v6.0 - added<br /> <br /> ===SND_getAssetsCount===<br /> Syntax:<br /> i32_t SND_getAssetsCount()<br /> <br /> Description:<br /> : Get the total count of sound assets.<br /> <br /> Return values:<br /> : Number of sound assets.<br /> <br /> History:<br /> : v6.0 - added<br /> <br /> [[Category:SDK 6.3]]<br /> [[Category:C++ API]]</div>

WowBot