Q群:
电话:
邮箱:
地址:
device.Voice 类是device模块下面的一个硬件类,用于对语音模块的配置和控制,并提供对语音模块设备的操作方法。
构造函数 | class device.Voice(volume=8) |
---|---|
功能 | 构造一个Voice对象 |
参数说明 | volume:设置播放音量,值范围为0~15,音量依次增大 |
返回值 | 返回创建的Voice对象 |
其他说明 | 构造时会对Voice进行初始化,也可在init方法中进行初始化,该初始化应针对不同的硬件有不同的驱动进行对应设备的初始化动作。 |
device.Voice类包括如下实例方法
方法名 | 说明 |
---|---|
Voice.init() | 初始化Voice对象 |
Voice.deinit() | 关闭Voice对象 |
Voice.volume() | 获取/设置音量 |
Voice.writeaudio() | 向芯片写入音频数据(WTN6040不支持) |
Voice.playstart() | 开始播放指定地址语音 |
Voice.playpause() | 播放暂停(WTN6040不支持) |
Voice.playstop() | 停止播放 |
Voice.playloop() | 循环播放指定地址语音 |
Voice.playsequence() | 按顺序播放指定语音 |
Voice.getstate() | 查询当前语音播放状态(播放/未播放) |
Voice.modelname() | 获取模块厂家及型号 |
详细说明如下:
方法名称 | Voice.init(volume=8) |
---|---|
功能 | 初始化语音模块 |
参数说明 | volume:设置播放音量,值范围为0~15,音量依次增大 |
返回值 | 固定返回None |
注:该初始化动作应包括总线设置及语音芯片的配置
方法名称 | Voice.setvolume([volume]) |
---|---|
功能 | 获取/设置音量 |
参数说明 | [volume]:设置播放音量,该参数为可选参数,当未传入参数时,功能为获取当前音量值; 当传入参数时,功能为设置音量值,范围为0~15,音量依次增大; |
返回值 | 传入参数时固定返回None; 未传入参数时返回当前音量值; |
方法名称 | Voice.playstart(addr[, volume]) |
---|---|
功能 | 开始播放指定地址语音 |
参数说明 | addr:指定播放语音地址,参数范围0~0xDF; [volume]:播放音量,若不传入该参数,按默认音量或之前设置的音量播放; |
返回值 | 固定返回None |
注:1、该方法为非阻塞模式。
2、若在上一段音频未播放结束时进行下一段音频的播放时会导致上一段音频强制结束。
方法名称 | Voice.playstop() |
---|---|
功能 | 停止播放 |
参数说明 | 无参数 |
返回值 | 固定返回None |
方法名称 | Voice.playloop(addr, *,times=-1, silence_time=0 [, volume]) |
---|---|
功能 | 循环播放指定地址语音 |
参数说明 | addr:指定循环播放语音地址,参数范围0~0xDF; times:设置循环次数,默认-1为无限循环; silence_time:设置每段地址之间播放的静音时间,默认为0,单位为ms,最小设置间隔为10ms; [volume]:播放音量,若不传入该参数,按默认音量或之前设置的音量播放; |
返回值 | 固定返回None |
注:1、该方法为非阻塞模式。
2、若在上一段音频未播放结束时进行下一段音频的播放时会导致上一段音频强制结束。
方法名称 | Voice.playsequence(addrlist, *,times =-1, silence_time=0 [, volume]) |
---|---|
功能 | 按顺序播放指定语音 |
参数说明 | addrlist:传入播放地址列表; times:设置列表循环次数,默认-1为无限循环; silence_time:设置每段地址之间播放的静音时间,默认为0,单位为ms,最小设置间隔为10ms; [volume]:播放音量,若不传入该参数,按默认音量或之前设置的音量播放; |
返回值 | 固定返回None |
注:1、该方法为非阻塞模式。
2、若在上一段音频未播放结束时进行下一段音频的播放时会导致上一段音频强制结束。
方法名称 | Voice.getstate() |
---|---|
功能 | 查询当前语音播放状态(播放/未播放) |
参数说明 | 无 |
返回值 | 若正在进行语音播放,返回True 若未进行语音播放,返回False |
方法名称 | Voice.modelname() |
---|---|
功能 | 获取模块厂家及型号 |
参数说明 | 无 |
返回值 | 返回模块厂家名称及型号 |