建置 React Native 應用程式以將使用者新增至臉部服務
本指南將說明如何開始使用範例臉部註冊應用程式。 應用程式示範取得有意義的同意,以將使用者新增至臉部辨識服務並取得高品質臉部數據的最佳做法。 整合系統可以使用這類應用程式,根據臉部數據提供觸控式訪問控制、識別、出席追蹤或個人化 kiosk。
當使用者啟動應用程式時,會顯示詳細的同意畫面。 如果使用者同意,應用程式會提示他們輸入使用者名稱和密碼,然後使用裝置的相機擷取高品質的臉部影像。
範例應用程式是使用 JavaScript 和 React Native 架構撰寫。 它可以部署在 Android 和 iOS 裝置上。
必要條件
- Azure 訂用帳戶 – 免費建立一個訂用帳戶。
- 擁有 Azure 訂用帳戶之後,請在 Azure 入口網站 中建立臉部資源,以取得您的密鑰和端點。 部署之後,請選取 [移至資源]。
- 您需要從您建立的資源取得密鑰和端點,才能將應用程式連線到臉部 API。
重要
安全性考量
- 針對本機開發和初始有限測試,使用環境變數來保存 API 金鑰和端點是可接受的(雖然不是最佳做法)。 針對試驗和最終部署,API 密鑰應該安全地儲存-這可能涉及使用中繼服務來驗證登入期間產生的使用者令牌。
- 請勿將 API 金鑰或端點儲存在程式代碼中,或將它們認可至版本控制系統(例如 Git)。 如果發生這種情況,您應該立即產生新的 API 金鑰/端點,並撤銷先前的 API 金鑰/ 端點。
- 最佳做法是考慮針對開發和生產環境擁有個別的 API 金鑰。
設定開發環境
複製範例應用程式的 Git 存放庫。
若要設定開發環境,請遵循 React Native 檔 。 選取 [ React Native CLI 快速入門]。 選取您的開發 OS 和 Android 作為目標 OS。 完成安裝相依性和Android開發環境小節。
下載您慣用的文本編輯器,例如 Visual Studio Code。
在資源的 [概觀] 索引標籤下,擷取 Azure 入口網站 中的 FaceAPI 端點和密鑰。 請勿將臉部 API 金鑰簽入遠端存放庫。
警告
僅針對本機開發和測試,您可以輸入 API 金鑰和端點為環境變數。 針對最終部署,請將 API 金鑰儲存在安全的位置,且永遠不會儲存在程式碼或環境變數中。 如需驗證服務的其他方式,請參閱 Azure AI 服務驗證指南 。
使用 Android Studio 中的 Android 虛擬設備模擬器或您自己的 Android 裝置來執行應用程式。 若要在實體裝置上測試您的應用程式,請遵循相關的 React Native 檔案 。
為您的企業自訂應用程式
既然您已設定範例應用程式,您可以根據自己的需求量身打造。
例如,您可能會想要在同意頁面上新增特定情況資訊:
新增更多指示以改善驗證正確性。
許多臉部辨識問題都是由低質量參考影像所造成。 可能會降低模型效能的一些因素如下:
- 臉部大小(遠離相機的臉部)
- 臉部方向(臉部轉身或從相機傾斜)
- 光線狀況不佳(低光或反光)可能暴露不佳或雜訊過大
- 遮蔽(部分隱藏或阻礙的臉部),包括帽子或厚邊眼鏡等配件
- 模糊(如拍攝照片時快速臉部移動)。
服務提供影像品質檢查,協助您根據上述因素選擇影像是否有足夠的品質,以新增客戶或嘗試臉部辨識。 此應用程式示範如何從裝置的相機存取畫面、偵測品質,以及向使用者顯示使用者介面訊息,以協助他們擷取高品質的影像、選取品質最高的畫面格,並將偵測到的臉部新增至臉部 API 服務。
樣本應用程式提供刪除使用者資訊的功能,以及重新新增的選項。 您可以根據您的業務需求來啟用或停用這些作業。
若要擴充應用程式的功能以涵蓋完整體驗,請閱讀 其他功能的概觀 ,以實作和最佳做法。
設定您的資料庫以對應每位人員及其識別碼
您必須使用資料庫來儲存臉部影像以及使用者中繼資料。 社會安全號碼或其他唯一人員識別碼可用來作為金鑰來查閱其臉部識別碼。
如需將訂用帳戶金鑰和端點傳遞至臉部服務的安全方法,請參閱 Azure AI 服務安全性指南。
部署應用程式
首先,請確定您的應用程式已準備好進行生產環境部署:從應用程式程式代碼中移除任何密鑰或秘密,並確定您已遵循 安全性最佳做法。
當您準備好要發行應用程式以供生產環境使用時,會產生已發行的 APK 檔案,這是 Android 應用程式的套件檔案格式。 此 APK 檔案必須使用私鑰簽署。 透過此版本組建,您可以開始將應用程式直接散發至您的裝置。
請遵循準備發行檔,瞭解如何產生私鑰、簽署您的應用程式,以及產生發行 APK。
建立已簽署的 APK 之後,請參閱 發佈您的應用程式 檔,以深入瞭解如何發行您的應用程式。
下一步
在本指南中,您已瞭解如何設定開發環境,並開始使用範例應用程式。 如果您不熟悉 React Native,您可以閱讀其 入門檔 ,以深入瞭解背景資訊。 熟悉臉部 API 也很有説明。 開始開發之前,請先閱讀新增使用者的其他章節。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應