pxt-calliope/docs/reference/music/ring-tone.md
Galen Nickel dda488c08f
Update some music ref docs (#1693)
* Update some music ref docs

* bad link

* Actually add the note, hello
2018-12-02 16:46:05 -08:00

1.3 KiB

Ring Tone

Play a musical tone through pin P0 with the pitch as high or low as you say. The tone will keep playing until you tell it not to.

music.ringTone(440)

~ hint

Simulator: This function only works on the @boardname@ and in some browsers.

~

Parameters

  • frequency is a number that says how high-pitched or low-pitched the tone is. This number is in Hz (Hertz), which is a measurement of frequency or pitch.

Example

This program checks the accelerometer for the @boardname@'s acceleration (how much the @boardname@ is speeding up or slowing down). Then it uses that acceleration to make a tone. If the @boardname@ speeds up, the tone's pitch gets higher, and if it slows down, the tone's pitch gets lower. It's fun -- try it!

basic.forever(() => {
    music.ringTone(input.acceleration(Dimension.X))
})

Using other pins

Use analogSetPitchPin to change that pin used to generate music.

pins.analogSetPitchPin(AnalogPin.P1);

See also

rest, play tone, tempo, set tempo, change tempo by