简介(下载地址)
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(文档)