Face 서비스에 사용자를 추가하기 위한 React Native 앱 빌드
이 가이드에서는 샘플 Face 등록 애플리케이션을 시작하는 방법을 설명합니다. 이 앱은 사용자를 얼굴 인식 서비스에 추가하고 고품질의 얼굴 데이터를 얻기 위해 의미 있는 동의를 얻는 모범 사례를 보여 줍니다. 통합 시스템은 이와 같은 앱을 사용하여 얼굴 데이터를 기반으로 비접촉 액세스 제어, ID 확인, 참석 추적 또는 개인 설정 키오스크를 제공할 수 있습니다.
사용자가 앱을 시작하면 자세한 동의 화면이 표시됩니다. 사용자가 동의하면 앱은 사용자 이름 및 암호를 묻는 메시지를 표시한 다음, 디바이스의 카메라를 사용하여 고화질 얼굴 이미지를 캡처합니다.
샘플 앱은 JavaScript 및 React Native 프레임워크를 사용하여 작성되었습니다. 이 앱은 Android 및 iOS 디바이스에 배포할 수 있습니다.
필수 조건
- Azure 구독 – 체험 구독 만들기
- Azure 구독을 보유한 후에는 Azure Portal에서 Face 리소스를 만들어 키와 엔드포인트를 가져옵니다. 배포 후 리소스로 이동을 선택합니다.
- 애플리케이션을 Face API에 연결하려면 생성한 리소스의 키와 엔드포인트가 필요합니다.
Important
보안 고려 사항
- 로컬 개발 및 초기 제한된 테스트의 경우 환경 변수를 사용하여 API 키와 엔드포인트를 보유하는 것이 좋습니다(모범 사례는 아님). 파일럿 및 최종 배포의 경우 API 키를 안전하게 저장해야 합니다. 여기에는 중간 서비스를 사용하여 로그인 중에 생성된 사용자 토큰의 유효성을 검사하는 작업이 포함될 수 있습니다.
- API 키 또는 엔드포인트를 코드에 저장하거나 버전 제어 시스템(예: Git)에 커밋하지 마십시오. 실수로 발생하는 경우 새 API 키/엔드포인트를 즉시 생성하고 이전 API 키/엔드포인트를 철회해야 합니다.
- 모범 사례로 개발 및 프로덕션을 위해 별도의 API 키를 두는 것이 좋습니다.
개발 환경 설정
샘플 앱에 대한 git 리포지토리를 복제합니다.
개발 환경을 설정하려면 React Native 설명서를 따릅니다. React Native CLI 빠른 시작을 선택합니다. 개발 OS 및 Android를 대상 OS로 선택합니다. 종속성 설치 및 Android 개발 환경 섹션을 완료합니다.
Visual Studio Code와 같은 원하는 텍스트 편집기를 다운로드합니다.
리소스의 개요 탭에 있는 Azure Portal에서 FaceAPI 엔드포인트 및 키를 검색할 수 있습니다. Face API 키를 원격 리포지토리에 체크 인하지 마십시오.
Warning
로컬 개발 및 테스트의 경우에만 API 키와 엔드포인트를 환경 변수로 입력할 수 있습니다. 최종 배포의 경우 API 키를 안전한 위치에 저장하고 코드 또는 환경 변수에는 저장하지 않습니다. 서비스를 인증하는 다른 방법은 Azure AI 서비스 인증 가이드를 참조하세요.
Android Studio의 Android 가상 디바이스 에뮬레이터나 사용자의 Android 디바이스를 사용하여 앱을 실행합니다. 물리적 디바이스에서 앱을 테스트하려면 관련 React Native 설명서를 따릅니다.
사용자의 비즈니스에 맞게 앱 사용자 지정
이제 샘플 앱을 설정했으므로 사용자의 요구에 맞게 조정할 수 있습니다.
예를 들어 동의 페이지에서 상황에 맞는 정보를 추가하려고 할 수 있습니다.
확인 정확도를 개선하기 위해 더 많은 지침을 추가합니다.
대부분의 얼굴 인식 문제는 품질이 낮은 참조 이미지 때문에 발생합니다. 모델 성능을 저하시킬 수 있는 몇 가지 요소는 다음과 같습니다.
- 얼굴 크기(카메라에서 멀리 떨어진 얼굴)
- 얼굴 방향(카메라에서 얼굴이 돌아갔거나 기울어짐)
- 이미지의 노출이 부족하거나 노이즈가 너무 많은 조명이 부족한 조건(적은 빛 또는 역광)
- 모자나 테가 두꺼운 안경과 같은 액세서리를 포함한 얼굴 가림(부분적으로 숨겨지거나 가려진 얼굴)
- 흐린 얼굴(예: 사진을 찍은 때 빠르게 움직인 얼굴)
이 서비스는 이미지의 품질이 고객을 추가하거나 얼굴 인식을 시도하기 위해 위의 요인에 따라 이미지가 충분한 품질인지 여부를 선택하는 데 도움이 되는 이미지 품질 검사를 제공합니다. 이 앱은 디바이스의 카메라에서 프레임에 액세스하고, 품질을 감지하고, 사용자에게 사용자 인터페이스 메시지를 표시하여 더 높은 품질의 이미지를 캡처하고, 최고 품질의 프레임을 선택하고, 감지된 얼굴을 Face API 서비스에 추가하는 방법을 보여 줍니다.
샘플 앱은 사용자 정보를 삭제하는 기능과 읽기 옵션을 제공합니다. 비즈니스 요구 사항에 따라 이러한 작업을 사용하거나 사용하지 않도록 설정할 수 있습니다.
전체 환경을 포함하도록 앱 기능을 확장하려면 구현할 수 있는 추가 기능과 모범 사례에 대한 개요를 참조하세요.
각 사람을 ID로 매핑하도록 데이터베이스 구성
사용자 메타데이터와 함께 얼굴 이미지를 저장하려면 데이터베이스를 사용해야 합니다. 사회 보장 번호 또는 기타 고유한 개인 식별자를 키로 사용하여 얼굴 ID를 조회할 수 있습니다.
구독 키와 엔드포인트를 Face 서비스에 전달하는 안전한 방법은 Azure AI 서비스 보안 가이드를 참조하세요.
앱 배포하기
먼저 앱이 프로덕션을 배포할 준비가 되었는지 확인합니다. 앱 코드에서 키 또는 비밀을 제거하고 보안 모범 사례를 따르고 있는지 확인합니다.
프로덕션용 앱을 릴리스할 준비가 되면 Android 앱용 패키지 파일 형식인 릴리스 가능 APK 파일을 생성합니다. 이 APK 파일은 프라이빗 키로 서명해야 합니다. 이 릴리스 빌드를 사용하여 디바이스에 직접 앱을 배포할 수 있습니다.
프라이빗 키를 생성하고, 애플리케이션에 서명하고, 릴리스 APK를 생성하는 방법을 알아보려면 릴리스 준비 설명서를 따릅니다.
서명된 APK를 만든 후 앱 릴리스 방법에 대해 자세히 알아보려면 앱 게시 설명서를 참조하세요.
다음 단계
이 가이드에서는 개발 환경을 설정하고 샘플 앱을 시작하는 방법을 배웠습니다. React Native에 익숙하지 않은 경우 시작하기 Docs를 참조하여 자세한 배경 정보를 확인할 수 있습니다. 또한 Face API를 익히는 데도 도움이 될 것입니다. 개발을 시작하기 전에 사용자 추가의 다른 섹션을 읽어 보세요.