cordova - 如何使用电话间隙将新联系人添加到联系人中？

Question

我是电话间隙的新手。有人请告诉我如何使用电话间隙向联系人添加新联系人吗？

谢谢

Answer 1

要访问联系人，您需要使用PhoneGap的联系人插件。

要将此插件添加到项目中，我们需要做的是:

cordova plugin add org.apache.cordova.contacts

要配置特定于平台的配置设置，我们需要添加以下代码:

对于安卓:在app/res/xml/config.xml中:

<feature name="Contacts">
    <param name="android-package" value="org.apache.cordova.contacts.ContactManager" />
</feature>

在app/AndroidManifest.xml中:

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />

对于 iOS:在 config.xml 中:

<feature name="Contacts">
    <param name="ios-package" value="CDVContacts" />
</feature>

对于 Windows Phone: 在属性/WPAppManifest.xml 中:

<Capabilities>
    <Capability Name="ID_CAP_CONTACTS" />
</Capabilities>

最后通过 JavaScript 添加联系人:

var myContact = navigator.contacts.create({"displayName": "The New Contact"});
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
myContact.name = name;

var phoneNumbers = [];
phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
myContact.phoneNumbers = phoneNumbers;

myContact.note = "Example note for the newly added contact";

myContact.save(onSuccessCallBack, onErrorCallBack);

function onSuccessCallBack(contact) {
    alert("Save Success");
};

function onErrorCallBack(contactError) {
    alert("Error = " + contactError.code);
};

联系人的属性:

• id:全局唯一标识符。 (DOMString)
  
• displayName:此联系人的姓名，适合向最终用户显示。 (DOM字符串)
• name:包含人名所有组成部分的对象。 (联系人姓名)
• 昵称:用来称呼联系人的随意名称。 (DOM字符串)
• phoneNumbers:所有联系人电话号码的数组。 (联系字段[])
• emails:所有联系人的电子邮件地址的数组。 (联系字段[])
• addresses:所有联系人地址的数组。 (联系地址[])
• ims:所有联系人的 IM 地址的数组。 (联系字段[])
• 组织:所有联系人组织的数组。 (联系组织[])
• 生日:联系人的生日。 (日期)
• 注释:有关联系人的注释。 (DOM字符串)
• 照片:联系人照片的数组。 (联系字段[])
• categories:与联系人关联的所有用户定义类别的数组。 (联系字段[])
• urls:与联系人关联的网页数组。 (联系字段[])

了解更多信息PhoneGap API Documentation - Contacts