로그인 화면

사용자가 앱에 로그인할 때 사용할 로그인 수단을 고르는 화면입니다.

세로 화면과 가로 화면은 화면 리소스 하나가 함께 처리합니다.

세로 화면가로 화면

앱을 처음 실행했을 때나 로그아웃한 뒤처럼, 사용자가 아직 로그인하지 않은 상태에서 이 화면을 엽니다.

화면은 로그인 수단 버튼 목록과 닫기 버튼으로 구성되어 있습니다. 버튼으로 노출할 로그인 수단은 앱이 조회해서 화면에 전달합니다. 화면은 전달받은 목록만 순서대로 표시하므로, 어떤 버튼이 몇 개 보일지는 앱의 실행 환경, 스토어, Hive 콘솔의 로그인 설정, 사용자가 접속한 국가에 따라 달라집니다. 게스트를 제외한 각 버튼의 아이콘도 앱이 준비해 화면에 전달합니다. 로그인 수단별로 아이콘을 구하는 곳은 로그인 수단 아이콘을 참조하세요.

버튼을 선택한 다음의 로그인 처리는 레시피가 담당합니다. 게스트, 유저네임, 커스텀 계정 로그인은 로그인 수단마다 레시피가 따로 있습니다. Google, Apple, Google Play Games, Steam, X 로그인은 공통 레시피에 로그인 수단별 레시피를 더해 사용합니다. 사용자 흐름과 구현 절차는 앱에서 제공할 로그인 수단의 가이드를 참조하세요.

화면에 버튼 목록을 채우려면 아래 Hive Axyl SDK 기능과 Hive 콘솔 설정이 필요합니다.

지원하는 로그인 수단 조회: 화면에 노출할 로그인 수단 목록을 가져오는 방법과 조회에 실패했을 때의 처리
로그인 설정: 로그인 수단을 활성화하고 노출 순서를 정하는 콘솔 설정

위 기능을 구현할 때 앱에서 호출하는 Hive Axyl SDK 메서드입니다.

GetProviderListAsync(): 이 앱에서 사용할 수 있는 로그인 수단 목록을 조회하는 메서드

조회한 로그인 수단 목록과 준비한 아이콘을 화면에 전달해 버튼 목록을 만들고, 버튼을 선택했을 때 그 로그인 수단의 로그인이 실행되도록 연결합니다. 이 화면은 요청을 처리하는 동안에도 버튼을 잠그지 않습니다. 버튼이 여러 번 선택되는 것을 막아야 하면 앱에서 처리하세요. 화면을 닫는 방법은 화면 닫기를 참조하세요.

조회나 로그인에 실패했을 때 띄울 실패 안내 토스트는 여러 화면이 함께 쓰는 공용 위젯으로, 공용 폴더에 들어 있습니다. 화면 폴더를 복사할 때는 공용 폴더, 폰트 폴더, UIKit.asmdef 파일도 함께 복사하세요. 복사하는 방법과 복사한 뒤 앱 어셈블리 정의 파일에 추가할 내용은 화면 리소스 가져오기를 참조하세요.

Unity GitHub 저장소: 복사할 unity/UI-Kit/Login, unity/UI-Kit/Common, unity/UI-Kit/Fonts 폴더와 unity/UI-Kit/UIKit.asmdef 파일

로그인 화면

화면 예시

사용 상황

관련 레시피

필요한 SDK 기능

필요한 API

Unity 적용 안내