简介(下载地址)
Ba-Beep 是一款uniapp提供声音提示、震动提示的插件,如操作提示音(扫码、读卡、打印、按键等)。也可实现简单的语音播报功能。
- 支持声音(默认有beep、数字、英文字母、欢迎光临、谢谢等,可自定义)
- 支持震动(可自定义震动效果)
- 支持语音播报(内容可联系作者定制,也可自行添加)
- 支持的音频格式有mp3、wav、ogg、3gp、AAC、AMR、FLAC、MIDI等
使用方法
在 script
中引入组件
const beep = uni.requireNativePlugin('Ba-Beep')
在 script
中调用
methods: {
play(name = this.name) { //播放声音
beep.play({
beepName: name,//音频资源名称,参照“音频资源配置”
},
(res) => {
console.log(res)
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
playVibrate() { //震动
//let params = {};//默认 500
let params = {
repeat: 0,//重复 -1:表示不重复 0:循环的震动 >1:表示从哪里开始重复
pattern: [500, 200, 500, 100]//震动规则,传递一个整型数组作为关闭和开启震动的持续时间,以毫秒为单位。第一个值表示等待震动开启的毫秒数,下一个值表示保持震动的毫秒数,这个序列值交替表示震动关闭和开启的毫秒数
}; //自定义规则
beep.playVibrate(params,
(res) => {
console.log(res)
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
cancelVibrate() { //取消震动
beep.cancelVibrate(
(res) => {
console.log(res)
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
}
音频资源配置
语音提示、语音播报,支持的音频格式有mp3、wav、ogg、3gp、AAC、AMR、FLAC、MIDI等等。
注意:配置更改后,需要重新制作基座才生效,建议提前配置。
资源名称 | 说明 |
---|---|
‘beep’ | beep音 |
‘welcome’ | 欢迎光临 |
‘thanks’ | 谢谢 |
‘_0’ | 数字0~9,名称依次为下划线+对应数字,如0是“_0” |
‘_a’ | 英文字母A~Z,名称依次为下划线+对应小写字母,如A是“_a” |
- 自定义资源:所用到的音频资源,放在“nativeplugins\Ba-Beep\android\res\raw” 目录下
方法清单
名称 | 说明 |
---|---|
play | 播放提示音、语音播报 |
playVibrate | 震动 |
cancelVibrate | 取消震动 |
播放声音 play 方法参数
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
beepName | String | ‘beep’ | 资源文件路径 |
震动 playVibrate 方法参数
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
repeat | Number | 0 | 重复 -1:表示不重复 0:循环的震动 >1:表示从哪里开始重复 |
pattern | Array | [] | 震动规则,如“[500,100,500,100]” |
震动规则:传递一个整型数组作为关闭和开启震动的持续时间,以毫秒为单位。第一个值表示等待震动开启的毫秒数,下一个值表示保持震动的毫秒数,这个序列值交替表示震动关闭和开启的毫秒数。
系列插件
应用未读角标插件 Ba-Shortcut-Badge (文档)
扫码原生插件(毫秒级、支持多码)Ba-Scanner-G(文档)
扫码原生插件 - 新(可任意自定义界面版本;支持连续扫码;支持设置扫码格式)Ba-Scanner(文档)
动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar(文档)
安卓快捷方式(桌面长按app图标) Ba-Shortcut(文档)
动态切换应用图标、名称(如新年、国庆等) Ba-ChangeIcon(文档)