게스트 로그인 활용 가이드
게스트 로그인을 앱에 구현하려면 Hive 콘솔 설정, Hive Axyl SDK 호출, 레시피 코드 호출, 앱 코드를 모두 조합해야 합니다. 레시피 코드를 사용하면 로그인에 필요한 Hive Axyl SDK 호출이 메서드 하나로 줄어듭니다.
구현 범위
게스트 로그인을 구현하는 데 필요한 작업은 Hive 콘솔에서 게스트 로그인을 활성화하는 것에서 시작해, 로그인 결과에 맞는 화면을 띄우는 것으로 끝납니다.
각 단계의 작업은 아래 네 가지 구분 중 하나에 해당합니다.
| 구분 | 담당 | 내용 |
|---|---|---|
| Hive 콘솔 | 앱 운영자 | Hive 콘솔에서 수행하는 설정입니다. |
| Hive Axyl SDK | 앱 개발자 | 앱에서 호출하는 Hive Axyl SDK 메서드입니다. |
| 레시피 코드 | 앱 개발자 | 앱에서 호출하는 레시피 메서드입니다. |
| 앱 코드 | 앱 개발자 | Hive Axyl을 거치지 않고 앱이 직접 구현하는 부분입니다. |
게스트 로그인에는 스토어 플러그인 호출과 Hive Axyl 서버 API 호출이 없습니다. 파라미터의 의미와 응답 필드는 각 단계에서 연결한 상세 절차를 참조하세요.
레시피
Hive Axyl SDK는 게스트 로그인 기능을 세분화된 메서드로 제공합니다. 계정을 만드는 메서드, 기존 계정으로 로그인하는 메서드, 토큰을 발급하는 메서드, 세션을 활성화하는 메서드가 각각 따로 있습니다. 사용자 한 명을 로그인시키는 데에도 호출 순서와 중간 실패 처리를 앱이 직접 조합해야 합니다.
레시피는 그 조합을 미리 완성해 둔 소스 코드입니다. 패키지가 아니라 프로젝트에 복사해서 사용합니다.
| 구분 | 위치 | 성격 |
|---|---|---|
| Hive Axyl SDK | Unity 패키지 com.com2usplatform.hiveaxyl.* | 설치해서 사용합니다. 인증 기능을 세분화된 메서드로 제공합니다. |
| 레시피 | Assets/Recipes/GuestLogin/ | 복사해서 사용합니다. SDK 호출을 목적 단위로 묶은 순수 C# 코드입니다. |
| 사용 예제 | Assets/RecipeExamples/Authentication/GuestLoginExample.cs | 읽고 참고하는 코드입니다. 레시피 호출 순서와 결과별로 앱이 구현해야 할 부분을 주석으로 설명합니다. |
레시피는 복사해서 사용하는 코드입니다
레시피는 앱에 복사되어 앱의 코드가 됩니다. 그대로 사용해도 되고 앱 정책에 맞게 수정해서 사용해도 됩니다.
게스트 계정 생성에 추가 보안을 적용한 앱은 이 레시피를 그대로 사용할 수 없습니다. GuestLoginRecipe가 사전 승인 값인 GrantKey를 입력받지 않기 때문입니다. 이 경우에는 Hive Axyl SDK 메서드를 직접 호출해 게스트 계정 생성과 게스트 로그인을 구현하세요.
앱이 직접 구현하는 부분
레시피는 로그인 호출만 대신합니다. 아래 항목은 레시피 밖에서 앱이 구현합니다.
- 로그인 화면과 로그인 후 화면 전환
DeviceKey와 게스트 자격 증명의 저장, 재사용, 삭제- 실패했을 때의 재시도 정책과 사용자 안내 메시지
공통 사전 준비
구현을 시작하기 전에 아래 항목을 먼저 준비하세요.
| 준비 항목 | 필수 여부 | 구분 | 확인할 곳 |
|---|---|---|---|
| 프로젝트 생성 | 필수 | Hive 콘솔 | 프로젝트 생성 |
| App ID 생성 | 필수 | Hive 콘솔 | App ID 생성 |
| Unity 프로젝트에 SDK 연결 | 필수 | Hive Axyl SDK | Unity 프로젝트에 SDK 연결 |
App ID는 SDK를 초기화할 때 입력하는 값이므로 먼저 생성해야 합니다. SDK를 연결해 두어야 이어지는 단계에서 인증 모듈을 설치합니다.
다음 단계
사전 준비를 마쳤다면 게스트 로그인 구현하기를 시작하세요.