pxt-calliope/docs/reference/music/ring-tone.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR (#529)
* Accessibility changes
2017-09-07 13:42:08 -07:00

1.2 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.

Simulator

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

music.ringTone(440)

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