更新记录
1.0.4(2023-07-14)
优化点击悬浮球跳转到桌面
1.0.3(2021-10-11)
新增悬浮权限检测方法
1.0.2(2021-07-19)
解决低版本无法从桌面打开app问题
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 12.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原生插件配置”->”云端插件“列表中删除该插件重新选择
全局悬浮球配置初始参数说明
参数名 | 参数类型 | 参数说明 |
---|---|---|
debug | boolean | 是否启用调试模式 |
backToMainPage | boolean | 是否运行点击悬浮球返回主页,如果为false,则通过回调返回 |
appid | String | 项目manifest.json中的appid |
插件使用说明
1.初始化
const floatingBall = uni.requireNativePlugin('float-ball')
2.参数配置(悬浮球图标请放到static/floatBallIcon目录下)
floatingBall.configFloatBall({
debug: false,
backToMainPage: true,
appid:"__UNI__9EDE**D",
//图标请放到static/floatBallIcon目录下
},
(ret) => {
console.log(ret)
}
);
3.显示全局悬浮球
floatingBall.showFloatBallIcon();
4.隐藏全局悬浮球
floatingBall.hideFloatBallIcon();
5.从桌面自动弹出app界面(注意:切换到后台的时候悬浮窗设置成显示,才可实现自动弹出)
floatingBall.openAppView((res) => {
console.log(res)
});
6.关闭悬浮服务
floatingBall.destroy()