更新记录

1.4（2025-04-12）

支持在线声音资源播放

1.3（2024-05-07）

1、优化播放，支持频繁触发 2、支持手动停止播放（stop方法）

1.2（2024-04-07）

支持设置音量大小

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

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

简介

Ba-Beep 是一款uniapp提供声音提示、震动提示的插件，如操作提示音（扫码、读卡、打印、按键等）。也可实现简单的语音播报功能，支持定制。（注意：建议先试用，再购买）。

• 支持声音（默认有beep、数字、英文字母、欢迎光临、谢谢等，可自定义）
• 支持震动（可自定义任意震动效果）
• 支持语音播报（内容可联系作者定制，也可自行添加）
• 支持的音频格式有mp3、wav、ogg、3gp、AAC、AMR、FLAC、MIDI等等
• 支持顺序播放列表声音（playList）

定制声音，或有建议和需要，请联系

使用方法

在 script 中引入组件

    const beep = uni.requireNativePlugin('Ba-Beep')

在 script 中调用

        methods: {
            play(name = this.name) { //播放声音
                beep.play({
                        beepName: name,//音频资源名称，参照“音频资源配置”
                        //volume:0.1//设置音量，默认0.1
                    },
                    (res) => {
                        console.log(res)
                        uni.showToast({
                            title: res.msg,
                            icon: "none",
                            duration: 3000
                        })
                    });
            },
            playList() {
                beep.playList({
                        beepList: ["_daozhang", "_1", "_bai", "_2", "_shi", "_dian", "_5", "_yuan"],
                        //restart: true, //是否从新开始，默认false
                        //volume:0.1//设置音量，默认0.1
                    },
                    (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”
  '_shi'	十
  '_bai'	百
  '_qian'	千
  '_wan'	万
  '_yi'	亿
  '_dian'	点
  '_yuan'	元
  '_qing'	请
  '_dao'	到
  '_chuangkou'	窗口
  '_haochuangkou'	号窗口

• 自定义资源：所用到的音频资源，放在“nativeplugins\Ba-Beep\android\res\raw” 目录下

方法清单

播放声音 play 方法参数

playList 方法参数

震动 playVibrate 方法参数

震动规则：传递一个整型数组作为关闭和开启震动的持续时间，以毫秒为单位。第一个值表示等待震动开启的毫秒数，下一个值表示保持震动的毫秒数，这个序列值交替表示震动关闭和开启的毫秒数。

如：pattern 值为 [500,100,500,100]，先等待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-ImageCompressor（文档）

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

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

原生Toast弹窗提示（穿透所有界面、穿透原生；自定义颜色、图标 ） Ba-Toast（文档）

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

pdf阅读（手势缩放、显示页数） Ba-Pdf（文档）

声音提示、震动提示、语音播报 Ba-Beep（文档）

websocket原生服务（自动重连、心跳检测） Ba-Websocket（文档）

短信监听（验证码） Ba-Sms（文档）

智能安装（自动升级） Ba-SmartUpgrade（文档）

监听系统广播、自定义广播 Ba-Broadcast（文档）

监听通知栏消息（支持白名单、黑名单、过滤） Ba-NotifyListener（文档）

全局置灰、哀悼置灰（可动态、同时支持nvue、vue） Ba-Gray（文档）

获取设备唯一标识（OAID、AAID、IMEI等） Ba-IdCode（文档）

实时定位（系统、后台运行、支持息屏）插件 Ba-Location（文档）