Working with sound assets
Using sound assets, instead of loading sounds from a web URL or a file system path, is another possibility for playing audio. In some cases sound assets will be embedded in the generated binary, and in others, they will be included as separate files. However, the API for working with either option is the same, allowing you to write code once and target many platforms.
Specifying sound assets
In a
Lime project.xml file,
include sound files using the
<assets> element.
Sound assets may be of one of the following types:
- music
- sound
Some targets can only support playing one music file at a time. You should use "music" for files which are designed to play as background music, and "sound" for all other audio.
<assets path="assets">
<sound path="sound/MySound.wav" id="MySound" />
<music path="sound/BackgroundMusic.ogg" />
</assets>
Using sound assets
The following code works with a sound asset with the id "MySound". The code gets
an instance of the sound asset and calls the play() method on that instance:
import openfl.utils.Assets;
import openfl.display.Sprite;
import openfl.media.Sound;
class SoundAssetExample extends Sprite
{
public function new()
{
super();
var smallSound:Sound = Assets.getSound("MySound");
smallSound.play();
}
}