更新记录

1.0.2(2024-03-20)

增加了电话授权权限

1.0.1(2024-02-02)

暂无


平台兼容性

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


<template>
    <view class="content">
        <!-- <image class="logo" src="/static/logo.png"></image> -->
        <view class="text-area">
            <button @click="handleBtnClick">点击按钮开始获取必要权限</button>
        </view>
    </view>
</template>

<script>
    export default {
        data() {
            return {
                title: 'Hello'
            }
        },
        onLoad() {
            /* 如果想要在页面开始的时候,就验证,那么就要在onLoad方法上面调用 */
            this.handleBtnClick()
        },
        methods: {
            handleBtnClick() {
            const auth = uni.requireNativePlugin('msf-authorization')
            auth.authorizationFn({
                /* 根据anroid5.0版本以上需要动态授权的,有9类,分别如下
                    1.定位 => 'location',
                    2.电话 => 'phone',
                    3.日历 => 'calendar',
                    4.相机 => 'camear',
                    5.电话联系人 => 'contants',
                    6.麦克风 => 'audio',
                    7.传感器 => 'sensors',
                    8.短信 => 'sms',
                    9.存储啊 => 'storage',
                 */
                // 如果想要软件app一定要获取对应的授权,否则不给使用,那么直接把对应的字符串放数组即可
                params: ['location','phone'],  // 例如:此app必须要授权 定位  和  打电话权限,否则直接退出app,到授权页面
                timeOut: 5000 // 用户拒绝必要授权之后,几秒开始退出应用并且跳转到授权页面 // 不传默认3秒
            }, e => {
                /* 
                   e: 为返回的参数,是一个对象,当用户不授权的时候,返回用户需要授权的信息,前端拿到之后,可以提醒用户操作对应的权限
                   {
                       code: 1001, // 代表用户有必要的授权,没有授权
                       message:'请授权必要的权限,否则用不了',
                       'not-auth':notAuthList // 是一个数组,里面返回的是用户没有授予的权限
                    }
                 */
                uni.showToast({
                    icon:'none',
                    title:JSON.stringify(e), // 打印插件返回的接口,给前端操作
                    duration: 5000
                })
            })
            }
        }
    }
</script>

<style>
.text-area {
    margin-top: 20px;
}
</style>

插件方法和参数

调用插件方法名字 传递参数 说明
authorizationFn() {params :['location','phone'], timeOut :5000} 看上面代码注释

隐私、权限声明

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

<!-- 打电话权限--> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <!-- 定位权限--> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> // 日历权限 <uses-permission android:name="android.permission.READ_CALENDAR"/> // 相机权限 <uses-permission android:name="android.permission.CAMERA"/> //联系人权限 <uses-permission android:name="android.permission.READ_CONTACTS"/> // 麦克风 <uses-permission android:name="android.permission.RECORD_AUDIO"/> // 传感器 <uses-permission android:name="android.permission.BODY_SENSORS"/> // 短信权限 <uses-permission android:name="android.permission.SEND_SMS"/> //存储权限 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

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

插件使用的 第三方App SDK可能会采集数据

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

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