简介（下载地址）
Ba-FloatWindow2 是一款应用内并且无需授权的悬浮窗插件。支持多种拖动；自定义位置、大小；支持动态修改。
- 支持自动定义起始位置
- 支持自定义悬浮窗大小
- 支持贴边显示
- 支持多种拖动方效果：不可拖动、任意拖动、贴边拖动
- 支持动态修改悬浮窗图片
截图展示
使用方法
在 script 中引入组件
const floatWindow = uni.requireNativePlugin('Ba-FloatWindow2')
在 script 中调用
data() {
return {
widthRatio: 0.1,
heightRatio: 0.1,
xRatio: 0.8,
yRatio: 0.8,
moveType: 3,
iconPath: "ba_float_win2_icon"
}
},
methods: {
showFW() { //显示
floatWindow.show({
widthRatio: this.widthRatio,
heightRatio: this.heightRatio,
xRatio: this.xRatio,
yRatio: this.yRatio,
moveType: this.moveType,
iconPath: this.iconPath
},
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
hideFW() { //隐藏
floatWindow.hide({},
(res) => {
console.log(res);
uni.showToast({
title: res.msg,
icon: "none",
duration: 3000
})
});
},
}
UI 图标设置
- 默认悬浮图标：默认悬浮图标设置，在项目的 “nativeplugins\Ba-FloatWindow2\android\res\drawable-xxhdpi” 目录下（没有就新建），添加 “ba_float_win2_icon.png” 图片文件即可。注意：更改后需要重新制作基座才能生效，建议提前配置。
- 自定义悬浮图标：自定义图标路径和默认一样，任意添加图片，名字在 initIcon方法的 “iconPath”字段设置即可。如添加自定义图片"custom_icon.png"，那么设置 iconPath 为 “custom_icon”
方法清单
| 名称 | 说明 |
|---|---|
| show | 显示悬浮窗 |
| hide | 隐藏悬浮窗 |
监听点击事件
在应用生命周期App.vue的onLaunch事件中设置监听：
onLaunch: function() {
var globalEvent = uni.requireNativePlugin('globalEvent');
globalEvent.addEventListener('baFloatWindow2Event', function(e) {
console.log('baFloatWindow2Event：' + JSON.stringify(e));
//这里写你的处理逻辑
});
},
onShow: function() {
},
onHide: function() {
}
show 方法参数
初始化悬浮窗
| 属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| widthRatio | Number | false | 0.15 | 根据屏幕宽度比例，设置悬浮窗宽度 |
| heightRatio | Number | false | 0.15 | 根据屏幕宽度比例，设置悬浮窗高度 |
| xRatio | Number | false | 0.8 | 根据屏幕宽度比例，设置悬浮窗x轴起始位置 |
| yRatio | Number | false | 0.8 | 根据屏幕高度比例，设置悬浮窗y轴起始位置 |
| moveType | Number | false | 3 | 拖动效果，1：不可拖动、2：任意拖动、3：贴边拖动 |
| iconPath | String | false | 资源图片项目路径，参照’UI 图标设置’ |
系列插件
图片选择插件 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（文档）
窗口小工具、桌面小部件、微件 Ba-AppWidget（文档）
窗口小工具、桌面小部件、微件（日历、时间） Ba-AwCalendarS（文档）
画中画悬浮窗（视频） Ba-VideoPip（文档）
悬浮窗（在其他应用上层显示） Ba-FloatWindow（文档）
悬浮窗（应用内、无需授权） Ba-FloatWindow2（文档）
