pxt-calliope/docs/reference/music/set-play-tone.md

39 lines
1.0 KiB
Markdown
Raw Permalink Normal View History

# Set Play Tone
Replaces the implementation of the [music play tone](/reference/music/play-tone).
```sig
music.setPlayTone((frequency: number, duration: number) => {})
```
## Parameters
* ``f`` the replacement function
## Example
This example send the frequency and duration over radio
and plays it on the remote @boardname@.
```typescript
input.onButtonEvent(Button.A, input.buttonEventClick(), () => {
music.playTone(440, 120)
led.toggle(0, 0)
})
radio.onReceivedNumber(function (receivedNumber) {
const freq = receivedNumber >> 16;
const duration = receivedNumber & 0xffff;
music.playTone(freq, duration);
})
input.onButtonEvent(Button.B, input.buttonEventClick(), () => {
music.setPlayTone((frequency: number, duration: number) => {
radio.sendNumber((frequency << 16) | (duration & 0xffff));
})
})
```
## See also
[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)