更新记录

1.0.1(2024-08-16)

添加适配屏幕宽度的配置项

1.0.0(2024-06-13)

插件首次上传


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
Android:4.4,iOS:不支持,HarmonyNext:不确定 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

使用说明

下载试用本插件后,请重新打包自定义基座

该插件是解决 android 自定义浮窗内容的方案,可以实现悬浮窗口、悬浮球等需求,并且完成悬浮窗口与 APP 的交互等。

扫下面二维码下载 demo 查看效果

demo

有关于该插件的疑问或者技术探讨可以联系作者(备注来源)

wx 号:z1003975792y

API 介绍

申请浮窗权限函数 applyFloatingWindowPermission

参数 类型 必填 备注
无参数
import { applyFloatingWindowPermission } from '@/uni_modules/zy-floatWindow'

applyFloatingWindowPermission()

判断是否拥有浮窗权限函数 isHasFloatingWindowPermission

参数 类型 必填 备注
无参数
import { isHasFloatingWindowPermission } from '@/uni_modules/zy-floatWindow'

isHasFloatingWindowPermission() // 返回值true拥有权限,反之

打开浮窗函数 openFloatingWindow

参数 类型 必填 备注
option object 选项参数
import {
    openFloatingWindow
} from "@/uni_modules/zy-floatWindow";

let option = {
    url: 'http://10.10.60.88:3000/pages/test.html', // 链接url,本地调试需注意用ip,不要用localhost
    type: 1, // 可选,悬浮窗位置  1、左上 2、右上 3、左下、4、右下
    urlSchemes: 'test1',  // 可选,默认test1,可自定义, 下面有配置教程
    isScreenWidth: false, // 可选,默认false,如果为true,表示浮窗宽度是屏幕宽度,下面的width失效
    width: 400,  // 可选,默认WindowManager.LayoutParams.WRAP_CONTENT,取决于webView内容宽度
    height: 400 // 可选,默认WindowManager.LayoutParams.WRAP_CONTENT, 取决于webView内容高度
    x: 0, // 可选,默认0, 距离屏幕左边沿(type是1或3)或右边沿的距离(type是2或4))
    y: 0, // 可选,默认0, 距离屏幕上边沿(type是1或2)或下边沿的距离(type是3或4)
    }
    openFloatingWindow(option)

uni-app 配置 urlSchemes 教程

H5 页面示例代码(包含打开 APP 等)

App 端获取参数(根据参数做一些特殊业务、比如页面跳转等)

关闭浮窗函数 closeFloatWindow

import { closeFloatWindow } from '@/uni_modules/zy-floatWindow'

closeFloatWindow()

隐私、权限声明

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

浮窗

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

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

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