로그아웃 활용 가이드

로그아웃을 앱에 구현하려면 Hive Axyl SDK 호출, 레시피 코드 호출, 앱 코드를 조합해야 합니다. 레시피 코드를 사용하면 로그아웃 요청과 메모리 세션 정리가 메서드 하나로 줄어듭니다.

구현 범위

로그아웃을 구현하는 데 필요한 작업은 로그아웃 버튼을 연결하는 것에서 시작해, 기기에 저장한 자동 로그인 정보를 정리하고 로그인 화면으로 돌아가는 것으로 끝납니다.

각 단계의 작업은 아래 네 가지 구분 중 하나에 해당합니다.

구분	담당	내용
Hive 콘솔	앱 운영자	Hive 콘솔에서 수행하는 설정입니다.
Hive Axyl SDK	앱 개발자	앱에서 호출하는 Hive Axyl SDK 메서드입니다.
레시피 코드	앱 개발자	앱에서 호출하는 레시피 메서드입니다.
앱 코드	앱 개발자	Hive Axyl을 거치지 않고 앱이 직접 구현하는 부분입니다.

Hive 콘솔은 사전 준비에서만 쓰입니다. 로그아웃 기능 자체에는 별도의 콘솔 설정이 없고, 스토어 플러그인 호출과 Hive Axyl 서버 API 호출도 없습니다. 파라미터의 의미와 응답 필드는 각 단계에서 연결한 상세 절차를 참조하세요.

Hive Axyl SDK는 로그아웃 기능을 세분화된 메서드로 제공합니다. 서버에 로그아웃을 요청하는 메서드, 메모리 세션을 지우는 메서드, 기기에 저장한 토큰을 지우는 메서드가 각각 따로 있습니다. 어느 결과에서 무엇을 지워야 하는지도 앱이 직접 판단해야 합니다.

레시피는 그 조합을 미리 완성해 둔 소스 코드입니다. 패키지가 아니라 프로젝트에 복사해서 사용합니다.

구분	위치	성격
Hive Axyl SDK	Unity 패키지 `com.com2usplatform.hiveaxyl.*`	설치해서 사용합니다. 인증 기능을 세분화된 메서드로 제공합니다.
레시피	Assets/Recipes/Logout/	복사해서 사용합니다. SDK 호출을 목적 단위로 묶은 순수 C# 코드입니다.
사용 예제	Assets/RecipeExamples/Authentication/LogoutExample.cs	읽고 참고하는 코드입니다. 레시피 호출 순서와 결과별로 앱이 구현해야 할 부분을 주석으로 설명합니다.

레시피는 복사해서 사용하는 코드입니다

레시피는 앱에 복사되어 앱의 코드가 됩니다. 그대로 사용해도 되고 앱 정책에 맞게 수정해서 사용해도 됩니다.

레시피는 로그아웃 요청과 메모리 세션 정리까지만 대신합니다. 아래 항목은 레시피 밖에서 앱이 구현합니다.

구현을 시작하기 전에 아래 항목을 먼저 준비하세요.

준비 항목	필수 여부	구분	확인할 곳
프로젝트 생성	필수	Hive 콘솔	프로젝트 생성
App ID 생성	필수	Hive 콘솔	App ID 생성
Unity 프로젝트에 SDK 연결	필수	Hive Axyl SDK	Unity 프로젝트에 SDK 연결
로그인한 사용자	필수	레시피 코드	게스트 로그인 활용 가이드, 유저네임 로그인 활용 가이드

레시피는 활성 세션이 있을 때만 동작합니다. 로그인하지 않은 상태에서 호출하면 FailedPrecondition 오류로 실패하므로, 로그아웃 버튼은 로그인한 사용자에게만 표시하세요.

사전 준비를 마쳤다면 로그아웃 구현하기를 시작하세요.