Overview

As a development framework designed specifically for the Internet of Things, QuecPython provides complete audio processing capabilities for embedded devices through highly encapsulated Python interfaces. This article mainly describes how to quickly implement audio function development with QuecPython.

Core Advantages

• Minimalist Development: Complete basic audio recording and playback with just 3 lines of code.

• Quick Start: Get started rapidly without professional audio knowledge.

• Complete Documentation: Supported by full technical documentation and sample code.

Main Functions

TTS - Text to Speech Playback

Create TTS Object

class audio.TTS(device)

For parameter details, please refer to audio.TTS.

Speech Playback

This method is used to start speech playback.

TTS.play(priority, breakin, mode, str)

For API details, please refer to TTS.play.

Volume Setting

This method is used to set the playback volume. The volume value must be in the range [0 ~ 9], where 0 means mute.

TTS.setVolume(vol)

For API details, please refer to TTS.setVolume.

Playback Speed Setting

This method is used to set the TTS playback speed. The speed value must be in the range [0 ~ 9].

TTS.setSpeed(speed)

For API details, please refer to TTS.setSpeed.

Sample Code

import audio tts = audio.TTS(1) # Case: Task A is playing and allows interruption. When Task B with a higher priority arrives, Task A will be interrupted and Task B will be played directly tts.play(1, 1, 2, '111') # Task A tts.play(2, 0, 2, '222') # Task B

Audio - Audio Playback

Create Audio Object

class audio.Audio(device)

For parameter details, please refer to audio.Audio.

Set PA Pin

This method is used to configure the GPIO of the output PA. Refer to the schematic of the corresponding development board to set the PA pin, so that the SPK interface of the development board can output sound.

Audio.set_pa(gpio,num)

For API details, please refer to Audio.set_pa.

Audio Playback

This method is used to play audio files, supporting playback of files in mp3, amr and wav formats.

Audio.play(priority, breakin, filename)

For API details, please refer to Audio.play.

Volume Setting

This method is used to set the playback volume. The volume value must be in the range [0 ~ 11], where 0 means mute.

Audio.setVolume(vol)

For API details, please refer to Audio.setVolume.

Audio Stream Playback

This method is used for audio stream playback, supporting playback of audio streams in mp3, amr and wav formats.

Audio.playStream(format, buf)

For API details, please refer to Audio.playStream.

Sample Code

import audio from machine import Pin aud = audio.Audio(0) # Set PA pin aud.set_pa(Pin.GPIO15,2) # Play MP3 file aud.play(2, 1, 'U:/music.mp3')

Record - Audio Recording

Create Record Object

class audio.Record(device)

For parameter details, please refer to audio.Record.

Start Recording

This method is used to start audio recording.

Record.start(file_name,seconds)

For API details, please refer to Record.start.

Audio Stream Recording

This method is used to start audio stream recording.

Note: While recording the audio stream, you must read the audio stream in a timely manner. A circular buffer is currently used, and failure to read in time will result in data loss.

Record.stream_start(format, samplerate, time)

For API details, please refer to Record.stream_start.

Sample Code

import audio record = audio.Record() record.start('recordfile.wav', 10)