Repository navigation
Звук
Dmitry Starov edited this page Feb 19, 2021
·
2 revisions
Модуль trackduino.executor.sound предоставляет API для обращения к пьезоизлучателю и динамику — электроакустическим устройствам, способным воспроизводить звук.Существуют различия между пьезоизлучателем и динамиком:
- Пьезоизлучатель воспроизводит звук благодаря обратному возникновению механических деформаций под действием электрического поля.
- Динамик воспроизводит звук благодаря перемещению катушки с током в магнитном поле постоянного магнита с последующим преобразованием полученных механических колебаний в колебания окружающего воздуха при помощи диффузора.
Пьезоизлучатель и динамик подключаются к плате Trackduino Pro по стандартному 3-пиновому разъему в один из портов OUT с поддержкой ШИМ.
class trackduino.executor.sound.Sound(pin[, freq, volume])-
pin: Идентификатор OUT-порта, к которому подключен пьезоизлучатель или динамик, с поддержкой ШИМ. Используйте один изPin.Out.PWM; -
freq: Начальная частота воспроизводимого звука (в герцах [0-18_000]). По умолчанию, равна 450. -
volume: Начальная громкость (в процентах [0-100]). По умолчанию, равен 100.
-
ValueError, если указанный порт не поддерживает ШИМ.
Включает воспроизведение звука.
Выключает воспроизведение звука.
Воспроизводит звук указанное количество миллисекунд на указанной частоте с указанной громкостью.
-
time_ms: Количество миллисекунд, во время которых происходит воспроизведение звука; -
freq: Частота воспроизводимого звука. По умолчанию, равна ранее заданной частоте. Если передана, не меняет ранее установленную частоту; -
volume: Громкость воспроизводимого звука (в процентах [0-100]). По умолчанию, равна ранее заданной громкости. Если передана, не меняет ранее установленную громкость.
Аксессор для получения и установления значения частоты (в герцах).
>>> sound.freq
450
>>> sound.freq = 1600
>>> sound.freq == 450
False
>>> sound.freq
1600Аксессор для получения и установления значения громкости (в процентах [0-100]).
>>> sound.volume
100
>>> sound.volume = 10
>>> sound.volume
10