Play Music

Description
1
'play music <music_id> [with [properties]]'
Copied!
The play music action let's you, as it name says, play some background music for your game. You can play as many songs as you want simultaneously.
To stop the music, check out the Stop Music documentation.
Action ID: Music
Reversible: Yes
Requires User Interaction: No
Parameters
Name
Type
Description
music_id
string
The name of the music you want to play. These assets must be declared beforehand.
properties
string
Optional. A list of comma separated properties with their respective value.
Properties
The following is a comprehensive list of the properties available for you to modify certain behaviors of the play music action.
Property Name
Type
Description
fade
string
The fade property let's you add a fade in effect to the music, it accepts a time in seconds, representing how much time you want it to take until the music reaches it's maximum volume.
​
volume
number
The volume property let's you define how high the music will be played. 
loop
none
Make the music loop. This property does not require any value.
Assets Declarations
To play a song, you must first add the file to your assets/music/ directory and then declare it. To do so, Monogatari has an  has a function that will let you declare all kinds of assets for your game.
1
monogatari.assets ('music', {
2
    '<music_id>': 'musicFileName'
3
});
Copied!
Supported Formats
Each browser has it's own format compatibility. MP3 however is the format supported by every browser. 
If you wish to use other formats, you can check a compatibility table to discover what browsers will be able to play it.
Examples
Play Music
The following will play the song, and once the song ends, it will simply stop.
Script
Music Assets
1
monogatari.script ({
2
    'Start': [
3
        'play music mainTheme'
4
        'end'
5
    ]
6
});
Copied!
1
monogatari.assets ('music', {
2
    'mainTheme': 'mainThemeSong.mp3'
3
});
Copied!
Loop Music
The following will play the song, and once the song ends, it will start over on an infinite loop until it is stopped using the Stop Music Action.
Script
Music Assets
1
monogatari.script ({
2
    'Start': [
3
        'play music mainTheme with loop'
4
        'end'
5
    ]
6
});
Copied!
1
monogatari.assets ('music', {
2
    'mainTheme': 'mainThemeSong.mp3'
3
});
Copied!
Fade In effect
The following will play the song, and will use a fade in effect.
Script
Music Assets
1
monogatari.script ({
2
    'Start': [
3
        'play music mainTheme with fade 3'
4
        'end'
5
    ]
6
});
Copied!
1
monogatari.assets ('music', {
2
    'mainTheme': 'mainThemeSong.mp3'
3
});
Copied!
Custom Volume
The following will set the volume of this song to 73%. 
Script
Music Assets
1
monogatari.script ({
2
    'Start': [
3
        'play music mainTheme with volume 73'
4
        'end'
5
    ]
6
});
Copied!
1
monogatari.assets ('music', {
2
    'mainTheme': 'mainThemeSong.mp3'
3
});
Copied!
Please note however, that the user's preferences regarding volumes are always respected, which means that this percentage is taken from the current player preferences, meaning that if the player has set the volume to 50%, the actual volume value for the song will be the result of:
50∗0.73=36.550 * 0.73 = 36.5%
50∗0.73=36.5
All Together
Of course, you can combine all of this properties, and remember the order doesn't really matter, you can write the properties on the order that feels more natural to you.
Script
Music Assets
1
monogatari.script ({
2
    'Start': [
3
        'play music mainTheme with volume 100 loop fade 20'
4
        'end'
5
    ]
6
});
Copied!
1
monogatari.assets ('music', {
2
    'mainTheme': 'mainThemeSong.mp3'
3
}
Copied!

Script Actions - Previous

Placeholder

Next - Script Actions

Play Sound

Last modified 1yr ago

Copy link

Contents