更新记录

1.2(2024-04-07)

1、新增检查是否有通知权限; 2、新增检查是否受限; 3、新增打开自启动页面设置; 4、Android新增后台播放无声音乐模式。

1.1(2023-01-09)

1、增加IOS版本。

1.0(2022-12-22)

初始版本更新

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 14.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 适用版本区间:9 - 15

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


使用说明

该插件采用了最基础的常驻通知栏的方式进行App的保活

Android保活方式是常驻通知栏,IOS保活方式为后台持续定位和播放无声音乐模式

如果需要更强劲的保活可参考该免费的插件:保活 前台运行

不过该插件(保活 前台运行),存在以下问题:

1、体积太大,保活逻辑太多,在有的机型上经常出现 程序闪退的现象;

2、耗电量很大;

3、不能多App使用,如果多个App打包时选择了该插件,则不能同时安装;

4、它只有安卓版本!!!

基于以上问题,所以自己写了一个简单版的插件!!


20240331注:本来想后面增加一个后台持续定位的服务模式,不过看了官方的uni api后发现没这个必要了, 目前可以开启保活服务后,结合 位置监听Api 就可以实现。

具体使用方法

打包注意

在云打包时,IOS需要在manifest.json->App常用其它设置->后台运行能力 中增加:audio,location 配置

导入插件

// 导入组件
const JModule = uni.requireNativePlugin('J-FrontService')

检查是否有通知权限

检查是否有通知权限,这实际上没必要检测,因为开启服务时会自动检测。

let hasPermission = JModule.checkNoticesPermission()
// 返回 true 或 false

检查是否受限制

检查是否受限制,目前只是简单做了检测,不一定准确,因为各个手机厂商不太一样。

let res = JModule.checkIsLimit()
// { flag: true, data: true 或 false, msg: 'success' }

打开自启动设置页面

目前做了一些检查后,打开自启动设置页面

支持小米,华为,锤子,opp,vivo,三星,乐视,魅族

JModule.openSafeSetting()

开启服务

如果titlecontent为空,则默认标题为应用名称,内容为应用名称+正在运行

// 开启服务
JModule.startFrontService({
    // Android生效的配置
    title: '模拟标题',
    content: 'XXX应用正在运行',
    // Android新参数 mode
    mode: 'none', // none - 普通模式,media - 后台播放无声音乐模式
    // IOS生效的配置
    localtion: true,    // 后台持续定位保活
    voice: true         // 播放无声音乐保活
}, res => {
    let { flag, msg } = res
    // flag 为 true,开启成功,否则失败
    // msg 为 成功失败的消息
})

关闭服务

// 关闭服务
// IOS没必要关闭,已经做了切换至后台时自动启动保活任务
// 切回应用时自动关闭
JModule.stopService(res => {
    let { flag, msg } = res
    // flag 为 true,关闭成功,否则失败
    // msg 为 成功失败的消息
})

联系作者

QQ:476743842

隐私、权限声明

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

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

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

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