更新记录
1.0.6(2024-07-11)
增加分页查询函数
1.0.5(2023-04-21)
结果回调逻辑优化,解决偶现结果回调失败的bug
1.0.4(2023-04-04)
解决部分手机获取联系人信息失败问题
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 12.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原生插件配置”->”云端插件“列表中删除该插件重新选择
安卓获取手机通讯录联系人原生插件
- 支持Android平台使用
- 函数说明
序号 | 函数名称 | 函数说明 |
---|---|---|
1 | getAllContactInfo(function callback) | 获取通讯录联系人,参数为接收结果的回调函数 |
2 | setRefusedHintText(String text) | 设置拒绝权限后提示弹窗的提示文案 |
3 | getContactsByPage(int page, int pageSize, function callback) | 分页获取联系人数据,page最小取值为1,pageSize为当前页最大条数 |
-
getAllContactInfo(function callback)函数回调结果示例
{ "code":0, "message":"success", "data":[ { "name":"联系人1", "phoneNumber":"1325555xxxx" }, { "name":"联系人2", "phoneNumber":"1506666xxxx" } ] }
-
setRefusedHintText(String text)函数说明
该函数为设置拒绝权限后提示弹窗的提示文案 默认文案为:“应用需要访问你的联系人权限,以便于联系人展示功能的正常使用!”
- getContactsByPage(int page, int pageSize, function callback)函数说明
该函数为分页获取联系人数据,page最小取值为1,pageSize为当前页最大条数
-
code 值说明
序号 code值 说明 1 0 获取联系人成功 2 -1 获取联系人失败,详情请查看回调结果中message -
使用示例
<template> <view class="uni-column"> <view class="uni-row"> <button @click="getContacts()">获取联系人</button> </view> <view class="uni-row"> <button @click="getContactsByPage()">分页获取联系人</button> </view> <view class="uni-column" style="margin-top: 40rpx;padding: 30rpx;"> <text v-for="(item,index) in list">{{item}}</text> </view> </view> </template> <script> const contactsModule = uni.requireNativePlugin("jushi-Contacts") export default { data() { return { list: [], count: 1 } }, created() { contactsModule.setRefusedHintText('需要获取联系人权限!') }, methods: { getContacts() { contactsModule.getAllContactInfo(res => { console.log("获取联系人结果:" + res) var json = JSON.parse(res) if (parseInt(json.code) == -1) { //获取联系人失败 return } json.data.forEach(e => { this.list.push(`姓名:${e.name}\n电话:${e.phoneNumber}\n\n\n`) }) }) }, getContactsByPage() { contactsModule.getContactsByPage(this.count, 20, res => { console.log("获取联系人结果:" + res) var json = JSON.parse(res) if (parseInt(json.code) == -1) { //获取联系人失败 return } json.data.forEach(e => { this.list.push(`姓名:${e.name}\n电话:${e.phoneNumber}\n\n\n`) }) if (json.data.length < 20) return this.count++ }) } } } </script> <style> .uni-column { display: flex; flex-direction: column; } .uni-row { display: flex; flex-direction: row; } </style>
-
示例应用下载
其它插件
安卓原生插件
-
UTS插件
-
前端插件