MaixCAM MaixPy Continuous Chinese digit recognition
Update history
| Date | Version | Author | Update content |
|---|---|---|---|
| 2024-10-08 | 1.0.0 | 916BGAI | Initial document |
Introduction
MaixCAM has ported the Maix-Speech offline speech library, enabling continuous Chinese numeral recognition, keyword recognition, and large vocabulary speech recognition capabilities. It supports audio recognition in PCM and WAV formats, and can accept input recognition via the onboard microphone.
Maix-Speech
Maix-Speech is an offline speech recognition library specifically designed for embedded environments. It has been deeply optimized for speech recognition algorithms, significantly reducing memory usage while maintaining excellent recognition accuracy. For detailed information, please refer to the Maix-Speech Documentation.
Continuous Chinese digit recognition
from maix import app, nn
speech = nn.Speech("/root/models/am_3332_192_int8.mud")
speech.init(nn.SpeechDevice.DEVICE_MIC)
def callback(data: str, len: int):
print(data)
speech.digit(640, callback)
while not app.need_exit():
frames = speech.run(1)
if frames < 1:
print("run out\n")
break
Usage
- Import the
appandnnmodules
from maix import app, nn
- Load the acoustic model
speech = nn.Speech("/root/models/am_3332_192_int8.mud")
- You can also load the
am_7332acoustic model; larger models provide higher accuracy but consume more resources.
- Choose the corresponding audio device
speech.init(nn.SpeechDevice.DEVICE_MIC)
speech.init(nn.SpeechDevice.DEVICE_MIC, "hw:0,0") # Specify the audio input device
- This uses the onboard microphone and supports both
WAVandPCMaudio as input.
speech.init(nn.SpeechDevice.DEVICE_WAV, "path/audio.wav") # Using WAV audio input
speech.init(nn.SpeechDevice.DEVICE_PCM, "path/audio.pcm") # Using PCM audio input
- Note that
WAVmust be16KHzsample rate withS16_LEstorage format. You can use thearecordtool for conversion.
arecord -d 5 -r 16000 -c 1 -f S16_LE audio.wav
- When recognizing
PCM/WAV, if you want to reset the data source, such as for the next WAV file recognition, you can use thespeech.devicemethod, which will automatically clear the cache:
speech.device(nn.SpeechDevice.DEVICE_WAV, "path/next.wav")
- Set up the decoder
def callback(data: str, len: int):
print(data)
speech.digit(640, callback)
The user can configure multiple decoders simultaneously.
digitdecoder is registered to output the Chinese digit recognition results from the last 4 seconds. The returned recognition results are in string format and support0123456789 .(dot) S(ten) B(hundred) Q(thousand) W(thousand).When setting the
digitdecoder, you need to specify ablankvalue; exceeding this value (in ms) will insert a_in the output results to indicate idle silence.If a decoder is no longer needed, you can deinitialize it by calling the
speech.dec_deinitmethod.
speech.dec_deinit(nn.SpeechDecoder.DECODER_DIG)
- Recognition
while not app.need_exit():
frames = speech.run(1)
if frames < 1:
print("run out\n")
break
Use the
speech.runmethod to run speech recognition. The parameter specifies the number of frames to run each time, returning the actual number of frames processed. Users can choose to run 1 frame each time and then perform other processing, or run continuously in a single thread, stopping it with an external thread.To clear the cache of recognized results, you can use the
speech.clearmethod.When switching decoders during recognition, the first frame after the switch may produce incorrect results. You can use
speech.skip_frames(1)to skip the first frame and ensure the accuracy of subsequent results.
Recognition Results
If the above program runs successfully, speaking into the onboard microphone will yield continuous Chinese digit recognition results, such as:
_0123456789