uniapp 悬浮窗（应用内无需授权） Ba-FloatWindow2

Posted 2023-03-05 三杯五岳

简介（下载地址）

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

悬浮窗（悬浮球、动态菜单、在其他应用上层显示） Ba-FloatBall（文档）