pxt-calliope/docs/reference/music/set-play-tone.md
Juri Wolf a93febb5b7
Map and clean deprecated functions (#175)
* add image and deprecated arrow functions

* update locales

* map basic.showArrow

* map arrow blocks

* map & remove arrow images

* remove arrow blocks

* update locales

* remove & patch:
rgbw -> rgb
button/pin pressed -> button/pin event
loudness -> soundLevel

* update ts mappings for arrows

* add wip ts patch rules

* update .blocks files

* use Click instead of Down as default in Documentation and tests

* patch test.blocks

* fix lowercase name tag

* update test.blocks

* update blocks test files

* update blocks test files

* format block files

* pass blocks file tests

* fix ts mapping

* fix color.defl value

closes https://github.com/microsoft/pxt-calliope/issues/136

* fix ts mappings

- add optional spacing at the end of rgbw()
- map up to v4.0.19

* add suggested changes

* replace innerText by textContent

Co-authored-by: JW <gitkraken@juriwolf.de>
Co-authored-by: Juri <info@juriwolf.de>
2022-04-26 10:28:42 -07:00

39 lines
1.0 KiB
Markdown

# 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, ButtonEvent.Click, () => {
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, ButtonEvent.Click, () => {
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)