啟動 People 應用程式
本主題描述 ms-people: 的 URI 協定。 您的 WinUI、UWP 和其他 Windows 傳統型應用程式可以使用此 URI 配置來啟動人員應用程式以進行特定動作。
ms-people： URI 配置參考
| 結果 | URI 架構 |
|---|---|
| 允許其他應用程式啟動 [人員] 應用程式主頁。 | ms-people： |
| 允許其他應用程式啟動 [人員應用程式設定] 頁面。 | ms-people：settings |
| 允許其他應用程式提供搜尋字串，將啟動 People 應用程式並顯示搜尋結果頁面。
參數會區分大小寫。 如果您未正確輸入語法，或遺漏搜尋字串值，預設行為是傳回聯繫人的完整清單，而不需要任何篩選。 |
ms-people：search？SearchString=<contactsearchinfo> |
| 如果找到連絡人，就會開啟現有的連絡人卡片。 或者，如果找不到聯繫人，則會開啟暫時聯繫人卡片。 如果未提供任何輸入參數，我們會使用聯繫人清單啟動人員應用程式。
參數會區分大小寫。 參數的順序並不重要。 如果有一個以上的相符項目，我們會返回聯繫人的第一個相符項目。 |
ms-people：viewcontact？ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber= <phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj> |
| 啟動至 [人員] 應用程式內的 [儲存聯繫人] 頁面，以使用提供的電話號碼或電子郵件位址儲存指定的聯繫人。
參數會區分大小寫。 參數的順序並不重要。 |
ms-people：savetocontact？PhoneNumber= <phonenum>&Email=<email>&ContactName=<name> |
| 啟動至 [人員] 應用程式內的 [新增聯繫人] 頁面，以儲存指定的聯繫人。
使用 LaunchUriForResultsAsync 開啟儲存新的聯繫人頁面。 使用 LaunchUriAsync 只會啟動 People 應用程式主頁。 參數會區分大小寫。 參數的順序並不重要。 您可以使用任何支援參數的組合。 |
zh-TW: ms-people：savecontacttask？電話號碼= <phonenum>&電子郵件=<email>&聯絡人名稱=<name> |
ms-people：search：參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| 搜尋字串 | 自選。 聯絡人搜尋資訊的搜尋字串。 電話號碼或聯繫人名稱。 |
ms-people：search？SearchString=Smith |
ms-people：viewcontact： 參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| ContactId | 自選。 聯絡人的ID。 |
ms-people：viewcontact？ContactId={ContactId} |
| 電話號碼 | 自選。 聯繫人的電話號碼。 |
ms-people：viewcontact？PhoneNumber=%2014257069326 |
| 電子郵件 | 自選。 聯繫人的電子郵件。 |
ms-people：viewcontact？Email=johnsmith@contsco.com |
| ContactName | 自選。 聯繫人的名稱。 |
ms-people：viewcontact？ContactName=John%20%Smith |
| 聯繫人 | 自選。 聯絡對象。 |
ms-people：viewcontact？Contact={Serialized Contact} |
ms-people：savetocontact： 參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| 電話號碼 | 自選。 聯繫人的電話號碼。 |
ms-people：savetocontact？PhoneNumber=%2014257069326 |
| 電子郵件 | 自選。 聯繫人的電子郵件。 |
ms-people：savetocontact？Email=johnsmith@contsco.com |
| ContactName | 自選。 聯繫人的名稱。 |
ms-people：savetocontact？Email=johnsmith@contsco.com&ContactName= John%20%Smith |
ms-people：savecontacttask：參數參考
| 參數 | 描述 |
|---|---|
| 公司 | 自選。 聯繫人的公司名稱。 |
| 名字 | 自選。 連絡人的名字。 |
| HomeAddressCity | 自選。 住家位址的城市。 |
| 住址國家 | 自選。 住家地址的國家/地區。 |
| HomeAddressState | 自選。 住家地址的狀態。 |
| HomeAddressStreet | 自選。 住址的街道。 |
| 住址郵遞區號 | 自選。 住家地址的郵遞區編碼。 |
| 家用電話 | 自選。 聯繫人的家庭電話。 |
| 職稱 | 自選。 聯繫人的職稱。 |
| LastName | 自選。 聯繫人的姓氏。 |
| 中間名 | 自選。 聯繫人的中間名。 |
| 手機 | 自選。 聯繫人的行動電話號碼。 |
| 暱稱 | 自選。 聯繫人的昵稱。 |
| 附注 | 自選。 聯繫人的相關注意事項。 |
| OtherEmail | 自選。 聯繫人的其他電子郵件。 |
| PersonalEmail | 自選。 聯繫人的個人電子郵件。 |
| 後置詞 | 自選。 聯繫人的後綴。 |
| 標題 | 自選。 聯繫人的標題。 |
| 網站 | 自選。 聯繫人的網站。 |
| WorkAddressCity | 自選。 工作位址的城市。 |
| WorkAddressCountry | 自選。 工作地址的國家/地區。 |
| WorkAddressState | 自選。 工作地址的狀態。 |
| WorkAddressStreet | 自選。 工作位址的街道。 |
| WorkAddressZipCode | 自選。 工作地址的郵遞區編碼。 |
| 工作電子郵件 | 自選。 連絡人的工作電子郵件。 |
| 工作電話 | 自選。 聯繫人的工作電話號碼。 |
