유저 정보 확인

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

유저 프로필 확인

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

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

유저 제재 상태 확인

로그인 및 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

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. Boolean isShow = false; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, (ResultAPI result, List<AuthV4.MaintenanceInfo> maintenanceInfo)=>{ if (!result.isSuccess()) { // 제재 여부 확인 요청 실패 } else { if(maintenanceInfo != null){ // 제재 유저인 경우 } else{ // 일반 유저인 경우 } } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. Boolean isShow = false;     // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, (ResultAPI result, List<AuthV4.MaintenanceInfo> maintenanceInfo)=>{     if (!result.isSuccess()) {         // 제재 여부 확인 요청 실패     } else {         if(maintenanceInfo != null){             // 제재 유저인 경우         } else{             // 일반 유저인 경우         }     } });

  C++

  API Reference: AuthV4::checkBlacklist

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. bool isShow = false; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4::checkBlacklist(isShow, [=](ResultAPI const & result,std::vector<AuthV4MaintenanceInfo> const & maintenanceInfolist){ if(!result.isSuccess) { // 제재 여부 확인 요청 실패 } else { if(maintenanceInfolist != null){ // 제재 유저인 경우 } else { // 일반 유저인 경우 } } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. bool isShow = false;     // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4::checkBlacklist(isShow,  [=](ResultAPI const & result,std::vector<AuthV4MaintenanceInfo> const & maintenanceInfolist){     if(!result.isSuccess) {         // 제재 여부 확인 요청 실패     } else {         if(maintenanceInfolist != null){             // 제재 유저인 경우         } else {             // 일반 유저인 경우         }     } });

  Android

  API Reference: com.hive.AuthV4.checkBlacklist

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. boolean isShow = false; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, new AuthV4.AuthV4MaintenanceListener() { @Override public void onAuthV4Maintenance(ResultAPI result, ArrayList<AuthV4.AuthV4MaintenanceInfo> maintenanceInfo) { if (!result.isSuccess()) { // 제재 여부 확인 요청 실패 } else { if (maintenanceInfo != null) { // 제재 유저인 경우 } else { // 일반 유저인 경우 } } } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

  // isShow 값이 false 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. boolean isShow = false;     // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, new AuthV4.AuthV4MaintenanceListener() {     @Override     public void onAuthV4Maintenance(ResultAPI result, ArrayList<AuthV4.AuthV4MaintenanceInfo> maintenanceInfo) {         if (!result.isSuccess()) {             // 제재 여부 확인 요청 실패         } else {             if (maintenanceInfo != null) {                 // 제재 유저인 경우             } else {                 // 일반 유저인 경우             }         }     } });

  iOS

  API Reference: HIVEAuthV4:checkBlacklist

  // isShow 값이 NO 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. BOOL isShow = NO; // Hive SDK AuthV4 제재 유저 확인 요청 [HIVEAuthV4 checkBlacklist:isShow handler:^(HIVEResultAPI *result, NSArray<HIVEAuthV4MaintenanceInfo *> *maintenanceInfolist) { if (!result.isSuccess){ // 제재 여부 확인 요청 실패 } else { if(maintenanceInfolist != nil){ // 제재 유저인 경우 } else { // 일반 유저인 경우 } } }];

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

  // isShow 값이 NO 이면 게임에서 제재 유저 팝업을 띄우기 위한 데이터를 반환한다. BOOL isShow = NO;   // Hive SDK AuthV4 제재 유저 확인 요청 [HIVEAuthV4 checkBlacklist:isShow handler:^(HIVEResultAPI *result, NSArray<HIVEAuthV4MaintenanceInfo *> *maintenanceInfolist) {     if (!result.isSuccess){         // 제재 여부 확인 요청 실패     } else {         if(maintenanceInfolist != nil){             // 제재 유저인 경우         } else {             // 일반 유저인 경우         }     } }];

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

  Unity®

  API Reference: hive.AuthV4.checkBlacklist

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. Boolean isShow = true; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, (ResultAPI result, List<AuthV4.MaintenanceInfo> maintenanceInfo)=>{ if (result.isSuccess()) { // 일반 유저인경우 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요. // 예) Application.Quit(); } });

  1 2 3 4 5 6 7 8 9 10 11 12 13

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. Boolean isShow = true;      // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, (ResultAPI result, List<AuthV4.MaintenanceInfo> maintenanceInfo)=>{     if (result.isSuccess()) {         // 일반 유저인경우     }     else if (result.needExit()) {         // TODO: 앱 종료 기능을 구현하세요.         // 예) Application.Quit();     } });

  C++

  API Reference: AuthV4::checkBlacklist

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. bool isShow = true; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4::checkBlacklist(isShow, [=](ResultAPI const & result,std::vector<AuthV4MaintenanceInfo> const & maintenanceInfolist){ if (result.isSuccess()) { // 일반 유저인경우 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요. // Cocos2d-x 엔진 사용자 // 예) exit(0); // Unreal 엔진 사용자 // 예) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false); } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. bool isShow = true;      // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4::checkBlacklist(isShow,  [=](ResultAPI const & result,std::vector<AuthV4MaintenanceInfo> const & maintenanceInfolist){     if (result.isSuccess()) {         // 일반 유저인경우     }     else if (result.needExit()) {         // TODO: 앱 종료 기능을 구현하세요.         // Cocos2d-x 엔진 사용자         // 예) exit(0);         // Unreal 엔진 사용자         // 예) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);     } });

  Kotlin

  API Reference: com.hive.AuthV4.checkBlacklist

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. val isShow = true // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, object : AuthV4.AuthV4MaintenanceListener { override fun onAuthV4Maintenance( result: ResultAPI, maintenanceInfo: ArrayList<AuthV4.AuthV4MaintenanceInfo>? ) { if (result.isSuccess) { // 일반 유저인경우 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요. // 예) exitProcess(0) } } })

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. val isShow = true      // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, object : AuthV4.AuthV4MaintenanceListener {     override fun onAuthV4Maintenance(         result: ResultAPI,         maintenanceInfo: ArrayList<AuthV4.AuthV4MaintenanceInfo>?     ) {         if (result.isSuccess) {             // 일반 유저인경우         } else if (result.needExit()) {             // TODO: 앱 종료 기능을 구현하세요.             // 예) exitProcess(0)         }     } })

  Java

  API Reference: com.hive.AuthV4.checkBlacklist

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. boolean isShow = true; // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, new AuthV4.AuthV4MaintenanceListener() { @Override public void onAuthV4Maintenance(ResultAPI result, ArrayList<AuthV4.AuthV4MaintenanceInfo> maintenanceInfo) { if (result.isSuccess()) { // 일반 유저인경우 } else if (result.needExit()) { // TODO: 앱 종료 기능을 구현하세요. // 예) System.exit(0); } } });

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. boolean isShow = true;      // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4.checkBlacklist(isShow, new AuthV4.AuthV4MaintenanceListener() {     @Override     public void onAuthV4Maintenance(ResultAPI result, ArrayList<AuthV4.AuthV4MaintenanceInfo> maintenanceInfo) {         if (result.isSuccess()) {             // 일반 유저인경우         }         else if (result.needExit()) {             // TODO: 앱 종료 기능을 구현하세요.             // 예) System.exit(0);         }     } });

  Swift

  API Reference: HIVEAuthV4:checkBlacklist

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. let isShow = true // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4Interface.checkBlacklist(isShow) { (result, maintenanceInfolist) in if result.isSuccess() { // 일반 유저인경우 } else if result.needExit() { // TODO: 앱 종료 기능을 구현하세요. // 예) exit(0) } }

  1 2 3 4 5 6 7 8 9 10 11 12 13

  // isShow 값이 true 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. let isShow = true // Hive SDK AuthV4 제재 유저 확인 요청 AuthV4Interface.checkBlacklist(isShow) { (result, maintenanceInfolist) in     if result.isSuccess() {         // 일반 유저인경우     }     else if result.needExit() {         // TODO: 앱 종료 기능을 구현하세요.         // 예) exit(0)     } }

  Obj-C

  API Reference: HIVEAuthV4:checkBlacklist

  // isShow 값이 YES 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. BOOL isShow = YES; // Hive SDK AuthV4 제재 유저 확인 요청 [HIVEAuthV4 checkBlacklist:isShow handler:^(HIVEResultAPI *result, NSArray<HIVEAuthV4MaintenanceInfo *> *maintenanceInfolist) { if (result.isSuccess) { // 일반 유저인경우 } else if (result.needExit) { // TODO: 앱 종료 기능을 구현하세요. // 예) exit(0); } }];

  1 2 3 4 5 6 7 8 9 10 11 12 13

  // isShow 값이 YES 이면 Hive SDK 내부에서 제재 유저 팝업을 띄운다. BOOL isShow = YES;    // Hive SDK AuthV4 제재 유저 확인 요청 [HIVEAuthV4 checkBlacklist:isShow handler:^(HIVEResultAPI *result, NSArray<HIVEAuthV4MaintenanceInfo *> *maintenanceInfolist) {     if (result.isSuccess) {         // 일반 유저인경우     }     else if (result.needExit) {         // TODO: 앱 종료 기능을 구현하세요.         // 예) exit(0);             } }];

유저 이메일 정보 활용

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

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