將聯絡人新增到 Windows

具有套件身份的應用程式可以在 Windows 中儲存聯絡人。 這些聯絡人可以以建議的形式出現在連絡人小工具、Windows 搜尋和分享表單中。 本文說明如何建立使用者資料帳戶、儲存聯絡人,以及設定 Windows 體驗的存取權限。

為 People 契約建立 UserDataAccount

從建立用戶帳戶開始。 需要第三方應用程式來建立 UserDataAccount 並用 UserDisplayName 作為 "com.microsoft.peoplecontract"。

UserDataAccountStore udas =
    await UserDataAccountManager.RequestStoreAsync(UserDataAccountStoreAccessType.AppAccountsReadWrite);
UserDataAccount uda = await udas.CreateAccountAsync("com.microsoft.peoplecontract");

接下來,將 新增 "com.microsoft.windows.system" 至帳戶的 ExplictReadAccessPackageFamilyNames 清單。 這可提供第三方聯繫人對 Windows 體驗的限制存取。

uda.ExplictReadAccessPackageFamilyNames.Add("com.microsoft.windows.system");
await uda.SaveAsync();

儲存連絡人

儲存連絡人的第一個步驟是建立聯繫人清單。 若要這樣做,第三方應用程式必須在 Windows UserDataAccount 中建立 的新聯繫人清單。 應用程式可以選擇保留聯繫人清單的預設 OtherAppReadAccess 存取類型,同時將它設定為 None 可防止其他應用程式存取這些聯繫人。 請參閱 ContactListOtherAppReadAccess 列舉以獲得可用存取類型的完整清單。

ContactStore store = await ContactManager.RequestStoreAsync(ContactStoreAccessType.AppContactsReadWrite);
this.contactList = await store.CreateContactListAsync(contactListsName, uda.Id);
contactList.OtherAppReadAccess = ContactListOtherAppReadAccess.None;
await contactList.SaveAsync();

儲存聯繫人時,第三方應用程式必須包含所有 Windows 體驗所需的相關資訊,以支持聯繫人功能。

儲存聯絡人時需要下列欄位:

  • FirstName
  • RemoteId
  • DisplayPicture

下列欄位為選用:

  • LastName
  • Phones
  • Emails

此代碼段示範如何儲存聯絡人:

foreach (var appContact in AppContacts)
{
  var cont = new Contact
  {
    FirstName = appContact.FirstName,
    LastName = appContact.LastName,
    RemoteId = appContact.Id,
    SourceDisplayPicture = RandomAccessStreamReference.CreateFromUri(new Uri(appContact.ProfilePicPath)),
    Phones = { new ContactPhone { Number = appContact.Phone } }
  };

  await this.contactList.SaveContactAsync(cont);
}

Note

聯絡人DisplayName的 是使用 FirstName 和 LastName建構的 。 如果未提供姓氏, DisplayName 則會與名字所提供的字串相同。

只提供明確的聯絡方式

你的應用程式應該只貢獻使用者明確新增或授權的聯絡人。 絕不:

  • 上傳整個通訊錄
  • 未經使用者同意自動同步聯絡人
  • 未經明確許可,分享公司目錄的聯絡資料

在 Windows People 儲存聯絡人前,請先徵求許可:

private async Task<bool> RequestContactStoreAccessAsync()
{
    // Requesting a writable ContactStore prompts the user for consent.
    // Your app must declare the contacts capability in its manifest.
    ContactStore store = await ContactManager.RequestStoreAsync(
        ContactStoreAccessType.AppContactsReadWrite);
    return store != null;
}

尊重使用者隱私設定

讓使用者能夠:

  • 選擇要與 Windows 共享哪些聯絡人
  • 停用 Windows People 整合
  • 隨時從 Windows 刪除他們的聯絡人
// Provide a setting to disable sync
if (this.ShouldSyncContactsWithWindows)
{
    await SyncContactsAsync();
}
else
{
    // Clear contacts if the user disables sync
    await ClearWindowsContactsAsync();
}