인증 v1은 Hive SDK 초기화부터 Hive 로그인까지 일련의 과정을 담당합니다.

게임이 실행되면 여러분은 유저의 회원 가입유무와 관계 없이 반드시 유저를 Hive 서버로 로그인 시켜야 합니다. 유저를 Hive 서버로 로그인 시킬 때 로그인 타입을 명시해야 합니다. Hive가 제공하는 로그인 타입은 다음과 같이 네 종류입니다.

  • GUEST
  • ACCOUNT
  • SELECT
  • AUTO

유저를 어떤 타입으로 로그인 시켜야 할지는 Hive가 알려 줍니다. Hive 클라이언트는 초기화 과정에서 기기고유번호인 DID를 발급하고 해당 DID에서의 로그인 기록을 바탕으로 유저에게 가능한 로그인 타입이 무엇인지 알려 줍니다.

Hive에서 이용하는 식별자 알아보기

Hive에서는 유저와 단말기를 구별하기 위해 다음의 식별자를 사용합니다.

  • 단말기 식별자: DID
  • 유저 식별자
    • VID: 게임 내에서 고유한 유저 ID입니다. 유저는 설치한 게임마다 다른 VID를 받게 됩니다.
    • UID: Hive 플랫폼 내에서 고유한 유저 ID입니다. 게스트는 UID를 발급 받지 못합니다.

DID란?

DID란 Hive 플랫폼이 발급하는 기기고유번호입니다.어떤 단말에서 Hive가 탑재된 게임이 최초로 이용될 때, Hive 클라이언트는 Hive 서버에 그 단말기 정보를 기록하고 DID를 발급하게 됩니다. DID는 기기의 광고 식별자(iOS의 IDFA, Android의 Advertising ID)를 매칭한 키로 유저가 게임 앱을 설치하고 삭제 전까지는 유지되나 삭제 후 재 설치 시 기기의 광고 식별자가 변경되었다면 DID도 변경될 수 있습니다.

로그인 타입이란?

게임이 실행되면서 Hive가 단말기 인증을 수행한 후, Hive 계정 유무와 상관 없이 유저는 Hive 서버에 로그인 되어야 합니다. 여러분이 유저를 Hive 서버에 로그인 시킬 때 어떤 상태로 로그인 하는지(즉, 로그인 타입)에 대한 정보를 명시해야 합니다.

로그인 타입을 알 수 있는 방법은 다음과 같이 두 가지가 있습니다.

  • Hive 클라이언트 초기화의 결과 값으로 로그인 타입 확인하기 – Hive 클라이언트는 초기화 단계에서 단말기 인증을 수행한 후, 유저가 어떤 방법으로 Hive 서버에 로그인될 수 있는지를 로그인 타입 값으로 알려줍니다. 로그인 타입 값은 초기화 함수의 콜백 함수를 통해 게임에게 반환하는 AuthInitResult 오브젝트의 loginType 필드에 담깁니다.
  • Hive API 호출로 로그인 타입 조회하기 – Hive 클라이언트 초기화 후에도 Hive API 중 Auth API를 이용하여 로그인 타입을 확인할 수 있습니다. 자세한 내용을 보려면 로그인 타입 조회하기를 읽어 보세요.