Sound player — version history

n_pbt_soundplayer · Introduced in 4.0

A non-visual object that plays a local file, an https URL or a synthesized beep, asynchronously (events) or synchronously (the call returns when the sound ends). Introduced in 4.0.

4.0 — October 2026 #

New #

• First release. of_play returns at once and events tell the rest (ue_started, ue_ended, ue_failed, ue_stopped, ue_paused / ue_resumed, ue_progress once a second), delivered on their own with no timer or receiver to wire; of_play_sync plays and waits for the end, cut beyond il_timeout_ms.
• Every format the WebView2 engine decodes — mp3, wav, ogg, opus, flac, aac, m4a, mp4, webm; local files are streamed by the DLL, so a long track starts at once and of_seek is immediate.
• Control: of_pause, of_resume, of_seek, of_stop, of_duration, of_position, of_is_playing, of_is_paused; ii_volume, ii_rate (25–400 %), ii_pan (balance, local files), ib_loop.
• Several sounds: of_play_over plays over the main sound without cutting it, a queue that never cuts (of_enqueue, of_clear_queue, of_queue_count, ue_queue_done), fades (il_fade_ms, of_fade_to) and cross-fade between tracks (of_crossfade).
• Sounds without any file: of_beep / of_beep_sync at a given frequency and length, and five named synthesized sounds (of_play_named(SOUND_SUCCESS), SOUND_ERROR, SOUND_WARNING, SOUND_INFO, SOUND_NOTIFY).
• A 5-band equalizer (of_equalizer, of_equalizer_band, of_eq_frequencies) and a level meter / spectrum analyser to draw your own visualizer (of_meter, of_level, of_spectrum), for local files.
• of_preload to start a sound instantly, of_has_output to know whether the workstation has an audio output before an alert.
• ue_failed says why a sound did not play through a REASON_* constant; an http:// address is refused (REASON_INSECURE) — download it first with n_pbt_restclient.of_download.