添加手机联系人

my.addPhoneContact（）

基础库版本 1.10.0 开始支持，低版本需做兼容处理用户可以选择将该表单以“创建新联系人”或“添加到现有联系人”的方式，写入到手机系统的通讯录。

入参

参数类型必填说明
photoFilePathString否头像本地文件路径
nickNameString否昵称
lastNameString否姓氏
middleNameString否中间名
firstNameString否名字
remarkString否备注
mobilePhoneNumberString否手机号
alipayAccountString否支付宝账号
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否调用结束的回调函数（调用成功、失败都会执行）

以上字段视不同 ROM 中内置的联系人 App 的支持程度不同, 可能不支持 Emoji 表情和颜文字, 当不支持时, 此项会被忽略.

返回值

成功:

success = true

失败:

errorerrorMessage说明
11fail cancel用户取消操作
3fail ${detail}调用失败，detail 加上详细信息

代码示例

  1. Page({
  2.   data:{
  3.       "photoFilePath": "/sdcard/DCIM/Camera/a.png",
  4.       "nickName": "七月流火",
  5.       "lastName": "Last",
  6.       "middleName": "Middle",
  7.       "firstName": "First",
  8.       "remark": "这里是备注",
  9.       "mobilePhoneNumber": "13800000000",
  10.       "homePhoneNumber": "11111115",
  11.       "workPhoneNumber": "11111112",
  12.       "homeFaxNumber": "11111114",
  13.       "workFaxNumber": "11111111",
  14.       "hostNumber": "11111113",
  15.       "alipayAccount": "alipay@alipay.com",
  16.       "addressCountry": "US",
  17.       "addressState": "California",
  18.       "addressCity": "San Francisco",
  19.       "addressStreet": "Mountain View",
  20.       "addressPostalCode": "94016",
  21.       "workAddressCountry": "China",
  22.       "workAddressState": "Zhejiang",
  23.       "workAddressCity": "Hangzhou",
  24.       "workAddressStreet": "Tianmushan Road",
  25.       "workAddressPostalCode": "361005",
  26.       "homeAddressCountry": "Canada",
  27.       "homeAddressState": "Ontairo",
  28.       "homeAddressCity": "Toronto",
  29.       "homeAddressStreet": "No.234 Road",
  30.       "homeAddressPostalCode": "123456",
  31.       "organization": "AntFin",
  32.       "title": "Developer",
  33.       "email": "liuhuo01@sina.com",
  34.       "url": "www.alipay.com"
  35.   },
  36.   onInput(e) {
  37.     this.data[e.currentTarget.id] = e.detail.value;
  38.   },
  39.   addPhoneContact() {
  40.     my.addPhoneContact(this.data);
  41.   }
  42. });

原文: https://docs.alipay.com/mini/api/contact