f5eebf2931
Based on customer feedback, it may be useful to have an example of the array, this may then lead them to coding their own arrays.
34 lines
916 B
Markdown
34 lines
916 B
Markdown
# Begin Melody
|
|
|
|
Begin playing a musical melody through pin ``P0`` of the @boardname@.
|
|
|
|
## Simulator
|
|
|
|
This function only works on the @boardname@ and in some browsers.
|
|
|
|
```sig
|
|
music.beginMelody(music.builtInMelody(Melodies.Entertainer), MelodyOptions.Once)
|
|
```
|
|
or in the format ``NOTE[octave][:duration] eg: ['g5:1']``
|
|
```sig
|
|
music.beginMelody(['g4:1', 'c5', 'e', 'g:2', 'e:1', 'g:3'], MelodyOptions.Once)
|
|
```
|
|
|
|
## Parameters
|
|
|
|
* ``melody`` is the array representation of a melody you wish to play
|
|
|
|
## Example
|
|
|
|
This example plays the ``Entertainer`` built-in melody.
|
|
|
|
```blocks
|
|
music.beginMelody(music.builtInMelody(Melodies.Entertainer), MelodyOptions.Once)
|
|
```
|
|
|
|
## See also
|
|
|
|
[play tone](/reference/music/play-tone), [rest](/reference/music/rest), [ring tone](/reference/music/ring-tone) , [tempo](/reference/music/tempo), [set tempo](/reference/music/set-tempo),
|
|
[change tempo by](/reference/music/change-tempo-by)
|
|
|