ユーザープロファイル

[アーティクル]
04/25/2024

Android では API レベル 5 以降、ContactsContract プロバイダーを使用した連絡先の列挙がサポートされています。たとえば、連絡先の一覧表示は次のコード例に示すように、ContactContracts.Contacts クラスを使用するのと同じくらい簡単です。

// Get the URI for the user's contacts:
var uri = ContactsContract.Contacts.ContentUri;

// Setup the "projection" (columns we want) for only the ID and display name:
string[] projection = {
    ContactsContract.Contacts.InterfaceConsts.Id,
    ContactsContract.Contacts.InterfaceConsts.DisplayName };

// Use a CursorLoader to retrieve the user's contacts data:
CursorLoader loader = new CursorLoader(this, uri, projection, null, null, null);
ICursor cursor = (ICursor)loader.LoadInBackground();

// Print the contact data to the console if reading back succeeds:
if (cursor != null)
{
    if (cursor.MoveToFirst())
    {
        do
        {
            Console.WriteLine("Contact ID: {0}, Contact Name: {1}",
                               cursor.GetString(cursor.GetColumnIndex(projection[0])),
                               cursor.GetString(cursor.GetColumnIndex(projection[1])));
        } while (cursor.MoveToNext());
    }
}

Android 4 (API レベル 14) 以降、ContactsContact.Profile クラスは ContactsContract プロバイダーを通じて使用できます。 ContactsContact.Profile は、デバイス所有者の個人プロファイルへのアクセスを提供します。これには、デバイス所有者の名前や電話番号などの連絡先データが含まれます。

必要なアクセス許可

連絡先データの読み取りと書き込みを行うには、アプリケーションが READ_CONTACTS と WRITE_CONTACTS のアクセス許可をそれぞれ要求する必要があります。さらに、ユーザープロファイルの読み取りと編集を行うには、アプリケーションが READ_PROFILE と WRITE_PROFILE のアクセス許可を要求する必要があります。

プロファイルデータの更新

これらのアクセス許可が設定されると、アプリケーションは通常の Android 手法を使用してユーザープロファイルのデータを操作できます。たとえば、プロファイルの表示名を更新するには次に示すように、ContactsContract.Profile.ContentRawContactsUri プロパティを使用して取得した Uri を使用して ContentResolver.Update を呼び出します。

var values = new ContentValues ();
values.Put (ContactsContract.Contacts.InterfaceConsts.DisplayName, "John Doe");

// Update the user profile with the name "John Doe":
ContentResolver.Update (ContactsContract.Profile.ContentRawContactsUri, values, null, null);

プロファイルデータの読み取り

ContactsContact.Profile.ContentUri にクエリを発行すると、プロファイルデータを読み取ります。たとえば、次のコードはユーザープロファイルの表示名を読み取ります。

// Read the profile
var uri = ContactsContract.Profile.ContentUri;

// Setup the "projection" (column we want) for only the display name:
string[] projection = {
    ContactsContract.Contacts.InterfaceConsts.DisplayName };

// Use a CursorLoader to retrieve the data:
CursorLoader loader = new CursorLoader(this, uri, projection, null, null, null);
ICursor cursor = (ICursor)loader.LoadInBackground();
if (cursor != null)
{
    if (cursor.MoveToFirst ())
    {
        Console.WriteLine(cursor.GetString (cursor.GetColumnIndex (projection [0])));
    }
}