상수 및 자료형

USER_AGREE_RESULT

* 유저 동의 결과를 받는 콜백 함수에서 사용되는 데이터

typedef enum USER_AGREE_RESULT_TYPE
{
USER_AGREE_SUCCESS = 0,
USER_AGREE_TERMS_CLOSE = 1 // only iOS
}USER_AGREE_RESULT;

ACTIVE_USER_RESULT

* DID 요청 결과를 받는 콜백 함수에서 사용되는 데이터

typedef enum ACTIVE_USER_RESULT_TYPE
{
ACTIVE_USER_GETDID_SUCCESS = 0,
ACTIVE_USER_GETDID_FAIL = 1,
}ACTIVE_USER_RESULT;

SERVER_STATE

* 모듈 서버를 설정 (Available in 2.6.0 and later)

typedef enum SERVER_STATE_TYPE
{
LIVE_SERVER = 0,
STAGING_SERVER = 1,
SANDBOX_SERVER = 2
}SERVER_STATE;

SHOW_POPUP

* 점검,공지 팝업을 보여줘야 할지 여부를 나타내는 데이터 (Available in 2.6.5 and later)

typedef enum SHOW_POPUP_TYPE
{
SHOW = 0,
NOTSHOW = 1
} SHOW_POPUP;

POPUP_STATE_TYPE

* 점검,공지 팝업이 닫혔는지 상태를 나태내는 데이터 (Available in 2.6.6 and later)

typedef enum POPUP_STATE_TYPE
{
CLOSE = 0
} POPUP_STATE;

REQUEST_PERMISSION_STATE_TYPE

* (Android Only)Android 권한 추가 요청 시 요청에 대한 결과 상태를 나타내는 데이터 (Available in 2.9.0 and later)

typedef enum REQUEST_PERMISSION_STATE_TYPE
{
SUCCESS = 0,
ERROR = -1,
NOT_SUPPORT_OS_VERSION = -2,
WRONG_TYPE_DATA = -3
} REQUEST_PERMISSION_STATE;

MODULE_ORIENTATION

* Hive에서 지원하는 Orientation 데이터

typedef enum MODULE_ORIENTATION_TYPE
{
ALL = 0,
PORTRAIT = 1,
LANDSCAPE = 2
} MODULE_ORIENTATION;

함수

void CS_ActiveUserStart()

Description
ActiveUser의 모듈을 시작합니다. (앱의 초기화시에 호출) 조건에 따라 이 시점에 약관 동의가 뜨며, 시작시 매번 호출해야 합니다. DownloadCheck, UserAgree 정보를 서버로 전송합니다.
기본값으로 LIVE 서버로 세팅 됩니다.
Return Value

void

Remark
Java / C# : start()

void CS_ActiveUserStartEx(SERVER_STATE serverState)

Description
ActiveUser의 모듈을 시작합니다. (앱의 초기화시에 호출) 조건에 따라 이 시점에 약관 동의가 뜨며, 시작시 매번 호출해야 합니다. DownloadCheck, UserAgree 정보를 서버로 전송합니다.
serverState에 따라 모듈이 사용하는 서버가 달라집니다. 관련 내용은 링크를 참고해주세요.
Return Value

void

Parameter

in/out	Type	Name	Description
in	SERVER_STATE	serverState	설정할 모듈 서버 enum 값

Remark
Java / C# : start(SERVER_STATE server)
Available in 2.6.0 and later

void CS_ActiveUserStartWithoutNotice(SERVER_STATE serverState, int showNotice)

Description
ActiveUser의 모듈을 시작합니다. (앱의 초기화시에 호출) 조건에 따라 이 시점에 약관 동의가 뜨며, 시작시 매번 호출해야 합니다. DownloadCheck, UserAgree 정보를 서버로 전송합니다.
serverState에 따라 모듈이 사용하는 서버가 달라집니다. 관련 내용은 링크를 참고해주세요.
showNoticePopup이 true인 경우 기존에 존재하던 CS_ActiveUserStartEx 함수와 동일하게 작동합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	SERVER_STATE	serverState	부가 설명 없음
in	int	showNotice	초기화시에 점검, 업데이트 팝업 노출을 진행할지 선택하는 값

Remark
JAVA/C# : start(SERVER_STATE server, bool showNotice)
Available in 2.6.5 and later

void CS_ActiveUserSetServerId(const char* server_id)

Description
모듈의 통합식별자 Server ID를 설정합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	const char*	server_id	설정 할 Server ID

Remark
not comment

void CS_ActiveUserSetGameLanguage(const char* game_language)

Description
모듈의 통합식별자 Game Language(게임 언어)를 설정합니다. (게임 언어 지원 코드)

게임 언어를 설정하지 않을 경우 단말 언어 설정을 따릅니다.

(CS_ActiveUserStart() 혹은 CS_ActiveUserStartEx() 수행후 호출하여 설정, 또한 게임 언어 변경이 필요한 경우 호출하여 설정)

added in 2.7.3(iOS), 2.7.5(AD)

Return Value

void

Parameter

in/out	Type	Name	Description
in	const char*	game_language	game_language 코드 값

Remark
Java / C# : setGameLanguage()

Available in 2.7.3(iOS), 2.7.5(Android) and later

void CS_SetMinTimeoutSeconds(int seconds)

Description
웹뷰 타임아웃 초기 시간을 설정합니다.

설정하지 않을 경우 웹뷰 타임아웃 대기 시간은 최초 5초(초기 시간)이며 타임아웃이 발생할 경우 5초씩 증가하여 5 / 10 / 15초의 타임아웃 대기시간을 갖습니다.

타임아웃 초기 시간은 5~15초 사이로 설정 가능합니다. 해당 범위에서 벗어난 값을 사용할 경우 기본 5초로 설정됩니다.

예) 초기 시간 7초 설정시 : 7 / 10 / 15초 타임아웃 대기시간, 초기 시간 12초 설정시 : 12 / 15 / 15초 타임아웃 대기 시간

added in 2.8.0(iOS), 2.8.0(AD)

Return Value

void

Parameter

in/out	Type	Name	Description
in	int	seconds	타임아웃 초기 시간 값

Remark
Java / C# : setNetworkTimeSeconds()

Available in 2.8.0(iOS), 2.8.0(Android) and later

int CS_ActiveUserGetVersion(char* buf, int bufSize)

Description
모듈의 버전 확인하는 함수.
Return Value

CM_E_SUCCESS : 성공
CM_E_ERROR :기타에러
CM_E_SHORTBUF : 버퍼가 작음

Parameter

in/out	Type	Name	Description
out	char*	buf	버전 정보를 받아오는 메모리 버퍼. 종료 문자를 더하여서 최소 9byte가 필요함.
in	int	bufSize	메모리 버퍼의 크기. byte 단위.

Remark
Java / C# : getVersion()

int CS_ActiveUserSetLogged(int isLogged)

Description
로그를 노출할지 설정. (Android Only)
Return Value

Parameter

in/out	Type	Name	Description
in	int	isLogged	로그를 노출할지 여부

Remark
Java / C# : setLogged(int isLogged)

const char* CS_ActiveUserGetDID()

Description
ActiveUser로 부터 DID의 값을 전달 받습니다. ACTIVE_USER_GETDID_SUCCESS 콜백 이후 받을 수 있습니다. (혹은 콜백 내에서 세팅)
Return Value

DID string

Remark
Java / C# : getDID()

Available in 2.0.0 and later

void CS_ActiveUserSetCallback(ActiveUserCB cb)

Description
ActiveUser의 콜백 함수를 등록합니다. CS_ActiveUserStart 호출 이전에 콜백을 등록해야 합니다. 약관동의 창이 닫히고 서버로 부터 DID 를 받아 온 후 호출 됩니다. UserAgreeCallback 이후 불리게 됩니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	ActiveUserCB	cb	콜백 함수 typedef void (*ActiveUserCB)(ACTIVE_USER_RESULT result);

Remark

void CS_UserAgreeSetCallback(UserAgreeCB cb)

Description
UserAgree의 콜백 함수를 등록합니다. CS_ActiveUserStart 호출 이전에 콜백을 등록해야 합니다. 약관동의 창이 닫히고 호출 됩니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	UserAgreeCB	cb	콜백 함수 typedef void (*UserAgreeCB)(USER_AGREE_RESULT result);

Remark
Java / C# : setUserAgreeNotifier(UserAgreeNotifier notifier)

void CS_UserAgreeShowTermsUI(void* parentView)

Description
이용 약관을 다시 보여줍니다. (유저가 다시 보기 등을 눌렀을 때 사용) 약관 동의 창과는 다릅니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	void*	parentView	해당 게임의 viewController의 view를 전달한다. (iOS에서 사용되는 파라미터)

Remark
Java / C# : showUserAgreeTerms()

void CS_UserAgreeShowTermsUIEx(void* parentView, const char* url)

Description
이용 약관 다시 보기 창이지만, 입력해준 Url 로 웹뷰를 호출합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	void*	parentView	해당 게임의 viewController의 view를 전달한다. (iOS에서 사용되는 파라미터)
in	const char*	url	게임이 퍼블리싱이나 기타 이유로 외부 이용약관이나 공통 이용약관과 다른경우 변경된 페이지의 URL을 노출 시킵니다.

Remark
Java / C# : showUserAgreeTerms()

void CS_UserAgreeReset()

Description
사용자동의화면이 재노출이 가능하도록 설정함. 아래의 특정 경우가 아니면 사용하면 안됩니다.
카톡게임의 경우 로그아웃이 된 이후 재로그인할때 약관동의화면이 노출되도록 가이드됨에 따라 추가됨.
Reset후에도 CS_ActiveUserStart가 호출되어야 합니다.
Return Value

void

Remark
java / C# : resetUserAgree()

void CS_ActiveUserSetEnableRequestStoragePermission()

Description
Android 6.0 이상에서 Storage 퍼미션 권한을 요청 합니다. (Only Android)
기본적으로 Phone 퍼미션 권한은 요청하며, 호출 시 Storage 퍼미션 권한도 요청하게 됩니다.
CS_ActiveUserStart() 이전에 세팅해 주어야 합니다.
Return Value

void

Remark
java / C# : setEnableRequestStoragePermission()
Available in 2.6.2 and later

void CS_UpdateNoticeShowPopup(UpdateNoticePopupCB cb)

Description
점검공지, 업데이트 팝업 UI를 노출합니다.
cb설정을 하지 않는 경우(혹은 null로 설정하는 경우) 정상작동하지 않을 수 있습니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	UpdateNoticePopupCB	cb	팝업이 닫히는 경우 호출되는 콜백

Remark
Available in 2.0.0 and later
Java / C# : showNoticePopup(final NoticeShowPopupCBWithData nspCallBack)

void CS_UpdateNoticeGetPopupInfo(UpdateNoticeInfoCB cb)

Description
점검공지, 업데이트 팝업 구성에 필요한 데이터를 UpdateNoticeInfoCB 콜백으로 전달합니다
cb설정을 하지 않는 경우(혹은 null로 설정하는 경우) 정상작동하지 않을 수 있습니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	UpdateNoticeInfoCB	cb	팝업 데이터를 전달받는 콜백

Remark
Available in 2.6.6 and later
Java / C# : getNoticePopupInfo(final NoticePopupInfoCBWithData npCallBack)

void CS_ActiveUserGetPermissionViewData(PermissionViewDataCB cb)

Description
권한고지 팝업 구성에 필요한 데이터를 PermissionViewDataCB 콜백으로 전달합니다
cb설정을 하지 않는 경우(혹은 null로 설정하는 경우) 정상작동하지 않을 수 있습니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	PermissionViewDataCB	cb	팝업 데이터를 전달받는 콜백

Remark
Available in 2.8.8 and later
Java / C# :

void CS_ActiveUserSetPermissionViewState(int isOn)

Description
앱 설치 후 초기화 시 모듈이 노출시키는 권한 고지 페이지를 노출시킬지 여부를 제어합니다.
최초 앱 설치 후 해당 API를 false(0)로 호출하고 초기화(start API)를 호출할 경우 모듈의 권한 고지 페이지가 노출되지 않습니다. 단, 이후 해당 API를 true(1)로 호출하고 초기화(start API)를 호출할 경우 모듈의 권한 고지 페이지가 노출됩니다.
이미 모듈의 권한 고지 페이지를 보았던 경우에는 해당 API가 영향을 주지 않습니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	int	isOn	true(default) : 권한 고지 노출 / false : 권한 고지 미노출

Remark
Available in 2.9.0 and later
Java / C# : setIsShowPermissionView(boolean isShow) / setPermissionViewState(int isOn)

void CS_ActiveUserSendFunnelsLogs(String funnelsTrack, String optionTag)

Description
일부 퍼널 로그를 전송할 수 있는 기능을 제공합니다.
퍼널 로그를 전송하여 애널리틱스 콘솔을 통해 해당 시점이 정상적으로 진행되었는지 확인할 수 있습니다. 기본적인 모듈 기능(약관 노출 시점, 서버 공지 팝업 노출 시점 등)의 퍼널 로그는 모듈 내부에 내장되어 있습니다.
funnelsTrack 파라미터에는 "700"(String, 앱의 추가 다운로드 시작 시점을 퍼널 로그로 전송), "800"(String, 앱의 추가 다운로드 완료 시점을 퍼널 로그로 전송) 을 선택하여 입력합니다.
optionTag에는 부가적으로 넣을 정보를 입력합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	String	funnelsTrack	"700" 혹은 "800" 사용 가능
in	String	optionTag	부가 정보 입력

Remark
Available in 2.9.0 and later
Java / C# : sendFunnelsLogs(String funnelsTrack, String optionTag) / sendFunnelsLogs(string funnelsTrack, string optionTag)

void CS_ActiveUserRequestUserPermissions(String requests, RequestUserPermissionsCB cb)

Description
(Android Only) Android 의 Dangerous 권한을 추가로 요청합니다.
주의! 해당 API로 추가적으로 권한을 요청하는 권한은 꼭 AndroidManifest.xml에 그 권한이 선언되어 있어야 합니다.
ActiveUser 모듈 초기화 시점에 받지 않는 별도의 권한(앱에서 사용하는 별도의 권한)을 원하는 시점에 요청하여 사용자에게 허용 혹은 거부 여부를 받습니다.
사용자가 요청된 권한에 대해서 허용 혹은 거부를 모두 한 뒤엔 결과 정보가 콜백으로 전달됩니다.
C2S.19.6 이후 버전에서 Android의 위험 권한(Dangerous Permissions)은 해당 API를 통해 요청할 수 있습니다. 게임 프로젝트에서 특정 권한을 사용해야 하는 경우 해당 API를 호출하세요. (C2S.19.6부터는 ActiveUser 모듈 초기화 단계에서 위험 권한(Dangerous Permissions)을 자동 요청하지 않습니다. C2S.19.6 이후 ActiveUser 모듈 초기화 시 모듈이 요청하는 Andorid Dangerous 권한이 없습니다.)
Return Value

void

Parameter

in/out	Type	Name	Description
in	String	requests	Android 권한을 JsonArray 형태로 구성합니다. 그리고 구성된 JsonArray 형태를 String 형태로 파라미터에 입력합니다. (ex : String requests = "{"requests":["android.permission.READ_CONTACTS","android.permission.READ_PHONE_STATE","android.permission.WRITE_EXTERNAL_STORAGE"]}";)
in	RequestUserPermissionsCB	cb	권한 고지 요청 결과를 전달받는 콜백

Remark
Available in 2.9.0 and later
Java / C# : requestUserPermissions(final String requests, final RequestPermissionCBWithData rpCallBack) / CS_ActiveUserRequestUserPermissions(const char* requests, RequestUserPermissionsCB cb)

Java / C# only

ActiveUser(Activity activity)

Description
ActiveUser 객체 생성자
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	Activity	activity	Activity

Remark
not comment

void onActivityStarted()

Description
Activity LifeCycle 에서 onStart 에 해당하는 시점에 호출해 주면 됩니다. (다른 게임엔진의 경우 resume 등의 시점)
Return Value

void

Remark
not comment

void onActivityStopped()

Description
Activity LifeCycle 에서 onStop 에 해당하는 시점에 호출해 주면 됩니다. (다른 게임엔진의 경우 pause 등의 시점)
Return Value

void

Remark
not comment

void CS_ActiveUserUpdateServerId(const char* serverId)

Description
serverId 설정을 변경하고, Hive Promotion을 사용중인 경우 새소식 노출에 필요한 정보를 serverId에 맞추어 갱신합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	const char*	serverid	변경하고자 하는 serverid 입력

Remark
Available in Android ActiveUser 2.10.0, iOS ActiveUser 2.10.8

Java : void updateServerId(String serverId)

C# : void updateServerId(string serverId)

void CS_ActiveUserUpdateGameLanguage(const char* gameLanguage)

Description
gameLanguage 설정을 변경하고, Hive Promotion을 사용중인 경우 새소식 노출에 필요한 정보를 gameLanguage 맞추어 갱신합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	const char*	gameLanguage	변경하고자 하는 gameLanguage 입력

Remark
Available in Android ActiveUser 2.10.0, iOS ActiveUser 2.10.8

Java : void updateGameLanguage(String gameLanguage)

C# : void updateGameLanguage(string gameLanguage)

void CS_SetAnalyticsLogSettings(int sendLimit, int queueLimit, int sendCycleSecond)

Description
애널리틱스 로그 전송 시 로그 전송 옵션 값을 변경합니다.

ActiveUser 초기화(CS_ActiveUserStart 계열) 전에 호출해야 하며 초기화 이후에는 호출해도 작동하지 않습니다.

해당 API 미호출 시 default 값으로 작동합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	int	sendLimit	전송 주기마다 전송할 로그의 최대치 (default: 5)
in	int	queueLimit	최대로 적재할 로그 queue의 양 (default: 50)
in	int	sendCycleSecond	로그 전송 주기 (default: 1)

Remark
Available in Android ActiveUser 2.10.1, iOS ActiveUser 2.10.9

Java : void setAnalyticsLogSettings(int sendLimit, int queueLimit, int sendCycleSecond)

C# : void SetAnalyticsLogSettings(int sendLimit, int queueLimit, int sendCycleSecond)

int CS_SendAnalyticsLog(const char* logData)

Description
임의의 애널리틱스 로그를 전송합니다. logData에 들어가는 데이터는 JSONObject 형식을 갖추어야 합니다.

logData에 category 값을 임의 지정할 경우 해당 category 로그로 Hive 콘솔에서 확인이 가능합니다. category 미지정 시 hive_user_entry_log 카테고리에 로그가 전송됩니다.
Return Value

int

0 : 로그 전송 실패(logData 형식이 JSONObject 형태가 아닌 경우)

1 : 로그 전송 성공

Parameter

in/out	Type	Name	Description
in	const char*	logData	애널리틱스 서버에 전송할 로그 정보 ( ex : “{“charName”:”C2SDev”,”lev”:77,”gem”:50,”category”:”userInfoLog”}” )

Remark
Available in Android ActiveUser 2.10.1, iOS ActiveUser 2.10.9

Java : void sendAnalyticsLog(String logData)

C# : void sendAnalyticsLog(string logData)

int CS_SetEmergencyModeWithUid(const char* uid)

Description
입력받은 uid로 긴급 로그인 설정을 진행합니다.

기존 모듈들의 SetUid를 대체하는 '긴급로그인용' API입니다. 반드시 긴급 로그인 상황에서 사용해야 합니다.

해당 API는 정상 로그인을 진행할 수 없을 때 호출되어야 합니다. 정상 로그인이 가능한 상황에서는 해당 API를 호출하지 않도록 주의바랍니다.
- Case 1 : 긴급 로그인을 새로 적용하는 프로젝트의 경우
  - 플랫폼 서버 API 중 인증 서버 접속 불가를 확인하는 API를 구현합니다. (플랫폼실 서버팀 로그인 및 인증 담당자 문의)
  - 인증 서버에 접속할 수 없는 상황임이 확인되면 게임 프로젝트에서 이전에 로그인 성공한 uid를 확인하여 CS_SetEmergencyModeWithUid 파라미터로 설정하고 호출합니다. (uid는 게임 클라이언트나 게임 서버에서 자체적으로 관리되어야 합니다.)
  - 로그인 없이 기타 모듈(프로모션, 인앱 등)의 기능이 설정한 uid로 동작합니다.
- Case 2 : C2S.19.6 이전 버전에서 긴급 로그인을 구현하여 사용하고 있는 경우
  - 인증 서버 접속 불가 시 각 모듈의 SetUId API를 호출하고 있던 부분을 제거하고, CS_SetEmergencyModeWithUid API를 통해 uid를 설정합니다. (uid는 게임 클라이언트나 게임 서버에서 자체적으로 관리되어야 합니다.)
  - 로그인 없이 기타 모듈(프로모션, 인앱 등)의 기능이 설정한 uid로 동작합니다.
Return Value

int

0 : 긴급 로그인 실패 (uid 세팅 실패)

1 : 긴급 로그인 성공 (uid 세팅 성공)

Parameter

in/out	Type	Name	Description
in	const char*	uid	긴급 로그인 사용 요청 uid

Remark
Available in C2S 19.6

Java : int setEmergencyModeWithUid(const char* uid)

C# : int setEmergencyModeWithUid(const char* uid)

void CS_SetModuleOrientation(MODULE_ORIENTATION orientation)

Description
HiveSDK UI Orientation을 설정할 수 있는 키가 추가 되었습니다. (default UNDEFINED)

    - ALL - HiveUI가 가로/세로 모든 방향으로 실시간 회전합니다.

    - PORTRAIT - HiveUI가 세로 방향으로만 설정됩니다.

    - LANDSCAPE - HiveUI가 가로 방향으로만 설정됩니다.

실시간 회전을 지원하지 않는 게임에서는 반드시 게임 지원 방향에 맞춰 호출해야 합니다.

파라미터 호출 방법

    - 4방향 회전 지원(가로, 세로 모두 지원) 게임은 ALL 값을 사용하여 호출합니다.

    - 세로 방향의 게임은 PORTRAIT 값을 사용하여 호출합니다.

    - 가로 방향의 게임은 LANDSCAPE 값을 사용하여 호출합니다.

ActiveUser 초기화 API(CS_ActiveUserStart, CS_ActiveUserStartEx, CS_ActiveUserStartWithoutNotice) 호출 전에 해당 API를 호출해야 합니다.
Return Value

void

Parameter

in/out	Type	Name	Description
in	MODULE_ORIENTATION	orientation	요청 HiveUI Orientation 값

Remark
Available in C2S 19.6

Java : void setModuleOrientation(MODULE_ORIENTATION orientation)

C# : void setModuleOrientation(int orientation)

콜백 함수

typedef void (* UserAgreeCB)(USER_AGREE_RESULT result)

Description
유저 동의 또는 개인정보 수집 동의를 확인한경우, 혹은 이미 동의를 한 경우 호출된다. 앱 런치 이후 동의 화면에서 확인 버튼을 누른 다음 실행 될 프로세스를 콜백 이후에 구현 하면 됩니다.
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	USER_AGREE_RESULT	result	USER_AGREE_RESULT 입니다.

Remark
not comment
Sample Code

void UserAgreeCallBack(USER_AGREE_RESULT type)
{
switch (type) {
case USER_AGREE_SUCCESS:
NSLog(@"USER_AGREE_SUCCESS");
break;
default:
break;
}
}

typedef void (* ActiveUserCB)(ACTIVE_USER_RESULT result)

Description
USER_AGREE_RESULT 이후, DID의 값을 서버에서 전송받거나(최초 설치) 앱 내부에서 정상적으로 로딩된 경우 호출 되는 콜백 함수이다.
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	ACTIVE_USER_RESULT	result	ACTIVE_USER_RESULT 입니다.

Remark
not comment
Sample Code

void ActiveUserCallBack(ACTIVE_USER_RESULT type)
{
switch (type) {
case ACTIVE_USER_GETDID_SUCCESS:
NSLog(@"ACTIVE_USER_GETDID_SUCCESS");
NSLog(@"%s", CS_ActiveUserGetDID());
break;
case ACTIVE_USER_GETDID_FAIL:
NSLog(@"ACTIVE_USER_GETDID_FAIL");
break;
default:
break;
}
}

typedef void (* UpdateNoticePopupCB)(POPUP_STATE state)

Description
iOS에서 CS_UpdateNoticeShowPopup 호출시 등장하는 팝업이 닫히는 경우 호출
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	POPUP_STATE	state	팝업의 상태

Remark
not comment
Sample Code

void UpdateNoticePopupCallback(POPUP_STATE state)
{
switch (state) {
case CLOSE:
NSLog(@"Popup Close");
break;
default:
break;
}
}

typedef void (* UpdateNoticeInfoCB)(SHOW_POPUP show, const char* jsonData)

Description
iOS에서 CS_UpdateNoticeGetPopupInfo 함수 호출시 결과를 전달받는 콜백
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	SHOW_POPUP	show	노출해야 할 팝업이 존재하는지 여부
in	const char*	jsonData	팝업 데이터

Remark
not comment
Sample Code

void UpdateNoticeInfoCallback(SHOW_POPUP show, const char* jsonData)
{
switch (show) {
case SHOW:
NSLog(@"Show Popup");
break;
case NOTSHOW:
NSLog(@"Not show Popup");
break;
default:
break;
}
}

typedef void (* PermissionViewDataCB)(const char* jsonData)

Description
iOS에서 CS_ActiveUserGetPermissionViewData 함수 호출시 결과를 전달받는 콜백
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	const char*	jsonData	팝업 데이터

Remark
not comment
Sample Code

void PermissionViewDataCallBack(const char* jsonData)
{
if (jsonData != null) {
// 가이드 참고
}
}

typedef void (* RequestUserPermissionsCB)(REQUEST_PERMISSION_STATE state, const char* grantedPermissions, const char* deniedPermissions)

Description
Android에서 CS_ActiveUserRequestUserPermissions 함수 호출시 결과를 전달받는 콜백
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	REQUEST_PERMISSION_STATE	state	Android 추가 권한 요청 결과 상태
in	const char*	grantedPermissions	허용한 권한 목록
in	const char*	deniedPermissions	거부한 권한 목록

Remark
not comment
Sample Code

void PermissionViewDataCallBack(REQUEST_PERMISSION_STATE state, const char* grantedPermissions, const char* deniedPermissions)
{
switch(state) {
case SUCCESS:
if (grantedPermissions != null) {
// 허용된 권한 목록 확인 가능
}
if (deniedPermissions != null) {
// 거부된 권한 목록 확인 가능
}
break;
}
}

void noticeShowPopupCBWithData(POPUP_STATE state)

Description
Java에서 CS_UpdateNoticeShowPopup 호출시 등장하는 팝업이 닫히는 경우 호출
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	POPUP_STATE	state	팝업의 상태

Remark
not comment
Sample Code

@Override
public void noticeShowPopupCBWithData(final ActiveUser.POPUP_STATE state) {
runOnUiThread(new Runnable() {
public void run() {
StringBuilder resultString = new StringBuilder();
resultString.append(String.valueOf(state.getValue()));
Log.d(“CB”, “callback data : “ + resultString);
}
}
}

void noticePopupInfoCBWithData(SHOW_POPUP show, String jsonData)

Description
Java에서 CS_UpdateNoticeGetPopupInfo 함수 호출시 결과를 전달받는 콜백
Return Value

no return value

Parameter

in/out	Type	Name	Description
in	SHOW_POPUP	show	노출해야 할 팝업이 존재하는지 여부
in	String	jsonData	팝업 데이터

Remark
not comment
Sample Code

@Override
public void noticePopupInfoCBWithData(fnal ActiveUser.SHOW_POPUP show, String jsonData) {
runOnUiThread(new Runnable() {
public void run() {
StringBuilder resultString = new StringBuilder();
resultString.append(String.valueOf(show.getValue()))
.append(‘\t’)
.append(jsonData);
Log.d(“CB”, “callback data : “ + resultString);
}
}
}

목차

상수 및 자료형

USER_AGREE_RESULT

ACTIVE_USER_RESULT

SERVER_STATE

SHOW_POPUP

POPUP_STATE_TYPE

REQUEST_PERMISSION_STATE_TYPE

MODULE_ORIENTATION

함수

void CS_ActiveUserStart()

void CS_ActiveUserStartEx(SERVER_STATE serverState)

void CS_ActiveUserStartWithoutNotice(SERVER_STATE serverState, int showNotice)

void CS_ActiveUserSetServerId(const char* server_id)

void CS_ActiveUserSetGameLanguage(const char* game_language)

void CS_SetMinTimeoutSeconds(int seconds)

int CS_ActiveUserGetVersion(char* buf, int bufSize)

int CS_ActiveUserSetLogged(int isLogged)

const char* CS_ActiveUserGetDID()

void CS_ActiveUserSetCallback(ActiveUserCB cb)

void CS_UserAgreeSetCallback(UserAgreeCB cb)

void CS_UserAgreeShowTermsUI(void* parentView)

void CS_UserAgreeShowTermsUIEx(void* parentView, const char* url)

void CS_UserAgreeReset()

void CS_ActiveUserSetEnableRequestStoragePermission()

void CS_UpdateNoticeShowPopup(UpdateNoticePopupCB cb)

void CS_UpdateNoticeGetPopupInfo(UpdateNoticeInfoCB cb)

void CS_ActiveUserGetPermissionViewData(PermissionViewDataCB cb)

void CS_ActiveUserSetPermissionViewState(int isOn)

void CS_ActiveUserSendFunnelsLogs(String funnelsTrack, String optionTag)

void CS_ActiveUserRequestUserPermissions(String requests, RequestUserPermissionsCB cb)

Java / C# only

ActiveUser(Activity activity)

void onActivityStarted()

void onActivityStopped()

void CS_ActiveUserUpdateServerId(const char* serverId)

void CS_ActiveUserUpdateGameLanguage(const char* gameLanguage)

void CS_SetAnalyticsLogSettings(int sendLimit, int queueLimit, int sendCycleSecond)

int CS_SendAnalyticsLog(const char* logData)

int CS_SetEmergencyModeWithUid(const char* uid)

void CS_SetModuleOrientation(MODULE_ORIENTATION orientation)

콜백 함수

typedef void (* UserAgreeCB)(USER_AGREE_RESULT result)

typedef void (* ActiveUserCB)(ACTIVE_USER_RESULT result)

typedef void (* UpdateNoticePopupCB)(POPUP_STATE state)

typedef void (* UpdateNoticeInfoCB)(SHOW_POPUP show, const char* jsonData)

typedef void (* PermissionViewDataCB)(const char* jsonData)

typedef void (* RequestUserPermissionsCB)(REQUEST_PERMISSION_STATE state, const char* grantedPermissions, const char* deniedPermissions)

void noticeShowPopupCBWithData(POPUP_STATE state)

void noticePopupInfoCBWithData(SHOW_POPUP show, String jsonData)