更新记录

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:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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()

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/> <uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问