更新记录

1.0.0(2021-11-29)

  1. 项目初建

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 7.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原生插件配置”->”云端插件“列表中删除该插件重新选择


导入插件

var FyKeyMonitor = uni.requireNativePlugin("fy-key-monitor")

使用方式有两种,一种是回调,一种是全局持久化监听

1. 回调的使用方法

// 开始监听
FyKeyMonitor.watch({
    isSystem: false,
    isDebug: false
}, result => {
    console.log("按键", result.keyCode)
    uni.showToast({
        title: result.keyCode + ":" + result.action,
        icon: "none"
    })
})

// 取消监听
FyKeyMonitor.unWatch()

// 暂停监听(此方法可以取消按键事件的拦截)
FyKeyMonitor.suspendWatch()

// 恢复监听
FyKeyMonitor.resumeWatch()

2. 全局持久化监听的使用方法

FyKeyMonitor.listener({
    isSystem: false,
    isDebug: false,
    eventName: "myKeyEvent"
})
var globalEvent = uni.requireNativePlugin('globalEvent');
globalEvent.addEventListener('myKeyEvent', function(result) {
    uni.showToast({
        title: result.keyCode + ":" + result.action,
        icon: "none"
    })
});

// 取消监听
FyKeyMonitor.unListener()

// 暂停监听(此方法可以取消按键事件的拦截)
FyKeyMonitor.suspendListener()

// 恢复监听
FyKeyMonitor.resumeListener()

注意 globalEvent事件只能通过页面的UniSDKInstance实例给当前页面发送globalEvent事件。其他页面无法接受。

以上这句话是官方文档原话,我没有做进一步测试,不清楚跨页面监听按键的具体情况

一些参数配置说明

参数名 默认值 说明
isSystem false 为true则APP进入后台之后依旧可以监听按键
isDebug false 为true则进入测试模式,左上角会出现一个TextView显示当前按键值
eventName keyEvent globalEvent的监听事件值,可以自由填写

关于Home键的监听

Home键的键值(keyCode)我写的是3,action为0。 如果你的TV盒子是在按下Home键之后直接杀了APP进程,那么抱歉这次Home键是监听不到的了

隐私、权限声明

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

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

插件不采集任何数据

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

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