Overview

neoAudio adds a native Windows audio player to VisualNEO Win. Playback uses Media Foundation and the control is drawn with antialiased modern transport controls. It supports local audio files, compatible media URLs, seeking, volume, looping, themes, and playback events.

The compact player contains artwork, play/pause, elapsed and total time, a seek bar, and volume control. Its colors can follow VisualNEO styles through the host fill, line, and accent colors, while plugin properties provide additional control.

Properties

Property	Type	Default	Description
`src`	string	`""`	Audio file path or compatible media URL.
`autoPlay`	boolean	`false`	Starts playback when the source is applied.
`loop`	boolean	`false`	Restarts playback after the natural end.
`volume`	integer	`80`	Initial volume from `0` to `100`.
`theme`	string	`"system"`	`system`, `dark`, `light`, `neon`, or `minimal`.
`accentColor`	string	`"#0078D4"`	Accent color used for progress, time values, transport controls, and the speaker icon.
`bgColor`	string	`"auto"`	Background color as `#HEX`, or `auto` to use the host style.

Actions

`neoAudioPlay`

Starts or resumes playback. Supplying a different source closes the previous media before opening the new one.

TEXT

neoAudioPlay "AudioPlayer1" "[PubDir]media/music.mp3"
neoAudioPlay "AudioPlayer1" ""

Parameters: object name and an optional audio file path or media URL.

`neoAudioPause`

TEXT

neoAudioPause "AudioPlayer1"

Pauses the target player without resetting its position.

`neoAudioStop`

TEXT

neoAudioStop "AudioPlayer1"

Stops playback and resets the position to zero. A manual stop does not emit ended.

`neoAudioSeek`

TEXT

neoAudioSeek "AudioPlayer1" "60"

Moves playback to the specified position in seconds.

`neoAudioSetVolume`

TEXT

neoAudioSetVolume "AudioPlayer1" "75"

Sets the volume from 0 to 100.

`neoAudioGetInfo`

TEXT

neoAudioGetInfo "AudioPlayer1"

Stores a JSON string in [neoAudioResult] and [ModernPluginResult]:

JSON

{"position":45,"duration":180,"volume":75,"playing":true}

Positions and durations are expressed in seconds.

`neoAudioPlaySound`

TEXT

neoAudioPlaySound "[PubDir]effects/click.wav"

Plays a WAV sound effect asynchronously without a neoAudio control. This utility action accepts WAV files only.

Events

Event	Description
`play`	Playback starts or resumes.
`pause`	Playback is paused.
`ended`	The track reaches its natural end.
`timeupdate`	The playback position changes, including periodic updates while playing.

Event data can include position, duration, playing, and volume.

Notes

Actual format and URL support depends on the Media Foundation codecs available in Windows.
Use system theme for the closest integration with VisualNEO styles.
The recommended control size is 480 x 88 pixels; the layout adapts to narrower widths.