Use sounds and music in ink

The ink + Pixi’VN integration introduces the a # script that allows you to use the sounds and music.

The syntax is as follows:

# + [operation] + sound + [alias] + [parameters]

Where:

• #: It is a special character used by ink syntax for use a special script.
• [operation]: It is the operation that you want to execute with the sound element. The available operations are:
  • play: Play a sound. (Read more here)
  • pause: Pause a sound. (Read more here)
  • resume: Resume a sound. (Read more here)
  • stop: Stop a sound. (Read more here)
  • volume: Change the volume of a sound. (Read more here)
• [alias] It is the alias of the sound. The alias is a string that identifies the sound.
  • If the alias includes spaces, you must use double quotes.
• [parameters] It is the parameters of the operation. The parameters depend on the operation.
  • If the parameters include spaces, you must use double quotes.
  • If the parameters is a object, you must use the JSON format and the first character must be \{ and the last character must be \}. Example: \{ "volume": 100, name: "Music" \}

Play a sound in ink

You can use the play to play a sound in ink.

The syntax is as follows:

# + play + sound + [alias] + [parameters]

• [parameters] (Optional): In the parameters you must include the properties of SoundPlayOptions that you want to set. The parameters must be set as follows: parameterName + SPACE + value. If the value is a string and includes spaces, you must use double quotes.

# play sound bird
Now the bird is singing.
# play sound bird volume 100
Now the bird is singing louder.

Pause a sound in ink

To pause a sound in ink, you can use the pause operation.

The syntax is as follows:

# + pause + sound + [alias]

# pause sound bird

Resume a sound in ink

To resume a sound in ink, you can use the resume operation.

The syntax is as follows:

# + resume + sound + [alias]

# resume sound bird

Stop a sound in ink

To remove a sound in ink, you can use the stop operation.

The syntax is as follows:

# + stop + sound + [alias]

# stop sound bird

Change the volume of a sound in ink

To change the volume of a sound in ink, you can use the volume operation.

The syntax is as follows:

# + volume + sound + [alias] + [number]

• [number]: It is a number from 0 to 100 that corresponds to the volume you want to set.

# volume sound bird 100