更新记录
1.0.0(2021-11-29)
- 项目初建
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 7.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原生插件配置”->”云端插件“列表中删除该插件重新选择
导入插件
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键是监听不到的了