pxt-calliope/docs/reference/music/ring-tone.md

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