Skip to content

Звук

Dmitry Starov edited this page Feb 19, 2021 · 2 revisions

Модуль trackduino.executor.sound

Модуль trackduino.executor.sound предоставляет API для обращения к пьезоизлучателю и динамику — электроакустическим устройствам, способным воспроизводить звук.Существуют различия между пьезоизлучателем и динамиком:

  • Пьезоизлучатель воспроизводит звук благодаря обратному возникновению механических деформаций под действием электрического поля.
  • Динамик воспроизводит звук благодаря перемещению катушки с током в магнитном поле постоянного магнита с последующим преобразованием полученных механических колебаний в колебания окружающего воздуха при помощи диффузора.

Пьезоизлучатель и динамик подключаются к плате Trackduino Pro по стандартному 3-пиновому разъему в один из портов OUT с поддержкой ШИМ.

Класс Sound

Конструктор

class trackduino.executor.sound.Sound(pin[, freq, volume])

Параметры

  • pin : Идентификатор OUT-порта, к которому подключен пьезоизлучатель или динамик, с поддержкой ШИМ. Используйте один из Pin.Out.PWM;
  • freq : Начальная частота воспроизводимого звука (в герцах [0-18_000]). По умолчанию, равна 450.
  • volume : Начальная громкость (в процентах [0-100]). По умолчанию, равен 100.

Исключения

  • ValueError, если указанный порт не поддерживает ШИМ.

Методы

Sound.on()

Включает воспроизведение звука.

Sound.off()

Выключает воспроизведение звука.

Sound.tone(time_ms[, freq, volume])

Воспроизводит звук указанное количество миллисекунд на указанной частоте с указанной громкостью.

Параметры

  • time_ms : Количество миллисекунд, во время которых происходит воспроизведение звука;
  • freq : Частота воспроизводимого звука. По умолчанию, равна ранее заданной частоте. Если передана, не меняет ранее установленную частоту;
  • volume : Громкость воспроизводимого звука (в процентах [0-100]). По умолчанию, равна ранее заданной громкости. Если передана, не меняет ранее установленную громкость.

Свойства

Sound.freq

Аксессор для получения и установления значения частоты (в герцах).

Использование

>>> sound.freq
450
>>> sound.freq = 1600
>>> sound.freq == 450
False
>>> sound.freq
1600

Sound.volume

Аксессор для получения и установления значения громкости (в процентах [0-100]).

Использование

>>> sound.volume
100
>>> sound.volume = 10
>>> sound.volume
10

Clone this wiki locally