管理联系人存储位置

应用可以允许用户创建和存储联系人。这些联系人通常可以保存在两个位置

云端账户：将联系人保存到与云服务（例如 Google Cloud）关联的账户中，以便同步和备份联系人。
本地账户：联系人可以本地存储在设备上。

用户可以在设备设置中设置他们偏好的存储位置。这个偏好位置称为默认账户，在创建联系人时使用。应用应该尊重这个偏好。本文档解释了如何处理不同的联系人存储位置，包括云端账户和本地账户，并实现管理用户偏好的最佳实践。本地账户指的是将联系人直接存储在设备上。

检索默认账户

要确定新联系人的默认账户，请使用 ContactsContract.RawContacts.DefaultAccount

调用 getDefaultAccountForNewContacts() 获取 ContactsContrast.RawContacts.DefaultAccount.DefaultAccountAndState 对象。此对象包含有关默认账户设置的信息。

Kotlin

import ContactsContrast.RawContacts
import ContactsContrast.RawContacts.DefaultAccount
import ContactsContrast.RawContacts.DefaultAccount.DefaultAccountAndState

val defaultAccountAndState: DefaultAccountAndState =
  DefaultAccount.getDefaultAccountForNewContacts(
      getContentResolver()
  )

Java

import ContactsContrast.RawContacts;
import ContactsContrast.RawContacts.DefaultAccount;
import ContactsContrast.RawContacts.DefaultAccount.DefaultAccountAndState;

DefaultAccountAndState defaultAccountAndState =
  DefaultAccount.getDefaultAccountForNewContacts(
    getContentResolver()
  );

DefaultAccountAndState 对象包含

状态：指示是否已设置默认账户，以及（如果已设置）该账户的类别（云端、本地或 SIM）。
账户：如果状态为 DEFAULT_ACCOUNT_STATE_CLOUD 或 DEFAULT_ACCOUNT_STATE_SIM，则提供具体的账户详细信息（名称和类型）。对于其他状态，包括 DEFAULT_ACCOUNT_STATE_LOCAL，它将为 null。

以下是解析 DefaultAccountAndState 对象的示例

Kotlin

// Retrieves the state of default account.
val defaultAccountState = defaultAccountAndState.state
var defaultAccountName: String? = null
var defaultAccountType: String? = null

when (defaultAccountState) {
    // Default account is set to a cloud or a SIM account.
    DefaultAccountState.DEFAULT_ACCOUNT_STATE_CLOUD,
    DefaultAccountState.DEFAULT_ACCOUNT_STATE_SIM -> {
        defaultAccountName = defaultAccountAndState.account?.name
        defaultAccountType = defaultAccountAndState.account?.type
    }
    // Default account is set to the local account on the device.
    DefaultAccountState.DEFAULT_ACCOUNT_STATE_LOCAL -> {
        defaultAccountName = RawContacts.getLocalAccountType()
        defaultAccountType = RawContacts.getLocalAccountName()
    }
    // Default account is not set.
    DefaultAccountState.DEFAULT_ACCOUNT_STATE_NOT_SET -> {
    }
}

Java

// Retrieves the state of default account.
var defaultAccountState = defaultAccountAndState.getState();
String defaultAccountName = null;
String defaultAccountType = null;

switch (defaultAccountState) {
  // Default account is set to a cloud or a SIM account.
  case DefaultAccountState.DEFAULT_ACCOUNT_STATE_CLOUD:
  case DefaultAccountState.DEFAULT_ACCOUNT_STATE_SIM:
    defaultAccountName = defaultAccountAndState.getAccount().name;
    defaultAccountType = defaultAccountAndState.getAccount().type;
    break;
  // Default account is set to the local account on the device.
  case  DefaultAccountState.DEFAULT_ACCOUNT_STATE_LOCAL:
    defaultAccountName = RawContacts.getLocalAccountType();
    defaultAccountType = RawContacts.getLocalAccountName();
    break;

  // Default account is not set.
  case DefaultAccountState.DEFAULT_ACCOUNT_STATE_NOT_SET:
    break;
}

创建不指定账户的联系人

如果已设置默认账户，您的应用通常在创建联系人时无需明确指定账户。系统会自动将新联系人保存到默认账户中。以下是如何创建不指定账户的联系人。

创建一个新的 ArrayList 包含 ContentProviderOperation 对象。此列表包含用于插入原始联系人及其相关数据的操作。

Kotlin

val ops = ArrayList<ContentProviderOperation>()

Java

ArrayList<ContentProviderOperation> ops =
        new ArrayList<ContentProviderOperation>();

创建一个新的 ContentProviderOperation 以插入原始联系人。由于您未指定账户，因此无需包含 ACCOUNT_TYPE 和 ACCOUNT_NAME。

Kotlin

val op = ContentProviderOperation.newInsert(
    ContactsContract.RawContacts.CONTENT_URI
)
ops.add(op.build())

Java

ContentProviderOperation.Builder op =
    ContentProviderOperation.newInsert(
        ContactsContract.RawContacts.CONTENT_URI
    );
ops.add(op.build());

向操作列表添加其他 ContentProviderOperation 对象，以包含联系人字段（如姓名、电话号码、电子邮件）。然后执行批量操作以创建联系人。

Kotlin

try {
    getContentResolver().applyBatch(
        ContactsContract.AUTHORITY, ops
    )
} catch (e: Exception) {
    // Handle exceptions
}

Java

try {
    getContentResolver().applyBatch(
        ContactsContract.AUTHORITY, ops
    );
} catch (Exception e) {
    // Handle exceptions
}

在云端账户中创建联系人

要在云端账户中创建联系人，请将原始联系人行插入到 ContactsContract.RawContacts 表中并指定云端账户。方法如下

创建一个新的 ArrayList 包含 ContentProviderOperation 对象。

Kotlin

val ops = ArrayList<ContentProviderOperation>()

Java

ArrayList<ContentProviderOperation> ops =
    new ArrayList<ContentProviderOperation>();

创建一个新的 ContentProviderOperation 以插入原始联系人。使用 withValue() 方法指定所选云端账户的账户类型和账户名称。

Kotlin

val op = ContentProviderOperation.newInsert(
    ContactsContract.RawContacts.CONTENT_URI
)
    .withValue(
        ContactsContract.RawContacts.ACCOUNT_TYPE,
        selectedAccount.type
    )
    .withValue(
        ContactsContract.RawContacts.ACCOUNT_NAME,
        selectedAccount.name
    )
ops.add(op.build())

Java

ContentProviderOperation.Builder op =
    ContentProviderOperation.newInsert(
        ContactsContract.RawContacts.CONTENT_URI
    )
        .withValue(
            ContactsContract.RawContacts.ACCOUNT_TYPE,
            selectedAccount.getType()
        )
        .withValue(
            ContactsContract.RawContacts.ACCOUNT_NAME,
            selectedAccount.getName()
        );
ops.add(op.build());

向操作列表添加其他 ContentProviderOperation 对象，以包含联系人字段，并执行批量操作以创建联系人。

在本地账户中创建联系人

要在本地账户中创建联系人，请在 ContactsContract.RawContacts 表中插入一个新的原始联系人行并指定本地账户的账户信息

创建一个新的 ArrayList 包含 ContentProviderOperation 对象。

Kotlin

val ops = ArrayList<ContentProviderOperation>()

Java

ArrayList<ContentProviderOperation> ops =
    new ArrayList<ContentProviderOperation>();

创建一个新的 ContentProviderOperation 以插入原始联系人。使用 ContactsContract.RawContacts.getLocalAccountName() 和 ContactsContract.RawContacts.getLocalAccountType() 指定本地账户的账户信息。

Kotlin

val op = ContentProviderOperation.newInsert(
    ContactsContract.RawContacts.CONTENT_URI
)
    .withValue(
        ContactsContract.RawContacts.ACCOUNT_TYPE,
        ContactsContract.RawContacts.getLocalAccountType()
    )
    .withValue(
        ContactsContract.RawContacts.ACCOUNT_NAME,
        ContactsContract.RawContacts.getLocalAccountName()
    )
ops.add(op.build())

Java

ContentProviderOperation.Builder op =
    ContentProviderOperation.newInsert(
        ContactsContract.RawContacts.CONTENT_URI
    )
        .withValue(
            ContactsContract.RawContacts.ACCOUNT_TYPE,
            ContactsContract.RawContacts.getLocalAccountType()
        )
        .withValue(
            ContactsContract.RawContacts.ACCOUNT_NAME,
            ContactsContract.RawContacts.getLocalAccountName()
        );
ops.add(op.build());

向操作列表添加其他 ContentProviderOperation 对象以包含联系人字段，并执行批量操作以创建联系人。

管理联系人存储位置 使用收藏集保持有序 根据您的偏好保存和分类内容。

检索默认账户

Kotlin

Java

Kotlin

Java

创建不指定账户的联系人

Kotlin

Java

Kotlin

Java

Kotlin

Java

在云端账户中创建联系人

Kotlin

Java

Kotlin

Java

在本地账户中创建联系人

Kotlin

Java

Kotlin

Java

管理联系人存储位置