• uni.addPhoneContact(OBJECT)

    uni.addPhoneContact(OBJECT)

    调用后,用户可以选择将该表单以“新增联系人”或“添加到已有联系人”的方式(APP端目前没有选择步骤,将直接写入),写入手机系统通讯录,完成手机通讯录联系人和联系方式的增加。

    App平台提供了更多通讯录相关API,详见:https://www.html5plus.org/doc/zh_cn/contacts.html

    平台差异说明

    5+AppH5微信小程序支付宝小程序百度小程序头条小程序
    xx

    OBJECT 参数说明

    参数名类型必填说明
    photoFilePathString头像本地文件路径
    nickNameString昵称
    lastNameString姓氏
    middleNameString中间名
    firstNameString名字
    remarkString备注
    mobilePhoneNumberString手机号
    weChatNumberString微信号
    addressCountryString联系地址国家
    addressStateString联系地址省份
    addressCityString联系地址城市
    addressStreetString联系地址街道
    addressPostalCodeString联系地址邮政编码
    organizationString公司
    titleString职位
    workFaxNumberString工作传真
    workPhoneNumberString工作电话
    hostNumberString公司电话
    emailString电子邮件
    urlString网站
    workAddressCountryString工作地址国家
    workAddressStateString工作地址省份
    workAddressCityString工作地址城市
    workAddressStreetString工作地址街道
    workAddressPostalCodeString工作地址邮政编码
    homeFaxNumberString住宅传真
    homePhoneNumberString住宅电话
    homeAddressCountryString住宅地址国家
    homeAddressStateString住宅地址省份
    homeAddressCityString住宅地址城市
    homeAddressStreetString住宅地址街道
    homeAddressPostalCodeString住宅地址邮政编码
    successFunction接口调用成功的回调
    failFunction接口调用失败的回调函数
    completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

    回调结果

    回调类型errMsg说明
    successok添加成功
    cancelfail cancel用户取消操作
    failfail ${detail}调用失败,detail 加上详细信息。

    示例

    1. uni.addPhoneContact({
    2. nickName: '昵称',
    3. lastName: '姓',
    4. firstName: '名',
    5. remark: '备注',
    6. mobilePhoneNumber: '114',
    7. weChatNumber: 'wx123',
    8. success: function () {
    9. console.log('success');
    10. },
    11. fail: function () {
    12. console.log('fail');
    13. }
    14. });

    注意

    • 手机OS对通讯录访问有严格的权限限制和要求。在小程序中使用时,需注意微信等小程序载体本身已经获得了手机端的授权许可。
    • 打包App时,云打包则需要在manifest中配置权限和模块,离线打包需自行在原生工程中配置。

    发现错误?想参与编辑?在 GitHub 上编辑此页面!