具有套件身份的應用程式可以在 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 體驗所需的相關資訊,以支持聯繫人功能。
儲存聯絡人時需要下列欄位:
FirstNameRemoteIdDisplayPicture
下列欄位為選用:
LastNamePhonesEmails
此代碼段示範如何儲存聯絡人:
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);
}
隱私與同意
只提供明確的聯絡方式
你的應用程式應該只貢獻使用者明確新增或授權的聯絡人。 絕不:
- 上傳整個通訊錄
- 未經使用者同意自動同步聯絡人
- 未經明確許可,分享公司目錄的聯絡資料
在 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();
}