更新记录

1.0.2(2020-12-16)

扩展接收按键事件范围

1.0.0(2020-12-03)

本插件实现了uniapp下监听耳机按键消息的功能,主要监听的是安卓下广播的ACTION_MEDIA_BUTTON消息。我在最初测试的时候,发现使用uniapp的广播消息监听方法并不能很好的监听耳机按键消息,这是由于耳机消息的特殊性质决定的。就是必须要在程序里用AudioManager对象去注册消息监听,所以我封装了一个插件。

查看更多

平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 支持CPU类型:armeabi-v7a,arm64-v8a ×

原生插件通用使用流程:

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


1.插件描述 本插件实现了uniapp下监听耳机按键消息的功能,主要监听的是安卓下广播的ACTION_MEDIA_BUTTON消息。我在最初测试的时候,发现使用uniapp的广播消息监听方法并不能很好的监听耳机按键消息,这是由于耳机消息的特殊性质决定的。就是必须要在程序里用AudioManager对象去注册消息监听,所以我封装了一个插件。 关于ACTION_MEDIA_BUTTON介绍文章请参考:https://blog.csdn.net/qinjuning/article/details/6938436

2.插件使用 插件提供了三个方法:

getVersion:获取插件版本号

startListenMediaButton:开始监听

endListenMediaButton:结束监听

按键消息通过全局事件globalEvent进行发送,在onload时开启事件监听就行了。

            var globalEvent = uni.requireNativePlugin('globalEvent');
            globalEvent.addEventListener('mymedioevent', function(e) {
                console.log(e);
            });

插件返回的按键消息时Key_Code码,关于Key_Code码的对应请参考: https://blog.csdn.net/demodashi666/article/details/78234127

建议:在使用本插件前,请先在安卓设备上安装TestKey.apk测试手机是否支持耳机监听,因为我发现部分手机对耳机消息屏蔽了。

apk下载:https://raw.githubusercontent.com/kangear/TestKey/master/apk/TestKey.apk

项目:https://github.com/kangear/testkey

3.示例代码

<template>
    <view>
        <view>
            <button @click="getversion()">getversion</button>
            <button @click="startlisten()">startlisten</button>
            <button @click="endlisten()">endlisten</button>
        </view>
        <view>
            <list>
                <cell v-for="(item,index) in msglist">
                    <text>{{index}}_{{item}}\n</text>
                </cell>
            </list>
        </view>
    </view>
</template>

<script >
    const mediobutton = uni.requireNativePlugin('zzzili-mediobutton');
    export default {
        data() {
            return {
                title: '测试',
                msglist: []
            }
        },
        onLoad() {
            var that = this;
            var globalEvent = uni.requireNativePlugin('globalEvent');
            globalEvent.addEventListener('mymedioevent', function(e) {
                console.log(e);
                var event = e.event;
                that.msglist.push(that.getEventStr(event));
            });

        },
        methods: {
            getversion: function() {
                var ver = mediobutton.getVersion();
                console.log(ver);
                this.msglist.push(ver);

            },
            startlisten: function() {
                var str = mediobutton.startListenMediaButton();
                console.log(str);
                this.msglist.push(str);

            },
            endlisten: function() {
                var str = mediobutton.endListenMediaButton();
                console.log(str);
                this.msglist.push(str);
            },
            getEventStr: function(event) {
                console.log(event);
                var str = event;
                switch (event) {
                    case '126':
                        {
                            str = 'KEYCODE_MEDIA_PLAY';
                            break;
                        }
                    case '127':
                        {
                            str = 'KEYCODE_MEDIA_PAUSE';
                            break;
                        }
                    case '87':
                        {
                            str = 'KEYCODE_MEDIA_NEXT';
                            break;
                        }
                    case '88':
                        {
                            str = 'KEYCODE_MEDIA_PREVIOUS';
                            break;
                        }

                }
                return str;
            }

        }
    }
</script >

<style>
</style>

隐私、权限声明

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

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

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

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