This item was deprecated in version 2019r2. Please use Sound.Open as a replacement.


Opens the FolderItem to be read and returns its contents as a sound object.


On macOS OpenAsSound recognizes sound formats that Core Audio can play.

On Windows WAVs, WMAs, MP3s, and MIDI files can be played, but only WAVs play with DirectSound (this allows individual pan and volume settings for each sound. You can also play multiple sounds simultaneously).

On Linux GStreamer, xine, or libsndfile is used (in that order if available). Nil is returned if the sound can't be read or isn't a sound file at all.

Sample code

This example loads a sound file called “hello.mp3” from the current directory (folder) into a Sound object and plays it.

Dim f As FolderItem
f = GetFolderItem("hello.mp3")

If f <> Nil And f.Exists Then
  Dim s As Sound
  s = f.OpenAsSound
End If


All project types on all supported operating systems.