게임 서버가 여러 개일 경우 선택한 게임 서버 정보를 반드시 Hive에 설정해야 합니다. 유저가 게임 서버를 선택해야 하는 경우, 서버 점검 팝업 노출 전에 UI를 구현하고, Configuration 클래스의 setServerId() 메서드를 호출하여 Hive 설정을 변경해 주세요.

게임 서버가 설정된 이후에는 게임에서 원하는 시점에 서버 점검 팝업을 노출할 수 있습니다. Hive One 메뉴를 통해 서버 점검 팝업을 설정하고 점검 시간 동안 게임 접속을 차단합니다. 노출되는 팝업은 Hive SDK에서 제공하는 UI를 이용하거나 Hive에서 제공하는 정보만 수신하여 UI를 커스터마이징할 수 있습니다.

팝업 내용 설정하기

서버 점검 정보, 강제 업데이트 정보, 공지 정보는 Hive One에서 설정하세요. 설정하는 방법에 대한 자세한 내용은 운영 > 프로비저닝 가이드를 참고하세요.

팝업 띄우기

Hive는 서버 점검/게임 강제 업데이트/공지 팝업을 직접 띄우기도 하고, 여러분이 팝업을 구성하여 띄울 수 있도록 팝업에 들어갈 내용을 반환하기도 합니다. Hive가 팝업을 띄우면, 팝업은 Hive UI 스타일로 나타나지만, 여러분이 직접 팝업을 띄우면 원하는 스타일로 팝업을 띄울 수 있습니다. Hive 팝업 이용 여부에 따라 아래와 같이 파라미터를 설정하여 Auth 클래스의 checkMaintenance() 메서드를 호출하세요.

  • Hive가 제공하는 팝업 이용하기: isShow 파라미터를 true로 설정하세요.
  • 직접 구성한 팝업을 제공하기 위해 팝업 정보 요청하기: isShow 파라미터를 false로 설정하세요. 팝업 정보에 대한 자세한 내용은 Hive가 반환하는 팝업 정보 섹션에 있습니다.
  • 서버 점검 팝업 예시 화면

  • 업데이트 팝업 예시 화면

다음은 Hive가 제공하는 UI로 서버 점검이나 강제 업데이트 알림을 띄우는 예제 코드입니다.

Unity®

API Reference: hive.Auth.checkMaintenance

C++

API Reference: Auth::checkMaintenance

Kotlin

API Reference: com.hive.Auth.checkMaintenance

Java

API Reference: com.hive.Auth.checkMaintenance

Swift

API Reference: HIVEAuth:checkMaintenance

Objective-C

API Reference: HIVEAuth:checkMaintenance

Hive가 반환하는 팝업 정보

Hive는 checkMaintenance() 메서드를 통해 Hive One에 설정된 팝업 정보를 요청 받으면, 다음의 표에 정리된 값들을 AuthMaintenanceInfo 오브젝트에 담아 반환합니다.

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

  • OPEN_URL: 외부 브라우저로 웹페이지 띄우기
  • EXIT: 팝업 닫기
  • DONE: 아무 처리 하지 않기
AuthV4MaintenanceActionType 열거형
url 외부 브라우저로 띄울 URL. action 필드 값이 OPEN_URL일 때 유효함 String
remainingTime 개발자가 원하는 대로 사용 가능한 값. 단위: 초

Integer