Module ev3dev_lang_rust::sound

Sound-related functions. It can beep, play wav files, or convert text to speech.

Note that all methods of the meodule spawn system processes and return std::process::Child objects. The methods are asynchronous (they return immediately after child process was spawned, without waiting for its completion), but you can call wait() on the returned result.

Examples

use ev3dev_lang_rust::sound;

// Play "bark.wav", return immediately:
sound::play("bark.wav")?;

// Introduce yourself, wait for completion:
sound::speak("Hello, I am Robot")?.wait()?;

Functions

beep	Call beep command.
beep_args	Call beep command with the provided arguments.
get_volume	Gets the current sound volume by parsing the output of amixer get <channel>. It tries to determine the default channel by running amixer scontrols. If that fails as well, it uses the Playback channel, as that is the only channel on the EV3.
get_volume_channel	Gets the current sound volume by parsing the output of amixer get <channel>.
play	Play wav file
set_volume	Sets the sound volume to the given percentage [0-100] by calling amixer -q set <channel> <pct>%. It tries to determine the default channel by running amixer scontrols. If that fails as well, it uses the Playback channel, as that is the only channel on the EV3.
set_volume_channel	Sets the sound volume to the given percentage [0-100] by calling amixer -q set <channel> <pct>%.
speak	Speak the given text aloud.
tone	Play tone sequence. The tone_sequence parameter is a list of tuples, where each tuple contains up to three numbers. The first number is frequency in Hz, the second is duration in milliseconds, and the third is delay in milliseconds between this and the next tone in the sequence.
tone_sequence	Play tone sequence. The tone_sequence parameter is a list of tuples, where each tuple contains up to three numbers. The first number is frequency in Hz, the second is duration in milliseconds, and the third is delay in milliseconds between this and the next tone in the sequence.