更新记录
1.1(2023-10-17)
1、优化show和hide方法,解决双击退出问题
1.0(2023-02-19)
init
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 14.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:支持 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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-FloatWindow2
简介
Ba-FloatWindow2 是一款应用内并且无需授权的悬浮窗插件。支持多种拖动;自定义位置、大小;支持动态修改。 (注意:建议先试用,再购买)。
- 支持自动定义起始位置
- 支持自定义悬浮窗大小
- 支持贴边显示
- 支持多种拖动方效果:不可拖动、任意拖动、贴边拖动
- 支持动态修改悬浮窗图片
有建议和需要,请联系QQ:2579546054
使用方法
在 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-Notify(文档)
应用未读角标插件 Ba-Shortcut-Badge (文档)
扫码原生插件(毫秒级、支持多码)Ba-Scanner-G(文档)
扫码原生插件 - 新(可任意自定义界面版本;支持连续扫码;支持设置扫码格式)Ba-Scanner(文档)
动态修改状态栏、导航栏背景色、字体颜色插件 Ba-AppBar(文档)
安卓保活插件(采用多种主流技术) Ba-KeepAlive(文档)
安卓快捷方式(桌面长按app图标) Ba-Shortcut(文档)
自定义图片水印(任意位置) Ba-Watermark(文档)
最接近微信的图片压缩插件 Ba-ImageCompressor(文档)
视频压缩、视频剪辑插件 Ba-VideoCompressor(文档)
动态切换应用图标、名称(如新年、国庆等) Ba-ChangeIcon(文档)
原生Toast弹窗提示(穿透所有界面、穿透原生;自定义颜色、图标 ) Ba-Toast(文档)
websocket原生服务(自动重连、心跳检测) Ba-Websocket(文档)
智能安装(自动升级) Ba-SmartUpgrade(文档)
监听通知栏消息(支持白名单、黑名单、过滤) Ba-NotifyListener(文档)
全局置灰、哀悼置灰(可动态、同时支持nvue、vue) Ba-Gray(文档)
获取设备唯一标识(OAID、AAID、IMEI等) Ba-IdCode(文档)
实时定位(系统、后台运行、支持息屏)插件 Ba-Location(文档)
窗口小工具、桌面小部件、微件 Ba-AppWidget(文档)