서버 점검 & 강제 업데이트

공지·업데이트 팝업 (1.10.0+)

점검 및 공지 정보

서버 점검 및 공지·업데이트 정보를 요청한다.

C2SModuleSocial_Initialize 의 showNotice 가 false면 특정 시점에서 서버 점검 팝업과 강제 업데이트를 노출할 수 있다.

서버 점검 팝업

Hive v1.15.0부터 서버 점검/업데이트 팝업에 버튼을 최대 3개까지 구성할 수 있다. 버튼 구성은 Hive 콘솔에서 제공한다.

업데이트 팝업

개인 정보 취급 방침 및 이용 약관, 서버 점검 및 공지·업데이트 팝업을 출력한다.
초기화 이전에 안드로이드 권한을 체크할 수 있다.

requestPermission을 사용할 경우 Social Initialize 전에 호출해야 한다.
1.12.0 버전 이상부터 serverId 키가 삭제되었다. (SetGameInfo API 참고)

argument type	type	desc	platform	비고
type	string	“terms” : 개인정보처리방침 및 이용 약관을 출력한다. “notice” : 서버 점검 및 공지·업데이트 팝업을 출력한다. (1.10.0+) “requestPermission” : [전화 걸기 및 관리] 권한을 요청한다. (Android Only) (1.11.0+)	all
type == “notice”일 때 (1.10.0+)
serverId	string	서버별 점검공지 팝업지원을 위한 serverid (백오피스 월드관리에 등록된 월드값을 서버에 따라 구분하여 입력이 되어야 한다.) 서버 지역 코드값은 ‘ISO 3166 alpha-2’ 코드를 기준으로 하며 Hive 연동 가이드라인 게임서버 ID 항목을 참고한다.	all	1.10.0+ (1.12.0+ 삭제)
type == “requestPermission”일 때 (1.11.0+)
permissionWriteExternalStorage	bool	(Optional) 외부저장소 권한 요청 여부 (default false)	Android	1.11.0+

Result – Api.Social_Show

개인 정보 취급 방침 및 이용 약관 웹뷰 성공 여부
안드로이드 권한 체크가 끝나면 반환되는 콜백

argument type	type	desc	platform	비고
서버 점검 및 공지·업데이트 팝업 보기를 요청했을 경우 (type키가 있으면서 type == “notice” 일때)
type	string	“notice” : 서버 점검 및 공지·업데이트 팝업 (1.10.1+)	all	1.10.1+
state	string	“close” : 공지 팝업 버튼이 팝업만 닫기 기능일 경우 팝업이 닫혔을 때 반환 (1.10.1+) “unshown” : 보여줄 점검 팝업이 없는 경우 (백오피스에 등록되지 않은 상태) (1.10.1+)	all	1.10.1+
[전화 걸기 및 관리] 권한을 요청했을 경우 (type키가 있으면서 type == “requestPermission” 일때)
type	string	“requestPermission” : [전화 걸기 및 관리] 권한을 요청한다. (1.11.0+)	Android	1.11.0+
isChecked	bool	requestPermission 요청시 true로 반환됨 (1.11.0+)	Android	1.11.0+

서버 점검 및 공지·업데이트 정보를 요청한다.
Hive SDK v1.12.0 버전부터 기존의 식별자 파라미터가 삭제되고 통합 식별자로 통일되었다.
현재 사용중인 통합 식별자 serverId와 gameLanguage는 아래 API에서 설정 가능하다.

argument type	type	desc	platform	비고
type	string	“notice” : 서버 점검 및 공지·업데이트 팝업의 정보. (1.10.0+)	all	1.10.0+
type == “notice”일 때 (1.10.0+)
serverId	string	서버별 점검공지 팝업지원을 위한 serverid (백오피스 월드관리에 등록된 월드값을 서버에 따라 구분하여 입력이 되어야 한다.)서버 지역 코드값은 ‘ISO 3166 alpha-2’ 코드를 기준으로 하며 Hive 연동 가이드라인 게임서버 ID 항목을 참고한다.	all	1.10.0+ (1.12.0+ 삭제)

Result – Api.Social_Info

argument type	type	desc	platform	비고
서버 점검 및 공지·업데이트 정보를 요청했을 경우 (type==”notice”)
show	bool	true : 서버 점검 및 공지·업데이트 정보가 있는 경우 (백오피스에 등록된 상태) false : 서버 점검 및 공지·업데이트 정보가 없는 경우 (백오피스에 등록되지 않은 상태)	all	1.10.0+
data	string	요청한 서버 점검 및 공지·업데이트 정보가 담겨잇는 json 정보	all	1.10.0+

data json (Hive SDK v1.15.0 미만)

"data":
   {"errno":0,       // error 코드
    "error":"OK",      // error 코드에 대한 메시지
    "notice_show":1,     // 모듈 내 팝업 노출 여부 확인 값
    "notice_title":"서버 점검 중 테스트",       // 팝업 타이틀
    "notice_message":"2016-07 … - (중략) - 점검 테스트 중 입니다.",      // 팝업 메시지
    "notice_button":"상세보기",      // 팝업 버튼 텍스트
    "notice_action":1,       // 모듈 내 팝업 버튼 액션 인덱스
    "notice_url":"http://www.withhive.com,      // 이동할 url 주소
    "remaining_time":603555        // 남은 점검 시간
   }

"data":

{"errno":0, // error 코드

"error":"OK", // error 코드에 대한 메시지

"notice_show":1, // 모듈 내 팝업 노출 여부 확인 값

"notice_title":"서버 점검 중 테스트", // 팝업 타이틀

"notice_message":"2016-07 … - (중략) - 점검 테스트 중 입니다.", // 팝업 메시지

"notice_button":"상세보기", // 팝업 버튼 텍스트

"notice_action":1, // 모듈 내 팝업 버튼 액션 인덱스

"notice_url":"http://www.withhive.com, // 이동할 url 주소

"remaining_time":603555 // 남은 점검 시간

}

data json (Hive SDK v1.15.0 이상)

"data":
   {"errno":0,       // error 코드
    "error":"OK",      // error 코드에 대한 메시지
    "notice_show":1,     // 모듈 내 팝업 노출 여부 확인 값
    "notice_title":"서버 점검 중 테스트",       // 팝업 타이틀
    "notice_message":"2018-08-19 … (중략) ... 테스트 중 입니다.",      // 팝업 메시지
    "notice_button":"확인",      // 기존 키 값을 호환하여 같이 전달 
    "notice_action":2,       // 기존 키 값을 호환하여 같이 전달 
    "notice_url":"",      // 기존 키 값을 호환하여 같이 전달 
    "remaining_time":6075,
    "button_list":          // Hive 콘솔에 설정한 버튼 정보 (Hive 1.15.0 이상)
        [{"action":"2","url":"","button":"확인"},        // 첫 번째 버튼 정보
        {"action":"3","url":"","button":"닫기"},        // 두 번째 버튼 정보
        {"action":"1","url":"htttps://m.naver.com","button":"상세보기"}        // 세 번째 버튼 정보
]}

"data":

{"errno":0, // error 코드

"error":"OK", // error 코드에 대한 메시지

"notice_show":1, // 모듈 내 팝업 노출 여부 확인 값

"notice_title":"서버 점검 중 테스트", // 팝업 타이틀

"notice_message":"2018-08-19 … (중략) ... 테스트 중 입니다.", // 팝업 메시지

"notice_button":"확인", // 기존 키 값을 호환하여 같이 전달

"notice_action":2, // 기존 키 값을 호환하여 같이 전달

"notice_url":"", // 기존 키 값을 호환하여 같이 전달

"remaining_time":6075,

"button_list": // Hive 콘솔에 설정한 버튼 정보 (Hive 1.15.0 이상)

[{"action":"2","url":"","button":"확인"}, // 첫 번째 버튼 정보

{"action":"3","url":"","button":"닫기"}, // 두 번째 버튼 정보

{"action":"1","url":"htttps://m.naver.com","button":"상세보기"} // 세 번째 버튼 정보

]}

Hive 1.15.0 미만 버전과 최신 버전을 호환하기 위해 첫 번째 버튼의 기존 키 값을 그대로 전달한다.
Hive 1.15.0 이상 버전부터 button_list 키가 추가되면서 Hive 콘솔에 설정한 각 버튼의 정보를 포함한다.

샘플코드

Unity3d:C2SModule.Social.Show

public static bool C2SModule.Social.Show(C2SModule.Parameter arg, out C2SModule.Error error) ;
public static bool C2SModule.Social.Show(C2SModule.Parameter arg, out C2SModule.Error error,
C2SModule.CompletionHandler completionHandler);

Overview
– 서버 점검 및 공지·업데이트 팝업을 출력한다.

/* 1.10.0 추가 */
/* 서버 점검 및 공지·업데이트 팝업 보기 */
C2SModule.Parameter arg = new C2SModule.Parameter ();
arg ["type"] = "notice";   
arg ["serverId"] = "server_001";    // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.
C2SModule.Error error;
if(!C2SModule.Social.Show (arg, out error))
{
    // Error 시 처리
}

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 팝업 보기 */

C2SModule.Parameter arg = new C2SModule.Parameter ();

arg ["type"] = "notice";

arg ["serverId"] = "server_001"; // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

C2SModule.Error error;

if(!C2SModule.Social.Show (arg, out error))

{

// Error 시 처리

}

Unity3d:C2SModule.Social.Info

public static bool C2SModule.Social.Info(C2SModule.Parameter arg, out C2SModule.Error error) ;
public static bool C2SModule.Social.Info(C2SModule.Parameter arg, out C2SModule.Error error,
C2SModule.CompletionHandler completionHandler);

Overview
– 서버 점검 및 공지·업데이트 정보를 요청한다.

/* 1.10.0 추가 */
/* 서버 점검 및 공지·업데이트 정보 요청 */
C2SModule.Parameter arg = new C2SModule.Parameter ();
arg ["type"] = "notice";   
arg ["serverId"] = "server_001"  // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.
C2SModule.Error error;
if(!C2SModule.Social.Info (arg, out error))
{
    // Error 시 처리
}

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 정보 요청 */

C2SModule.Parameter arg = new C2SModule.Parameter ();

arg ["type"] = "notice";

arg ["serverId"] = "server_001" // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

C2SModule.Error error;

if(!C2SModule.Social.Info (arg, out error))

{

// Error 시 처리

}

Unreal:HiveSDKUESocial_Show

void HiveSDKUESocial_Show(FString fstrJson);

Overview
– 서버 점검 및 공지·업데이트 팝업을 출력한다.

    /* 1.10.0 추가 */
    /* 서버 점검 및 공지·업데이트 정보 팝업 보기 */
    TSharedPtr arg = MakeShareable(new FJsonObject);
    arg->SetStringField(TEXT("type"), TEXT("notice"));
    arg->SetStringField(TEXT("serverId"), TEXT("server_001"));    // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

    FString OutputString;
    TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString);
    FJsonSerializer::Serialize(arg.ToSharedRef(), Writer);
    
    FHiveSDKModule::Get().HiveSDKUESocial_Show(OutputString);

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 정보 팝업 보기 */

TSharedPtr arg = MakeShareable(new FJsonObject);

arg->SetStringField(TEXT("type"), TEXT("notice"));

arg->SetStringField(TEXT("serverId"), TEXT("server_001")); // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

FString OutputString;

TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString);

FJsonSerializer::Serialize(arg.ToSharedRef(), Writer);

FHiveSDKModule::Get().HiveSDKUESocial_Show(OutputString);

Unreal:HiveSDKUESocial_Info

void HiveSDKUESocial_Info(FString fstrJson);

Overview
– 서버 점검 및 공지·업데이트 정보를 요청한다.

    /* 1.10.0 추가 */
    /* 서버 점검 및 공지·업데이트 정보 요청 */
    TSharedPtr arg = MakeShareable(new FJsonObject);
    arg->SetStringField(TEXT("type"), TEXT("notice"));
    arg->SetStringField(TEXT("serverId"), TEXT("server_001"));   // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

    FString OutputString;
    TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString);
    FJsonSerializer::Serialize(arg.ToSharedRef(), Writer);
    
    FHiveSDKModule::Get().HiveSDKUESocial_Info(OutputString);

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 정보 요청 */

TSharedPtr arg = MakeShareable(new FJsonObject);

arg->SetStringField(TEXT("type"), TEXT("notice"));

arg->SetStringField(TEXT("serverId"), TEXT("server_001")); // 1.12.0미만 : serverId 키 설정 필요, 1.12.0이상 : serverId 키 사용하지 않음.

FString OutputString;

TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString);

FJsonSerializer::Serialize(arg.ToSharedRef(), Writer);

FHiveSDKModule::Get().HiveSDKUESocial_Info(OutputString);

IOS:C2SModuleSocial Show

+(BOOL)Show:(id)arg error:(NSError**)error completionHandler:(void(^)(NSDictionary *, NSError*))
completionHandler;

Overview
– 서버 점검 및 공지·업데이트 팝업을 출력한다.

/* 1.10.0 추가 */
/* 서버 점검 및 공지·업데이트 팝업 보기 */
NSError* error;
// 1.12.0미만 : serverId 값 설정 필요, 1.12.0이상 : serverId 값 사용하지 않음.
[C2SModuleSocial Show:@{@"type":@"notice", @"serverId" : @"server_001"} error:&error completionHandler:^(NSDictionary* resultArg, NSError* resultError){
    if (resultError == nil) {
        //succeed
    }
}];

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 팝업 보기 */

NSError* error;

// 1.12.0미만 : serverId 값 설정 필요, 1.12.0이상 : serverId 값 사용하지 않음.

[C2SModuleSocial Show:@{@"type":@"notice", @"serverId" : @"server_001"} error:&error completionHandler:^(NSDictionary* resultArg, NSError* resultError){

if (resultError == nil) {

//succeed

}

}];

IOS:C2SModuleSocial Info

+(BOOL)Info:(id)arg error:(NSError**)error completionHandler:(void(^)(NSDictionary *, NSError*))
completionHandler;

Overview
– 서버 점검 및 공지·업데이트 정보를 요청한다.

/* 1.10.0 추가 */
/* 서버 점검 및 공지·업데이트 정보 요청 */
NSError* error;
// 1.12.0미만 : serverId 값 설정 필요, 1.12.0이상 : serverId 값 사용하지 않

/* 1.10.0 추가 */

/* 서버 점검 및 공지·업데이트 정보 요청 */

NSError* error;

// 1.12.0미만 : serverId 값 설정 필요, 1.12.0이상 : serverId 값 사용하지 않

공지·업데이트 팝업 (1.10.0+)

Result – Api.Social_Show

Result – Api.Social_Info

샘플코드

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원

서버 점검 & 강제 업데이트

공지·업데이트 팝업 (1.10.0+)

C2SModuleSocial_Show

Result – Api.Social_Show

C2SModuleSocial_Info

Result – Api.Social_Info

샘플코드

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원