语音输入

分类

配置

示例

说明

内容

文字

组件在 stop 状态展示的文字，可为空

状态

组件呈现的状态，可选 'stop' | 'recording' | 'processing' 三种状态，为空时由组件自身控制。

• stop 停止状态，展示自定义文字及图标

• recording 录音状态，展示录音图标

• processing 处理状态，展示加载图标

交互方式

开启录音的方式，选择“外部控制”时，组件会被隐藏，仅允许通过组件 API 开启和停止录音。

语音上传

开启后，会自动将音频文件以 webm 的格式上传至所选存储路径，并将音频文件的 URL 保存至组件的 remoteURL 中。

语音存储路径

在“语音上传”开启时必填，指定音频文件的存储路径。

扩展配置

组件前缀图标，后缀图标，可通过将文字设为空，将前缀/后缀图标设置为任意图标，实现仅展示图标的效果。

交互

隐藏

隐藏，详情参见通用属性

样式

高度

高度，详情参见通用属性

外边距

外边距，详情参见通用属性

CSS 样式

圆角

组件圆角

字体大小

组件文本、图标大小

背景色

组件背景颜色

文本颜色

组件文本、图标颜色

激活态背景色

组件激活态背景颜色

激活态文本颜色

组件激活态文本、图标颜色

悬浮态背景色

组件悬浮态背景颜色

悬浮态文本颜色

组件悬浮态文本、图标颜色

名称

类型

示例

说明

audioFile

File/MobiFile

audioInput.audioFile

未开启语音上传时，audioFile 值为语音输入结果的 File 类型对象。开启语音上传后，audioFile 值为魔笔文件类型对象。

audioURL

string

audioInput.audioURL

语音输入结果的 base64 URL。

remoteURL

string

audioInput.remoteURL

仅在开启语音上传时有值，为上传后的音频文件的 URL 地址。

status

string

audioInput.status

组件内部的实际状态，分别为：

• stop 停止状态，未开启录音

• recording 录音状态，已开启录音

• processing 处理状态，如语音上传过程

uploadMode

string

audioInput.uploadMode

上传模式，为 'none' | 'system'。

hidden

boolean

audioInput.hidden

是否隐藏

配置

说明

请求录音前触发的事件，若设置为执行脚本，且return false，则不会请求录音。

录音开启后触发的事件。

录音开启失败时触发的事件，如用户未授权访问麦克风设备。

录音停止后触发的事件。

上传成功后触发的事件，仅在语音上传配置为“上传至系统文件存储”时有效。

上传失败后触发的事件，仅在语音上传配置为“上传至系统文件存储”时有效。