聯(lián)系人

說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 7開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import contact from '@ohos.contact';

contact.addContact

addContact(contact:Contact, callback:AsyncCallback): void

添加聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.addContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, (err, data) = > {
    if (err) {
        console.log(`addContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`addContact callback: success data- >${JSON.stringify(data)}`);
});

contact.addContact

addContact(contact: Contact): Promise

添加聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.addContact({
    name: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
});
promise.then((data) = > {
    console.log(`addContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`addContact fail: err- >${JSON.stringify(err)}`);
});

contact.deleteContact

deleteContact(key: string, callback: AsyncCallback): void

刪除聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.deleteContact('xxx', (err) = > {
    if (err) {
        console.log(`deleteContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log('deleteContact success');
});

contact.deleteContact

deleteContact(key: string): Promise

刪除聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.deleteContact('xxx');
promise.then(() = > {
    console.log(`deleteContact success`);
}).catch((err) = > {
    console.error(`deleteContact fail: err- >${JSON.stringify(err)}`);
});

contact.updateContact

updateContact(contact: Contact, callback: AsyncCallback): void

更新聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.updateContact({
    name: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, (err) = > {
    if (err) {
        console.log('updateContact callback: err- >${JSON.stringify(err)}');
        return;
    }
    console.log('updateContact success');
});

contact.updateContact

updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback): void

更新聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.updateContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
},{
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
}, (err) = > {
    if (err) {
        console.log('updateContact callback: err- >${JSON.stringify(err)}');
        return;
    }
    console.log('updateContact success');
});

contact.updateContact

updateContact(contact: Contact, attrs?: ContactAttributes): Promise

更新聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.WRITE_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.updateContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then(() = > {
    console.log('updateContact success');
}).catch((err) = > {
    console.error(`updateContact fail: err- >${JSON.stringify(err)}`);
});

contact.isLocalContact

isLocalContact(id: number, callback: AsyncCallback): void

判斷當(dāng)前聯(lián)系人id是否在電話簿中，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.isLocalContact(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`isLocalContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`isLocalContact callback: success data- >${JSON.stringify(data)}`);
});

contact.isLocalContact

isLocalContact(id: number): Promise

判斷當(dāng)前聯(lián)系人id是否在電話簿中，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.isLocalContact(/*id*/1);
promise.then((data) = > {
    console.log(`isLocalContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`isLocalContact fail: err- >${JSON.stringify(err)}`);
});

contact.isMyCard

isMyCard(id: number, callback: AsyncCallback): void

判斷是否為“我的名片”，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.isMyCard(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`isMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`isMyCard callback: success data- >${JSON.stringify(data)}`);
});

contact.isMyCard

isMyCard(id: number): Promise

判斷是否為“我的名片”，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.isMyCard(/*id*/1);
promise.then((data) = > {
    console.log(`isMyCard success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`isMyCard fail: err- >${JSON.stringify(err)}`);
});

contact.queryMyCard

queryMyCard(callback: AsyncCallback): void

查詢“我的名片”，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryMyCard((err, data) = > {
    if (err) {
        console.log(`queryMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryMyCard callback: success data- >${JSON.stringify(data)}`);
});

contact.queryMyCard

queryMyCard(attrs: ContactAttributes, callback: AsyncCallback): void

查詢“我的名片”，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryMyCard({
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
}, (err, data) = > {
    if (err) {
        console.log(`queryMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryMyCard callback: success data- >${JSON.stringify(data)}`);
});

contact.queryMyCard

queryMyCard(attrs?: ContactAttributes): Promise

查詢“我的名片”，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryMyCard({
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
});
promise.then((data) = > {
    console.log(`queryMyCard success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryMyCard fail: err- >${JSON.stringify(err)}`);
});

contact.selectContact

selectContact(callback: AsyncCallback>): void

選擇聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.Contacts、SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.selectContact((err, data) = > {
    if (err) {
        console.log(`selectContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`selectContact callback: success data- >${JSON.stringify(data)}`);
});

contact.selectContact

selectContact(): Promise>

選擇聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.Contacts、SystemCapability.Applications.ContactsData

返回值：

示例：

let promise = contact.selectContact();
promise.then((data) = > {
    console.log(`selectContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`selectContact fail: err- >${JSON.stringify(err)}`);
});

contact.queryContact

queryContact(key: string, callback: AsyncCallback): void

根據(jù)key查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContact('xxx', (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContact

queryContact(key: string, holder: Holder, callback: AsyncCallback): void

根據(jù)key查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContact('xxx', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContact

queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback): void

根據(jù)key查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContact('xxx', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContact

queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback): void

根據(jù)key查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContact('xxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContact

queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise

根據(jù)key查詢聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryContact('xxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContact fail: err- >${JSON.stringify(err)}`);
});

contact.queryContacts

queryContacts(callback: AsyncCallback>): void

查詢所有聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContacts((err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContacts

queryContacts(holder: Holder, callback: AsyncCallback>): void

查詢所有聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContacts({
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContacts

queryContacts(attrs: ContactAttributes, callback: AsyncCallback>): void

查詢所有聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContacts({
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContacts

queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

查詢所有聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContacts({
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContacts

queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise>

查詢所有聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryContacts({
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContacts success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContacts fail: err- >${JSON.stringify(err)}`);
});

ontact.queryContactsByPhoneNumber

queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback>): void

根據(jù)電話號(hào)碼查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByPhoneNumber('138xxxxxxxx', (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByPhoneNumber

queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback>): void

根據(jù)電話號(hào)碼查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByPhoneNumber

queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback>): void

根據(jù)電話號(hào)碼查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByPhoneNumber

queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

根據(jù)電話號(hào)碼查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByPhoneNumber

queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise>

根據(jù)電話號(hào)碼查詢聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContactsByPhoneNumber success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContactsByPhoneNumber fail: err- >${JSON.stringify(err)}`);
});

contact.queryContactsByEmail

queryContactsByEmail(email: string, callback: AsyncCallback>): void

根據(jù)email查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByEmail('xxx@email.com', (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByEmail

queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback>): void

根據(jù)email查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByEmail

queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback>): void

根據(jù)email查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByEmail('xxx@email.com', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByEmail

queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

根據(jù)email查詢聯(lián)系人，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

contact.queryContactsByEmail

queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise>

根據(jù)email查詢聯(lián)系人，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContactsByEmail success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContactsByEmail fail: err- >${JSON.stringify(err)}`);
});

contact.queryGroups

queryGroups(callback: AsyncCallback>): void

查詢聯(lián)系人的所有群組，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryGroups((err, data) = > {
    if (err) {
        console.log(`queryGroups callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryGroups callback: success data- >${JSON.stringify(data)}`);
});

contact.queryGroups

queryGroups(holder: Holder, callback: AsyncCallback>): void

查詢聯(lián)系人的所有群組，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryGroups({
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryGroups callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryGroups callback: success data- >${JSON.stringify(data)}`);
});

contact.queryGroups

queryGroups(holder?: Holder): Promise>

查詢聯(lián)系人的所有群組，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryGroups({
    holderId: 0
});
promise.then((data) = > {
    console.log(`queryGroups success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryGroups fail: err- >${JSON.stringify(err)}`);
});

contact.queryHolders

queryHolders(callback: AsyncCallback>): void

查詢所有創(chuàng)建聯(lián)系人的應(yīng)用信息，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryHolders((err, data) = > {
    if (err) {
        console.log(`queryHolders callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryHolders callback: success data- >${JSON.stringify(data)}`);
});

contact.queryHolders

queryHolders(): Promise>

查詢所有創(chuàng)建聯(lián)系人的應(yīng)用信息，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

返回值：

示例：

let promise = contact.queryHolders();
promise.then((data) = > {
    console.log(`queryHolders success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryHolders fail: err- >${JSON.stringify(err)}`);
});

contact.queryKey

queryKey(id: number, callback: AsyncCallback): void

根據(jù)聯(lián)系人的id查詢聯(lián)系人的key，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryKey(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`queryKey callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryKey callback: success data- >${JSON.stringify(data)}`);
});

contact.queryKey

queryKey(id: number, holder: Holder, callback: AsyncCallback): void

根據(jù)聯(lián)系人的id查詢聯(lián)系人的key，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

示例：

contact.queryKey(id, {
    holderId:1
}, (err, data) = > {
    if (err) {
        console.log(`queryKey callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryKey callback: success data- >${JSON.stringify(data)}`);
});

contact.queryKey

queryKey(id: number, holder?: Holder): Promise

根據(jù)聯(lián)系人的id查詢聯(lián)系人的key，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.READ_CONTACTS

系統(tǒng)能力 ：SystemCapability.Applications.ContactsData

參數(shù)：

返回值：

示例：

let promise = contact.queryKey(id, {
    holderId: 0
});
promise.then((data) = > {
    console.log(`queryKey success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryKey fail: err- >${JSON.stringify(err)}`);
});

Contact

聯(lián)系人對(duì)象類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建聯(lián)系人數(shù)據(jù)：

let myContact = {
    phoneNumbers: [{
        phoneNumber: "138xxxxxxxx"
    }],
    name: {
        fullName: "fullName",
        namePrefix: "namePrefix"
    },
    nickName: {
        nickName: "nickName"
    }
};

或使用new一個(gè)Contact對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let myContact = new contact.Contact();
let name = new contact.Name();
name.fullName = "fullName";
let phoneNumber = new contact.PhoneNumber();
phoneNumber.phoneNumber = "138xxxxxxxx";
myContact.name = name;
myContact.phoneNumbers = [phoneNumber];

ContactAttributes

聯(lián)系人屬性列表，一般作為入?yún)⒂脕?lái)標(biāo)識(shí)希望查詢的聯(lián)系人屬性。 當(dāng)傳入為null時(shí)，默認(rèn)查詢?nèi)繉傩浴?/p>

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let contactAttributes = {
    attributes: [
        contact.Attribute.ATTR_EMAIL,
        contact.Attribute.ATTR_NAME,
        contact.Attribute.ATTR_PHONE
    ]
};

或使用new一個(gè)ContactAttributes對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let contactAttributes = new contact.ContactAttributes();
contactAttributes.attributes = ["ATTR_EMAIL"];

Attribute

枚舉，聯(lián)系人屬性列表。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let attributes = [contact.Attribute.ATTR_EMAIL, contact.Attribute.ATTR_NAME, contact.Attribute.ATTR_PHONE];

Email

聯(lián)系人的郵箱。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let email = {
    email: "xxx@email.com",
    displayName: "displayName"
}

或使用new一個(gè)Email對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let email = new contact.Email();
email.email = "xxx@email.com";

Holder

創(chuàng)建聯(lián)系人的應(yīng)用信息類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let holder = {
  holderId: 0
};

或使用new一個(gè)Holder對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let holder = new contact.Holder();
holder.holderId = 0;

Event

聯(lián)系人事件類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let event = {
    eventDate: "xxxxxx"
};

或使用new一個(gè)Event對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let event = new contact.Event();
event.eventDate = "xxxxxx";

Group

聯(lián)系人的群組類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let group = {
    groupId: 1,
    title: "title"
};

或使用new一個(gè)Group對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let group = new contact.Group();
group.title = "title";

ImAddress

聯(lián)系人的即時(shí)消息地址。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let imAddress = {
    imAddress: "imAddress",
    labelName: "labelName"
};

或使用new一個(gè)ImAddress對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let imAddress = new contact.ImAddress();
imAddress.imAddress = "imAddress";

Name

聯(lián)系人的名字類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let name = {
    familyName: "familyName",
    fullName: "fullName"
};

或使用new一個(gè)name對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let name = new contact.Name();
name.familyName = "familyName";
name.fullName = "fullName";

NickName

聯(lián)系人的昵稱類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let nickName = {
    nickName: "nickName"
};

或使用new一個(gè)NickName對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let nickName = new contact.NickName();
nickName.nickName = "nickName";

Note

聯(lián)系人的備注類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let note = {
    noteContent: "noteContent"
};

或使用new一個(gè)Note對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let note = new contact.Note();
note.noteContent = "noteContent";

Organization

聯(lián)系人的組織類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let organization = {
    name: "name",
    title: "title"
};

或使用new一個(gè)Organization對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let organization = new contact.Organization();
organization.name = "name";
organization.title = "title";

PhoneNumber

聯(lián)系人電話號(hào)碼類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let phoneNumber = {
    phoneNumber: "138xxxxxxxx",
    labelId: contact.PhoneNumber.NUM_HOME
};

或使用new一個(gè)PhoneNumber對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let phoneNumber = new contact.PhoneNumber();
phoneNumber.phoneNumber = "138xxxxxxxx";

Portrait

聯(lián)系人的頭像類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let portrait = {
    uri: "uri"
};

或使用new一個(gè)Portrait對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let portrait = new contact.Portrait();
portrait.uri = "uri";

PostalAddress

聯(lián)系人的郵政地址類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let postalAddress = {
    city: "city"
};

或使用new一個(gè)PostalAddress對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let postalAddress = new contact.PostalAddress();
postalAddress.city = "city";

Relation

聯(lián)系人的關(guān)系類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let relation = {
    relationName: "relationName",
    labelId: contact.Relation.RELATION_ASSISTANT
};

或使用new一個(gè)Relation對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let relation = new contact.Relation();
relation.relationName = "relationName";
relation.labelId = contact.Relation.RELATION_ASSISTANT;

SipAddress

聯(lián)系人的會(huì)話發(fā)起協(xié)議（SIP）地址類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

常量

屬性

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

var sipAddress = {
    sipAddress: "sipAddress"
};

或使用new一個(gè)SipAddress對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let sipAddress = new contact.SipAddress();
sipAddress.sipAddress = "sipAddress";

Website

聯(lián)系人的網(wǎng)站信息類。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Applications.ContactsData。

對(duì)象創(chuàng)建示例：

使用JSON格式創(chuàng)建數(shù)據(jù)：

let website = {
    website: "website"
};

或使用new一個(gè)Website對(duì)象的方式創(chuàng)建數(shù)據(jù)：

let website = new contact.Website();
website.website = "website";

審核編輯 黃宇