WebApp快捷打包
通讯录
转到模块插件

敬告:此 DEMO 演示为开放测试页面,仅用于开发者快速测试体验应用功能,请严格遵守开发者协议,了解更多

JS-SDK 引用方式:

♦ 普通网页 script 方式加载:下载最新版 jsBridge-v20240419.zip,请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库;

♦ js module 方式引用:npm install ym-jsbridge 具体请参考 npm package

pick 从通讯录中选择一个联系人

从通讯录中选择一个联系人,以 JSON 格式返回

jsBridge.contact.pick(function(succ, person) {
  if (person) {
    alert(JSON.stringify(person));
  } else {
    alert("已取消或没有使用通讯录的权限");
  }
});

/*
回调函数 person 参数说明:
{
  contactId : "联系人编号",  //字符串
  name      : "姓名",        //字符串
  familyName: "姓",          //字符串
  middleName: "中名",        //字符串
  givenName : "名",          //字符串
  phones    : [ "电话号码1", "电话号码2", ...], //字符串数组
  emails    : [ "电子邮箱1", "电子邮箱2", ...]  //字符串数组
}
*/

all 获取通讯所有联系人

获取通讯所有联系人,以 JSON 数组格式返回

jsBridge.contact.all(function(succ, persons) {
  if (persons) {
    if (persons.length) {
      alert("获取到" + persons.length + "个联系人信息\n第一个是\n" + JSON.stringify(persons[0]));
    } else {
      alert("没有联系人");
    }
  } else {
    alert("没有使用通讯录的权限");
  }
});

/*
回调函数 persons 参数是 jsBridge.contactpick 返回的 persion 数组:
[ person, person, person, ...]
*/

add 添加联系人

jsBridge.contact.add({
  //姓名
  name  : "张三",
  //电话数组
  phones: [ "13012345678", "010-12345678" ],
  //邮箱数组
  emails: [ "a@example.com" ]
}, function(succ, data) {
  alert(succ ? "已添加" : "添加失败或没有权限\n" + JSON.stringify(data));
});

delete 删除联系人

contactId:

jsBridge.contact.delete({
  //需要删除的联系人ID
  contactId: $("#contactId").val()
}, function(succ, data) {
  alert(succ ? "已删除" : "删除失败或没有权限\n" + JSON.stringify(data));
});