로그인이 완료되었다면 로그인된 유저의 프로필 정보 및 이용 정지 정보를 확인할 수 있습니다.

유저 프로필 확인

Hive 로그인을 완료하였다면 AuthV4 클래스getProfile() 메서드를 이용하여 유저의 프로필 정보를 가져올 수 있습니다. 프로필 정보에는 playerId, 외부에 보여질 유저의 닉네임인 playerName, 유저의 섬네일 이미지인 playerImageUrl을 포함하고 있습니다.

다음은 유저의 프로필 정보를 획득하는 예제 코드입니다.

Unity®

API Reference: hive.AuthV4.getProfile

C++

API Reference: AuthV4::getProfile

Kotlin

API Reference: AuthV4.getProfile

Java

API Reference: com.hive.AuthV4.getProfile

Swift

API Reference: AuthV4Interface.getProfile

Objective-C

API Reference: HIVEAuthV4:getProfile

이용 정지 상태 확인

로그인 및 IdP 연동 시에는 Hive에서 유저 이용 정지 여부를 자동으로 확인하고 게임을 진행하지 못하도록 처리합니다. 그 외 게임 진행 중 이용 정지 상태를 확인해야 하는 경우에는 checkBlacklist() 메서드를 이용, 게임에서 유저의 이용 정지 상태를 실시간으로 확인하고 게임을 진행하지 못하도록 처리해야 합니다. checkBlacklist() 호출 시 isShow 파라미터 값에 따라 Hive는 이용 정지 팝업을 직접 띄우기도 하고, 혹은 여러분이 이용 정지 팝업을 구성하여 띄울 수 있도록 팝업에 채울 내용을 반환하기도 합니다.

    • Hive가 제공하는 이용 정지 팝업 이용하기: isShow 파라미터를 true로 설정하세요.
    • 이용 정지 팝업 커스터마이징 하기: isShow 파라미터를 false로 설정하세요. 이용 정지 팝업 정보에 대한 자세한 내용은 하단의 Hive가 반환하는 이용 정지 팝업 정보를 참고하세요.

이용 정지 팝업 예시 스크린샷 입니다.

Hive가 반환하는 이용 정지 팝업 정보

checkBlacklist()의 결과가 성공 시 다음의 표에 정리된 값들을 AuthV4MaintenanceInfo 오브젝트에 담아 반환합니다.

필드명 설명 타입
title 팝업 제목 String
message 팝업 내용 String
button 팝업 버튼의 라벨 문구 String
action 팝업 버튼을 눌렀을 때 어떤 동작을 할 것인지 의미

  • OPEN_URL: 외부 브라우저로 전달된 URL을 실행
  • EXIT: 앱 종료
  • DONE: 아무 처리 하지 않고 이용 정지 팝업 종료
AuthV4MaintenanceActionType 열거형
url 외부 브라우저로 띄울 URL. action 필드 값이 OPEN_URL일 때 유효함 String
remainingTime 이용 정지까지 남은 초단위 시간. 시간은 실시간 갱신되며 0초가 되면 앱이 종료됨 Integer

다음은 이용 정지 유저를 확인하는 예제 코드입니다.

  • Hive UI를 사용하지 않을 경우 (isShow = false)
    Unity®

    API Reference: hive.AuthV4.checkBlacklist

    C++

    API Reference: AuthV4::checkBlacklist

    Kotlin

    API Reference: AuthV4.checkBlacklist

    Java

    API Reference: com.hive.AuthV4.checkBlacklist

    Swift

    API Reference: AuthV4Interface.checkBlacklist

    Objective-C

    API Reference: HIVEAuthV4:checkBlacklist

  • Hive UI를 사용할 경우 (isShow = true)

    Unity®

    API Reference: hive.AuthV4.checkBlacklist

    C++

    API Reference: AuthV4::checkBlacklist

    Kotlin

    API Reference: com.hive.AuthV4.checkBlacklist

    Java

    API Reference: com.hive.AuthV4.checkBlacklist

    Swift

    API Reference: HIVEAuthV4:checkBlacklist

    Obj-C

    API Reference: HIVEAuthV4:checkBlacklist

유저 이메일 정보 활용

게임사가 로그인한 사용자 프로필 정보에 있는 이메일 정보를 수집하는 기능을 제공합니다. 이메일 정보를 수집하려면, Hive 콘솔에서 해당 기능을 활성화해야 합니다.

먼저, 아래의 Idp 리스트 중 ‘이메일 수집 가능 Idp’에서 이메일 수집 권한 승인을 받아야 합니다.

  • 이메일 수집 가능 IdP: Google, Facebook, Huawei (Android), Hive 멤버십, Apple (iOS)
  • 이메일 수집 불가 IdP: Google Play Games, Apple Game Center, QQ, VK, WeChat, Line, Weverse

명시적 로그인 API 호출 후 콜백으로 전달받는 PlayerInfo 클래스 인스턴스에서 providerInfoData에 접근하면 로그인한 유저 이메일 주소를 확인할 수 있습니다.

ProviderTypeproviderInfoData의 키 값으로 사용해 조회하면 ProviderInfo 정보를 확인할 수 있습니다. 자세한 내용은 아래 예제 코드를 참고하세요.

Unity®

API Reference: hive.AuthV4.showSignIn

C++

API Reference: AuthV4::showSignIn

Kotlin

API Reference: com.hive.AuthV4.showSignIn

Java

API Reference: com.hive.AuthV4.showSignIn

Swift

API Reference: HIVEAuthV4:showSignIn

Obj-C

API Reference: HIVEAuthV4:showSignIn