uniapp 声音提示、震动提示、语音播报插件 Ba-Beep

简介（下载地址）

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-MediaPicker （文档）

图片编辑插件 Ba-ImageEditor （文档）

文件选择插件 Ba-FilePicker （文档）

应用消息通知插件 Ba-Notify（文档）

应用未读角标插件 Ba-Shortcut-Badge （文档）

应用开机自启插件 Ba-Autoboot（文档）

扫码原生插件（毫秒级、支持多码）Ba-Scanner-G（文档）

扫码原生插件 - 新（可任意自定义界面版本；支持连续扫码；支持设置扫码格式）Ba-Scanner（文档）

动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar（文档）

原生sqlite本地数据库管理 Ba-Sqlite（文档）

安卓保活插件 Ba-KeepAlive（文档）

安卓快捷方式（桌面长按app图标） Ba-Shortcut（文档）

自定义图片水印 Ba-Watermark（文档）

视频压缩插件 Ba-VideoCompressor（文档）

动态切换应用图标、名称（如新年、国庆等） Ba-ChangeIcon（文档）

原生Toast弹窗提示（可穿透所有界面） Ba-Toast（文档）

图片涂鸦、画笔 Ba-ImagePaint（文档）

pdf阅读 Ba-Pdf（文档）