宜信同城网交流论坛技术专版技术专区Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作 ...Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作。通过plus.contacts获取系统 ...

admin 发表于 2023-2-16 18:54:54

Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作 ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作。通过plus.contacts获取系统通讯录管理对象。
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ADDRESSBOOK_PHONE">ADDRESSBOOK_PHONE</a>: 手机通讯录</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ADDRESSBOOK_SIM">ADDRESSBOOK_SIM</a>: SIM卡通讯录</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.getAddressBook">getAddressBook</a>: 获取通讯录对象</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.AddressBook">AddressBook</a>: 通讯录对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.Contact">Contact</a>: 联系人对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a>: JSON对象，联系人域数据对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactName">ContactName</a>: JSON对象，联系人名称对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactAddress">ContactAddress</a>: JSON对象，联系人地址对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactOrganization">ContactOrganization</a>: JSON对象，联系人所属组织信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactFindOption">ContactFindOption</a>: JSON对象，查找联系人参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactFindFilter">ContactFindFilter</a>: JSON对象，联系人查找过滤器</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.AddressBookSuccessCallback">AddressBookSuccessCallback</a>: 获取通讯录操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.FindSuccessCallback">FindSuccessCallback</a>: 查找联系人操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsSuccessCallback">ContactsSuccessCallback</a>: 联系人操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a>: 联系人操作失败回调</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Contacts": {
"description": "通讯录，访问系统联系人"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">ADDRESSBOOK_PHONE</h1>
手机通讯录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.contacts.ADDRESSBOOK_PHONE;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
通讯录类型常量，数值类型，固定值为0，用于获取系统的联系人信息。
<h1 style="margin-left:0;">ADDRESSBOOK_SIM</h1>
SIM卡通讯录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.contacts.ADDRESSBOOK_SIM;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
通讯录类型常量，数值类型，固定值为1，用于获取SIM卡上的联系人信息。
<h3>平台支持</h3>
<ul><li>Android - 2.2+ (不支持) : 暂未实现SIM卡联系人的访问 </li><li>iOS - 4.3+ (不支持) : 不支持SIM卡联系人的访问 </li></ul>
<h1 style="margin-left:0;">getAddressBook</h1>
获取通讯录对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.contacts.getAddressBook( type, succesCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
根据指定通讯录类型获取通讯录对象，获取通讯录对象后可对其进行增、删、改操作。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>type: ( Number ) 必选 要获取的通讯录类型 可取通讯录类型常量，可获取手机通讯录或SIM卡通讯录。 </li><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.AddressBookSuccessCallback">AddressBookSuccessCallback</a> ) 必选 获取通讯录对象成功回调 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a> ) 可选 获取通讯录对象失败回调 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Contacts Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
plus.contacts.getAddressBook( plus.contacts.ADDRESSBOOK_PHONE, function( addressbook ) {
// 可通过addressbook进行通讯录操作
alert( "Get address book success!" );
}, function ( e ) {
alert( "Get address book failed: " + e.message );
} );
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AddressBook</h1>
通讯录对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface AddressBook {
function Contact create();
function void find( contactFields, successCB, errorCB, findOptions );
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
通讯录管理对象，可对系统通讯录进行联系人的增、删、改、查操作。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.AddressBook.create">create</a>: 创建联系人</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.AddressBook.find">find</a>: 在通讯录中查找联系人</li></ul>
<h1 style="margin-left:0;">create</h1>
创建联系人
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Contact addressbook.create();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建一个系统联系人，并返回联系人对象，可对联系人对象进行操作设置联系人信息，如名称、地址、电话等。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact">Contact</a> : 联系人对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Contacts Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
plus.contacts.getAddressBook( plus.contacts.ADDRESSBOOK_PHONE, function( addressbook ) {
// 向通讯录中添加联系人
var contact = addressbook.create();
contact.name = {givenName:"王安"};
contact.phoneNumbers = [{type:"手机",value:"88888888",preferred:true}];
contact.save();
}, function ( e ) {
alert( "Get address book failed: " + e.message );
} );
}, false );
</script>
</head>
<body>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">find</h1>
在通讯录中查找联系人
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void addressbook.find( contactFields, successCB, errorCB, findOptions );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
在通讯录中安装指定的规则查找联系人，contactFields可设定查找返回的联系人中包含的字段值，查找联系人成功时通过successCB回调返回，查找联系人失败则通过errorCB回调返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>contactFields: ( String[] ) 必选 查找返回联系人中需要包含的信息 可取Contact对象的属性名称，若指定为null或""或空数组则包含所有联系人信息。可通过“.”来分割子项，如“name.familyName”指定获取联系人名称中的姓；对于ContactField类型的值则可指定类型值，如“phoneNumbers.mobile”指定获取联系人的手机号码。 </li><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.FindSuccessCallback">FindSuccessCallback</a> ) 必选 查找联系人操作成功回调 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a> ) 可选 查找联系人操作失败回调 </li><li>findOptions: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactFindOption">ContactFindOption</a> ) 可选 查找联系人的参数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Contacts Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
}, false );
function find(){
plus.contacts.getAddressBook(plus.contacts.ADDRESSBOOK_PHONE, function (addressbook) {
addressbook.find(["displayName","phoneNumbers"],function(contacts){
alert(contacts.length);
}, function () {
alert("error");
},{multiple:true});
},function(e){
alert("Get address book failed: " + e.message);
});
}

</script>
</head>
<body>
<button onclick="find()">Find</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">Contact</h1>
联系人对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Contact {
readonly attribute String id;
attribute String displayName;
attribute ContactName name;
attribute String nickname;
attribute ContackField[] phoneNumbers;
attribute ContactField[] emails;
attribute ContactAddress[] addresses;
attribute ContactField[] ims;
attribute ContactOriganization[] organizations;
attribute Date birthday;
attribute String note;
attribute ContactField[] photos;
attribute ContactField[] categories;
attribute ContactField[] urls;
function Contact clone();
function void remove( successCB, errorCB );
function void save( successCB, errorCB );
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
联系人对象，包括联系人的各种信息，如名称、电话号码、地址等。也包括新增、删除联系人的操作方法。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.id">id</a>: 联系人的id</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.displayName">displayName</a>: 联系人显示的名字</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.name">name</a>: 联系人的名称</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.nickname">nickname</a>: 联系人的昵称</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.phoneNumbers">phoneNumbers</a>: 数组，联系人的电话</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.emails">emails</a>: 数组，联系人的邮箱</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.addresses">addresses</a>: 数组，联系人的地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.ims">ims</a>: 数组，联系人的即时通讯地址</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.organizations">organizations</a>: 数组，联系人所属组织信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.birthday">birthday</a>: 联系人的生日</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.note">note</a>: 联系人的备注</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.photos">photos</a>: 数组，联系人的头像</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.categories">categories</a>: 数组，联系人的组名</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.urls">urls</a>: 数组，联系人的网址</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.clone">clone</a>: 克隆联系人</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.remove">remove</a>: 删除联系人</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.Contact.save">save</a>: 保存联系人</li></ul>
<h1 style="margin-left:0;">id</h1>
联系人的id
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性可选属性
联系人id由系统分配维护，从系统获取联系人时自动赋值，再次查询时可使用此id值进行检索。注意：此值为只读属性，改写此值可能会导致无法预期的错误。
<h1 style="margin-left:0;">displayName</h1>
联系人显示的名字
<h2 style="margin-left:.8em;">说明：</h2>
String 类型可选属性
联系人显示的名字通常由其姓和名组合而成。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 如果name（ContactName）的givenName未设置，则会保存到givenName值中。 </li><li>iOS - 5.1+ (支持) : 此属性为只读属性，修改此属性后无法保存，必须通过修改name（ContactName）的familyName、givenName、middleName值后保存。 </li></ul>
<h1 style="margin-left:0;">name</h1>
联系人的名称
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactName">ContactName</a> 类型
<h1 style="margin-left:0;">nickname</h1>
联系人的昵称
<h2 style="margin-left:.8em;">说明：</h2>
String 类型可选属性
<h1 style="margin-left:0;">phoneNumbers</h1>
数组，联系人的电话
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a> 类型可选属性
如果联系人中未保存电话信息，则返回空数组。
<h1 style="margin-left:0;">emails</h1>
数组，联系人的邮箱
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a> 类型可选属性
如果联系人中未保存邮箱信息，则返回空数组。
<h1 style="margin-left:0;">addresses</h1>
数组，联系人的地址
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactAddress">ContactAddress</a> 类型可选属性
如果联系人中未保存地址信息，则返回空数组。
<h1 style="margin-left:0;">ims</h1>
数组，联系人的即时通讯地址
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a> 类型可选属性
如果联系人中未保存即时通讯地址信息，则返回空数组。
<h1 style="margin-left:0;">organizations</h1>
数组，联系人所属组织信息
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactOrganization">ContactOrganization</a> 类型可选属性
如果联系人中未保存所属组织信息，则返回空数组。
<h1 style="margin-left:0;">birthday</h1>
联系人的生日
<h2 style="margin-left:.8em;">说明：</h2>
Date 类型可选属性
<h1 style="margin-left:0;">note</h1>
联系人的备注
<h2 style="margin-left:.8em;">说明：</h2>
String 类型可选属性
<h1 style="margin-left:0;">photos</h1>
数组，联系人的头像
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a> 类型可选属性
其值为头像图片url地址或图片数据： url地址：仅支持本地图片地址，可以是绝对路径或相对路径，如“_doc/a.png”； 图片数据：必须符合Data URI scheme（RFC2397）格式的数据，如“image/png;base64,XXXX”，其中XXXX为base64编码的图片数据。在获取联系人时默认返回此类型的数据。
<h1 style="margin-left:0;">categories</h1>
数组，联系人的组名
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactField">ContactField</a> 类型可选属性
如果联系人中未保存组名信息，则返回空数组。
<h1 style="margin-left:0;">urls</h1>
数组，联系人的网址
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactField">ContactField</a> 类型可选属性
如果联系人中未保存网址信息，则返回空数组。
<h1 style="margin-left:0;">clone</h1>
克隆联系人
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Contact contact.clone();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
克隆联系人，创建出一个新的联系人对象。
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.Contact">Contact</a> : 克隆出的Contact对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var newcnt = contact.clone();
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">remove</h1>
删除联系人
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void contact.remove( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsSuccessCallback">ContactsSuccessCallback</a> ) 必选 删除联系人操作成功回调 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a> ) 可选 删除联系人操作失败回调 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.contacts.getAddressBook( plus.contacts.ADDRESSBOOK_PHONE, function( addressbook ) {
// 可通过addressbook进行通讯录操作
var contact = addressbook.find( null, function ( contacts ) {
if ( contacts.length> 0 ) {
var dc = contacts[0];
dc.remove( function () {
alert( "Remove "+dc.displayName+" success!" );
}
}, function ( e ) {
alert( "Find contact error: " e.message );
}, {filter:[{logic:"or",field:"phoneNumbers",value:"88888888"}],multi:false} );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">save</h1>
保存联系人
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void contact.save( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将联系人数据保存到通讯录中，操作成功将通过successCB回调函数返回保存结果，操作失败将通过通过errorCB回调函数返回错误信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactsSuccessCallback">ContactsSuccessCallback</a> ) 必选 添加联系人操作成功回调 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactsErrorCallback">ContactsErrorCallback</a> ) 可选 添加联系人操作失败回调 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.contacts.getAddressBook( plus.contacts.ADDRESSBOOK_PHONE, function( addressbook ) {
// 可通过addressbook进行通讯录操作
var contact = addressbook.create();
contact.name = {givenName:"王安"};
contact.phoneNumbers = [{type:"手机",value:"88888888",preferred:true}];
contact.save( function () {
alert( "保存联系人成功" );
}, function ( e ) {
alert( "保存联系人失败：" + e.message );
} );
}, function ( e ) {
alert( "Get address book failed: " + e.message );
} );
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">ContactField</h1>
JSON对象，联系人域数据对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactField {
attribute String type;
attribute String value;
attribute Boolean preferred;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
联系人域数据对象，保存联系人特定域信息。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>type: (String 类型 )联系人域类型，如电话号码中的“mobile”、“home”、“company”</li><li>value: (String 类型 )联系人域值</li><li>preferred: (Boolean 类型 )是否为首选项</li></ul>
<h1 style="margin-left:0;">ContactName</h1>
JSON对象，联系人名称对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactName {
attribute String formatted;
attribute String familyName;
attribute String givenName;
attribute String middleName;
attribute String honorificPrefix;
attribute String honorificSuffix;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
联系人名称对象，保存联系人名称信息，如姓、名等。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>formatted: (String 类型 )联系人的完整名称，由其它字段组合生成</li><li>familyName: (String 类型 )联系人的姓</li><li>givenName: (String 类型 )联系人的名</li><li>middleName: (String 类型 )联系人的中间名</li><li>honorificPrefix: (String 类型 )联系人的前缀（如Mr.或Dr.）</li><li>honorificSuffix: (String 类型 )联系人的后缀</li></ul>
<h1 style="margin-left:0;">ContactAddress</h1>
JSON对象，联系人地址对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactAddress {
attribute String type;
attribute String formatted;
attribute String streetAddress;
attribute String locality;
attribute String region;
attribute String country;
attribute String postalCode;
attribute Boolean preferred;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
联系人地址对象，保存联系人地址信息，如国家、省份、城市等。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>type: (String 类型 )联系人地址类型，如“home”表示家庭地址、“company”表示单位地址</li><li>formatted: (String 类型 )完整地址，由其它字段组合而成</li><li>streetAddress: (String 类型 )完整的街道地址</li><li>locality: (String 类型 )城市或地区</li><li>region: (String 类型 )省或地区</li><li>country: (String 类型 )国家</li><li>postalCode: (String 类型 )邮政编码</li><li>preferred: (Boolean 类型 )是否为首选项</li></ul>
<h1 style="margin-left:0;">ContactOrganization</h1>
JSON对象，联系人所属组织信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactOrganization {
attribute String type;
attribute String name;
attribute String department;
attribute String title;
attribute Boolean preferred;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>type: (String 类型 )联系人所属组织类型，如"company"</li><li>name: (String 类型 ) 联系人所属组织名称</li><li>department: (String 类型 )联系人所属组织部门</li><li>title: (String 类型 )联系人在组织中的职位</li><li>preferred: (Boolean 类型 )是否为首选项</li></ul>
<h1 style="margin-left:0;">ContactFindOption</h1>
JSON对象，查找联系人参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactFindOption {
attribute ContactFindFilte[] filter;
attribute Boolean multiple;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>filter: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122684848#plus.contacts.ContactFindFilter">ContactFindFilter</a> 类型 )数组，查找时的过滤器 可设置为空，表示不过滤。 </li><li>multiple: (Boolean 类型 )是否查找多个联系人，默认值为true</li></ul>
<h1 style="margin-left:0;">ContactFindFilter</h1>
JSON对象，联系人查找过滤器
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface ContactFindFilter {
attribute String logic;
attribute String field;
attribute String value;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>logic: (String 类型 )区配的逻辑 可取“and”、“or”、“not”，默认值为“and”。 </li><li>field: (String 类型 )区配的联系人域，可取联系人的属性名称</li><li>value: (String 类型 )区配的联系人值，可使用区配符号“?”和“*”</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 区配所有包括姓或名中包括“王”的联系人
[{logic:"or",field:"displayNam",value:"*王*"},{logic:"or",field:"nickname",value:"*王*"}]
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AddressBookSuccessCallback</h1>
获取通讯录操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( addressbook ){
// Code AddressBook here
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>addressbook: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.AddressBook">AddressBook</a> ) 必选 获取到的通讯录对象 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">FindSuccessCallback</h1>
查找联系人操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( contacts ){
// Find contact success.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>contacts: ( <ahref="https://www.html5plus.org/doc/zh_cn/contacts.html#plus.contacts.Contact">Contact</a> ) 必选 数组，查找到的联系人对象 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">ContactsSuccessCallback</h1>
联系人操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(){
// Operate success
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">ContactsErrorCallback</h1>
联系人操作失败回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError( error ){
// Handle the error
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 联系人操作的错误信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作 ...