Go on Game Server Services | Docs

트랜잭션 설정

매치메이킹 조작 시 트랜잭션 처리 방법을 제어하는 설정입니다.

enableRating

bool

false

레이팅 계산 기능 활성화

Glicko-2 기반의 레이팅 계산 기능을 활성화할지 여부입니다.
활성화하면, 플레이어는 Vote 시스템을 통해 대전 결과를 제출하고 레이팅이 자동으로 갱신됩니다.
RatingModel 마스터 데이터의 설정이 필요합니다. 기본값은 false입니다.

enableDisconnectDetection

문자열 열거형
enum {
“disable”,
“enable”
}

“disable”

연결 끊김 감지

매치메이킹 중인 플레이어가 대기 중임을 정기적으로 보고해야 하는지 여부를 제어합니다.
활성화하면, 플레이어가 설정된 타임아웃 시간 내에 킵얼라이브를 전송하지 않을 경우 자동으로 개더링에서 퇴장 처리됩니다.
이를 통해 “고스트” 플레이어가 매치메이킹 완료를 방해하는 것을 방지합니다. 기본값은 “disable” 입니다.

정의	설명
disable	비활성화
enable	활성화

disconnectDetectionTimeoutSeconds

int

{enableDisconnectDetection} == “enable”

✓※

15 ~ 600

연결 끊김 감지 타임아웃(초)

킵얼라이브 보고 없이 플레이어를 연결 끊김으로 간주하여 개더링에서 퇴장시키기까지의 대기 시간(초).
연결 끊김 감지가 활성화된 경우에만 적용됩니다. 15에서 600초 범위로 지정합니다.

※ enableDisconnectDetection이(가) “enable” 이면 필수

createGatheringTriggerType

문자열 열거형
enum {
  “none”,
  “gs2_realtime”,
  “gs2_script”
}

“none”

개더링 생성 시 트리거 타입

새로운 개더링이 생성되었을 때 실행할 액션의 종류.
GS2-Realtime의 룸 생성을 트리거하여 실시간 통신을 시작하거나, GS2-Script를 실행하여 커스텀 로직을 실행할 수 있습니다. 기본값은 “none” 입니다.

정의	설명
none	없음
gs2_realtime	GS2-Realtime의 룸 생성
gs2_script	GS2-Script의 실행

createGatheringTriggerRealtimeNamespaceId

string

{createGatheringTriggerType} == “gs2_realtime”

✓※

~ 1024자

개더링 생성 시 룸을 생성할 GS2-Realtime의 네임스페이스

※ createGatheringTriggerType이(가) “gs2_realtime” 이면 필수

createGatheringTriggerScriptId

string

{createGatheringTriggerType} == “gs2_script”

✓※

~ 1024자

개더링 생성 시 실행되는 GS2-Script의 스크립트 GRN

Script 트리거 레퍼런스 - createGathering

※ createGatheringTriggerType이(가) “gs2_script” 이면 필수

completeMatchmakingTriggerType

문자열 열거형
enum {
  “none”,
  “gs2_realtime”,
  “gs2_script”
}

“none”

매치메이킹 완료 시 트리거 타입

매치메이킹이 완료되었을 때(모든 역할 슬롯이 채워졌을 때) 실행할 액션의 종류.
매칭된 플레이어를 대상으로 GS2-Realtime의 룸 생성을 트리거하거나, GS2-Script를 실행하여 커스텀 사후 처리 로직을 실행할 수 있습니다. 기본값은 “none” 입니다.

정의	설명
none	없음
gs2_realtime	GS2-Realtime의 룸 생성
gs2_script	GS2-Script의 실행

completeMatchmakingTriggerRealtimeNamespaceId

string

{completeMatchmakingTriggerType} == “gs2_realtime”

✓※

~ 1024자

매치메이킹 완료 시 룸을 생성할 GS2-Realtime의 네임스페이스 GRN

※ completeMatchmakingTriggerType이(가) “gs2_realtime” 이면 필수

completeMatchmakingTriggerScriptId

string

{completeMatchmakingTriggerType} == “gs2_script”

✓※

~ 1024자

매치메이킹 완료 시 실행되는 GS2-Script의 스크립트 GRN

Script 트리거 레퍼런스 - completeMatchmaking

※ completeMatchmakingTriggerType이(가) “gs2_script” 이면 필수

enableCollaborateSeasonRating

문자열 열거형
enum {
“enable”,
“disable”
}

“disable”

시즌 레이팅 연계 활성화

시즌 기반 레이팅 계산을 위해 GS2-SeasonRating과의 연계를 활성화할지 여부.
활성화하면, 매치메이킹 완료 시 지정한 GS2-SeasonRating의 네임스페이스에 레이팅 계산 세션이 자동으로 생성됩니다.
기본값은 “disable” 입니다.

정의	설명
enable	활성화
disable	비활성화

collaborateSeasonRatingNamespaceId

string

{enableCollaborateSeasonRating} == “enable”

✓※

~ 1024자

시즌 레이팅 네임스페이스 GRN

매치메이킹 완료 시 레이팅 계산 세션이 생성되는 GS2-SeasonRating의 네임스페이스 GRN.
시즌 레이팅 연계가 활성화된 경우에만 적용됩니다.

※ enableCollaborateSeasonRating이(가) “enable” 이면 필수

collaborateSeasonRatingTtl

int

{enableCollaborateSeasonRating} == “enable”

60 ~ 7200

시즌 레이팅 결과 TTL(초)

매치메이킹 완료 후, GS2-SeasonRating을 통한 대전 결과 전송을 받아들이는 최대 대기 시간(초).
이 기간 내에 결과가 전송되지 않으면, 레이팅 세션은 만료됩니다. 60에서 7200초 범위로 지정합니다. 기본값은 60입니다.

※ enableCollaborateSeasonRating이(가) “enable” 이면 활성화

changeRatingScript

레이팅 값이 변경되었을 때 실행할 스크립트의 설정

Script 트리거 레퍼런스 - changeRating

joinNotification

참가 알림

새로운 플레이어가 개더링에 참가했을 때의 푸시 알림 설정.
기존 참가자에게 새로운 플레이어가 참가했음을 알려, 게임 클라이언트가 매치메이킹 UI를 업데이트할 수 있도록 합니다.

leaveNotification

이탈 알림

플레이어가 개더링에서 이탈했을 때의 푸시 알림 설정.
남은 참가자에게 플레이어가 이탈했음을 알려, 게임 클라이언트가 변경 사항을 반영할 수 있도록 합니다.

completeNotification

완료 알림

매치메이킹이 완료되었을 때(모든 역할 슬롯이 채워졌을 때)의 푸시 알림 설정.
모든 참가자에게 개더링이 가득 차 대전을 시작할 수 있음을 알립니다.

changeRatingNotification

레이팅 변동 알림

투표 처리 후 플레이어의 레이팅 값이 변동되었을 때의 푸시 알림 설정.
영향을 받은 플레이어에게 새로운 레이팅을 알려, 게임 클라이언트가 업데이트된 값을 표시할 수 있도록 합니다.

logSetting

로그 출력 설정

API 요청/응답 로그를 GS2-Log에 출력하기 위한 설정.
설정하면, 매치메이킹 조작(개더링 생성·참가·이탈, 투표, 레이팅 변동 등)이 모니터링 및 분석을 위해 로그로 출력됩니다.

createdAt

long

※

현재 시각

생성일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

updatedAt

long

※

현재 시각

최종 갱신일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

revision long 0 0 ~ 9223372036854775805 리비전

TransactionSetting

트랜잭션 설정

GS2-MegaField SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명
logSetting	LogSetting				로그 출력 설정
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

LogSetting

로그 출력 설정

GS2-Mission SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 미션 달성 보상 부여 시 사용되는 분산 트랜잭션 설정입니다.
missionCompleteScript	ScriptSetting				미션을 달성했을 때 실행할 스크립트 설정 Script 트리거 레퍼런스 - `missionComplete`
counterIncrementScript	ScriptSetting				카운터가 상승했을 때 실행할 스크립트 설정 Script 트리거 레퍼런스 - `counterIncrement`
receiveRewardsScript	ScriptSetting				보상을 받았을 때 실행할 스크립트 설정 Script 트리거 레퍼런스 - `receiveRewards`
completeNotification	NotificationSetting	✓			미션 태스크를 달성했을 때의 푸시 통지 미션 태스크의 달성 조건이 충족되었을 때 GS2-Gateway를 통해 전달되는 푸시 통지 설정입니다. 게임 클라이언트가 달성 상황을 즉시 UI에 반영할 수 있도록 합니다.
logSetting	LogSetting				로그 출력 설정 이 네임스페이스에 대한 API 요청·응답 로그의 출력 대상이 되는 GS2-Log의 네임스페이스를 지정합니다. 카운터 증가, 미션 달성, 보상 수령의 디버깅에 도움이 됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Money SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

타입

활성화 조건

필수

기본값

값 제한

설명

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.

description

string

~ 1024자

설명문

transactionSetting

트랜잭션 설정

머니 조작 시 트랜잭션의 처리 방법을 제어하는 설정입니다.

priority

문자열 열거형
enum {
“free”,
“paid”
}

✓

소비 우선순위

지갑에서 통화를 소비할 때, 유료 통화와 무료 통화 중 어느 쪽을 먼저 소비할지를 결정합니다.
“free"로 설정하면 무료 통화(단가=0)가 먼저 소비되고, 그 다음 단가가 높은 유료 통화가 소비됩니다.
“paid"로 설정하면 단가가 높은 유료 통화가 먼저 소비되고, 그 다음 무료 통화가 소비됩니다.

정의	설명
free	무료 통화를 우선해서 사용한다
paid	유료 통화를 우선해서 사용한다

shareFree

bool

✓

무료 통화 공유

무료 통화를 모든 지갑 슬롯 간에 공유할지 여부입니다.
활성화하면 무료 통화 잔액이 슬롯 0에서 다른 모든 슬롯으로 동기화되어, 서로 다른 플랫폼의 플레이어가 동일한 무료 통화 풀을 공유할 수 있습니다.
유료 통화는 이 설정과 관계없이 항상 슬롯별로 별도로 관리됩니다.

currency

문자열 열거형
enum {
  “JPY”,
  “USD”,
  “TWD”
}

✓

통화 종류

가격 설정과 자금결제법 준수 계산에 사용되는 실제 통화입니다.
유료 통화 가치 추적과 환불 의무 계산 시의 측정 단위를 결정합니다.
네임스페이스 생성 후에는 변경할 수 없습니다.

정의	설명
JPY	일본 엔
USD	미국 달러
TWD	대만 달러

appleKey

string

~ 1024자

Apple App Store 번들 ID

Apple App Store의 구매 영수증을 검증하는 데 사용되는 iOS 앱의 Bundle ID입니다.
iOS 기기로부터의 인앱 구매를 받으려면 필요합니다.

googleKey

string

~ 5120자

Google PlayStore 비밀 키

Google Play의 구매 영수증을 검증하는 데 사용되는 서비스 계정의 비밀 키입니다.
Android 기기로부터의 인앱 구매를 받으려면 필요합니다.

enableFakeReceipt

bool

false

가짜 영수증 활성화

테스트 목적으로 Unity Editor가 생성하는 가짜 구매 영수증을 허용할지 여부입니다.
개발/테스트 환경에서만 활성화해야 하며, 부정한 통화 지급을 방지하기 위해 운영 환경에서는 반드시 비활성화해야 합니다.
기본값은 false입니다.

createWalletScript

지갑 생성 시 스크립트

새로운 지갑이 처음 생성될 때 실행되는 스크립트입니다.
지갑은 최초 접근 시 자동으로 생성되므로, 플레이어가 통화 시스템에 처음 접근했을 때 이 스크립트가 트리거됩니다.

depositScript

잔액 충전 시 스크립트

지갑에 통화가 충전될 때 실행되는 스크립트입니다.
유료 통화 충전(스토어 구매)과 무료 통화 지급 양쪽에서 트리거됩니다.

withdrawScript

잔액 소비 시 스크립트

지갑에서 통화가 소비될 때 실행되는 스크립트입니다.
소비 우선순위 설정에 따라 유료 통화 또는 무료 통화가 차감될 때 트리거됩니다.

balance

double

0.0

0 ~ 281474976710653

미사용 잔액

이 네임스페이스 내 모든 사용자에 걸친 유료 통화의 미사용 잔액 합계로, 설정된 실제 통화 단위로 측정됩니다.
자금결제법 준수를 위해 미이행 의무 총액을 추적하는 데 사용됩니다.
이 값은 충전과 소비가 발생할 때마다 시스템에 의해 자동으로 관리됩니다.

logSetting

로그 출력 설정

API 요청/응답 로그를 GS2-Log에 출력하기 위한 설정입니다.
설정하면 지갑 조작(충전, 소비, 구매)이 모니터링, 감사, 분석을 위해 로그로 출력됩니다.

createdAt

long

※

현재 시각

생성일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

updatedAt

long

※

현재 시각

최종 갱신일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

revision

long

0 ~ 9223372036854775805

리비전

TransactionSetting

트랜잭션 설정

GS2-Money2 SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

타입 활성화 조건 필수 기본값 값 제한 설명

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.

description string ~ 1024자 설명문

transactionSetting

트랜잭션 설정

재화의 입금·출금 시 사용되는 분산 트랜잭션의 설정입니다.

currencyUsagePriority

문자열 열거형
enum {
“PrioritizeFree”,
“PrioritizePaid”
}

✓

소비 우선순위

지갑에서 출금할 때 유상 재화와 무상 재화 중 어느 것을 먼저 소비할지를 결정합니다. “PrioritizeFree"는 무상 재화를 우선하고, “PrioritizePaid"는 유상 재화를 우선합니다.

정의	설명
PrioritizeFree	무료 통화를 우선해서 사용한다
PrioritizePaid	유료 통화를 우선해서 사용한다

sharedFreeCurrency

bool

✓

무상 재화를 다른 슬롯과 공유할지 여부

활성화하면 무상 재화 잔액이 모든 지갑 슬롯(플랫폼) 간에 공유됩니다. 유상 재화는 슬롯별로 분리된 상태로 유지됩니다. 이 설정은 네임스페이스 생성 시에만 설정할 수 있으며, 이후에는 변경할 수 없습니다.

platformSetting

PlatformSetting

✓

스토어 플랫폼 설정

지원되는 각 스토어 플랫폼(Apple App Store, Google Play, 테스트용 Fake)의 설정입니다. 각 플랫폼에서의 영수증 검증에 필요한 인증 정보와 키를 포함합니다.

depositBalanceScript

지갑 잔액을 가산했을 때 실행할 스크립트의 설정

Script 트리거 레퍼런스 - deposit

withdrawBalanceScript

지갑 잔액을 소비했을 때 실행할 스크립트의 설정

Script 트리거 레퍼런스 - withdraw

verifyReceiptScript

영수증 검증을 실행했을 때 실행할 스크립트의 설정

Script 트리거 레퍼런스 - verifyReceipt

subscribeScript

string

~ 1024자

기간 결제를 신규 계약할 때 실행할 GS2-Script 스크립트 GRN(사용자 연결 변경 시에는 호출되지 않음/한 번 계약이 실효된 후 다시 계약한 경우에도 호출됨)

Script 트리거 레퍼런스 - subscribe

renewScript

string

~ 1024자

기간 결제를 갱신할 때 실행할 GS2-Script 스크립트 GRN

Script 트리거 레퍼런스 - renew

unsubscribeScript

string

~ 1024자

기간 결제를 해지할 때 실행할 GS2-Script 스크립트 GRN(사용자 연결 변경 시에는 호출되지 않음)

Script 트리거 레퍼런스 - unsubscribe

takeOverScript

기간 결제에 연결된 사용자를 변경할 때 실행할 스크립트의 설정

Script 트리거 레퍼런스 - takeOver

changeSubscriptionStatusNotification

기간 결제의 계약 상태가 변화했을 때의 푸시 알림

구독 상태가 변화했을 때(활성화, 갱신, 해지, 만료, 취소 등) GS2-Gateway를 통해 전송되는 푸시 알림 설정입니다. 게임 클라이언트가 구독 상태 변화에 실시간으로 대응할 수 있도록 합니다.

logSetting

로그 출력 설정

이 네임스페이스에 대한 API 요청·응답 로그의 출력 대상이 되는 GS2-Log의 네임스페이스를 지정합니다. 입금, 출금, 영수증 검증, 구독 이벤트의 추적에 유용합니다.

createdAt

long

※

현재 시각

생성일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

updatedAt

long

※

현재 시각

최종 갱신일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

revision long 0 0 ~ 9223372036854775805 리비전

TransactionSetting

트랜잭션 설정

GS2-News SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
version	string			~ 1024자	버전 배포된 뉴스 콘텐츠의 현재 버전 식별자입니다. 새 게시글 데이터가 업로드되거나 GitHub 저장소에서 동기화되면 자동으로 갱신됩니다. 이 값은 기밀 정보이며 클라이언트에는 공개되지 않습니다.
logSetting	LogSetting				로그 출력 설정 API 요청·응답 로그를 GS2-Log로 출력하기 위한 설정입니다. 설정하면 뉴스 관련 작업(게시글 조회, 콘텐츠 생성, Cookie 발급 등)이 모니터링과 분석을 위해 로그로 출력됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

LogSetting

로그 출력 설정

GS2-Quest SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 퀘스트 보상 지급 시 트랜잭션 처리 방식을 제어하는 설정입니다.
startQuestScript	ScriptSetting				퀘스트를 시작했을 때 실행할 스크립트 설정 Script 트리거 참조 - `startQuest`
completeQuestScript	ScriptSetting				퀘스트를 클리어했을 때 실행할 스크립트 설정 Script 트리거 참조 - `completeQuest`
failedQuestScript	ScriptSetting				퀘스트에 실패했을 때 실행할 스크립트 설정 Script 트리거 참조 - `failedQuest`
logSetting	LogSetting				로그 출력 설정 API 요청·응답 로그의 출력 대상이 되는 GS2-Log의 네임스페이스를 지정합니다. 퀘스트의 시작·클리어·실패 이벤트를 추적하는 데 사용됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Ranking SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting				트랜잭션 설정 랭킹 조작 시 트랜잭션의 처리 방법을 제어하는 설정입니다.
lastCalculatedAts	List<CalculatedAt>		[]	0 ~ 1000 items	최종 집계일시 리스트 각 카테고리의 글로벌 랭킹이 마지막으로 집계된 일시를 기록하는 타임스탬프 리스트입니다. 카테고리별로 1개의 엔트리가 유지되며, 재집계가 완료되면 해당 엔트리가 업데이트됩니다(신규 카테고리의 경우 새로운 엔트리가 추가됩니다).
logSetting	LogSetting				로그 출력 설정 랭킹 관련 조작 로그를 GS2-Log에 출력하기 위한 설정입니다. 설정하면 스코어 등록, 랭킹 취득, 구독 변경 등의 작업이 분석 및 감사를 위해 기록됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Ranking2 SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 랭킹 보상 지급에 사용되는 분산 트랜잭션 설정입니다. 입수 액션을 자동으로 실행하는 오토런, 전체의 성패를 보장하는 아토믹 커밋을 지원합니다.
logSetting	LogSetting				로그 출력 설정 API 요청·응답 로그의 출력 대상이 되는 GS2-Log의 네임스페이스를 지정합니다. 점수 등록이나 랭킹 보상 배포 추적에 사용됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Realtime SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

타입

활성화 조건

필수

기본값

값 제한

설명

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.

description

string

~ 1024자

설명문

transactionSetting

트랜잭션 설정

리얼타임 조작 시 트랜잭션 처리 방법을 제어하는 설정입니다.

serverType

문자열 열거형
enum {
“relay”
}

✓

서버 타입

실시간 통신을 위해 프로비저닝하는 게임 서버의 타입.
현재 “relay” 모드를 지원하며, 접속된 게임 클라이언트 간에 메시지를 전달하는 패킷 릴레이 서버를 제공합니다.

정의	설명
relay	패킷 릴레이

serverSpec

문자열 열거형
enum {
“realtime1.nano”
}

✓

서버 스펙

프로비저닝되는 게임 서버의 하드웨어 스펙 티어.
각 룸의 서버 인스턴스에 할당되는 컴퓨팅 리소스(CPU, 메모리)를 결정합니다. 현재 “realtime1.nano"를 지원합니다.

정의	설명
realtime1.nano	realtime1.nano

createNotification

룸 생성 완료 알림

룸의 프로비저닝이 완료되어 접속이 가능해졌을 때 트리거되는 푸시 알림 설정.
룸 생성은 비동기로 이루어지며(IP 주소, 포트, 암호화 키는 약간의 지연 후 할당됨), 이 알림을 통해 클라이언트에게 룸이 접속을 받을 준비가 되었음을 알립니다.

logSetting

로그 출력 설정

리얼타임 관련 조작 로그를 GS2-Log에 출력하기 위한 설정.
설정하면 룸 생성, 접속 이벤트, 메시지 릴레이 활동 등이 분석과 디버깅을 위해 기록됩니다.

createdAt

long

※

현재 시각

생성일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

updatedAt

long

※

현재 시각

최종 갱신일시

UNIX 시간・밀리초
※ 서버가 자동으로 설정

revision

long

0 ~ 9223372036854775805

리비전

TransactionSetting

트랜잭션 설정

GS2-Schedule SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting				트랜잭션 설정 스케줄 작업 실행 시 트랜잭션 처리 방식을 제어하는 설정입니다.
logSetting	LogSetting				로그 출력 설정 스케줄 관련 작업 로그를 GS2-Log로 출력하기 위한 설정입니다. 설정하면 이벤트 조회, 트리거 발동, 트리거 삭제 등의 작업이 분석 및 감사를 위해 기록됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Script SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting				트랜잭션 설정 스크립트가 트랜잭션 액션을 반환할 때 사용되는 분산 트랜잭션 설정입니다.
logSetting	LogSetting				로그 출력 설정 API 요청·응답 로그의 출력 대상이 되는 GS2-Log의 네임스페이스를 지정합니다. 스크립트 호출과 그 결과의 추적에 사용됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-SeasonRating SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 시즌 레이팅 결과 적용 시 사용되는 트랜잭션 처리 설정입니다.
logSetting	LogSetting				로그 출력 설정 투표용지 발행, 투표 제출, 레이팅 계산 등 시즌 레이팅 조작에 대한 로그 출력 설정입니다. 설정한 경우, 조작 로그가 지정한 GS2-Log 네임스페이스로 출력됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-SerialKey SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명
transactionSetting	TransactionSetting				트랜잭션 설정 시리얼 키 조작 시 트랜잭션의 처리 방법을 제어하는 설정입니다.
logSetting	LogSetting				로그 출력 설정 시리얼 코드의 발행·사용에 관한 API 요청·응답 로그를 출력할 GS2-Log의 네임스페이스를 지정합니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Showcase SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 진열대 조작 시 트랜잭션 처리 방법을 제어하는 설정입니다.
buyScript	ScriptSetting				구매를 실행하려고 할 때 실행하는 스크립트 설정 Script 트리거 레퍼런스 - `buy`
logSetting	LogSetting				로그 출력 설정 진열대 열람이나 상품 구매에 관한 API 요청·응답 로그를 출력하는 GS2-Log의 네임스페이스를 지정합니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-SkillTree SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting	✓			트랜잭션 설정 노드 해방·구속 조작을 실행할 때 사용되는 트랜잭션 처리 설정입니다. 소비 액션(해방 비용)과 입수 액션(구속 시 반환)이 GS2 트랜잭션 시스템을 통해 어떻게 처리되는지를 정의합니다.
releaseScript	ScriptSetting				노드 해방 시 실행할 스크립트 설정 Script 트리거 레퍼런스 - `release`
restrainScript	ScriptSetting				노드 해방 상태를 미해방 상태로 되돌릴 때 실행할 스크립트 설정 Script 트리거 레퍼런스 - `restrain`
logSetting	LogSetting				로그 출력 설정 노드 해방·구속·초기화 등 스킬 트리 조작에 대한 로그 출력 설정입니다. 설정한 경우, 조작 로그가 지정한 GS2-Log 네임스페이스로 출력됩니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-Stamina SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

	타입	필수	기본값	값 제한	설명
namespaceId	string	※		~ 1024자	네임스페이스 GRN ※ 서버가 자동으로 설정
name	string	✓		~ 128자	네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
description	string			~ 1024자	설명문
transactionSetting	TransactionSetting				트랜잭션 설정 스태미나 조작 시 트랜잭션의 처리 방법을 제어하는 설정입니다.
overflowTriggerScript	string			~ 1024자	오버플로우 트리거 스크립트 회복 시 스태미나가 오버플로우될 때 호출되는 GS2-Script의 GRN입니다. 시간 기반 회복으로 스태미나가 최대값을 초과하는 경우에 트리거되며, 초과분에 대한 커스텀 처리(예: 오버플로우분을 아이템으로 변환)가 가능합니다. Script 트리거 레퍼런스 - `overflow`
logSetting	LogSetting				로그 출력 설정 스태미나의 소비, 회복, 오버플로우 등의 조작을 GS2-Log에 기록하기 위한 로그 출력 설정입니다.
createdAt	long	※	현재 시각		생성일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
updatedAt	long	※	현재 시각		최종 갱신일시 UNIX 시간・밀리초 ※ 서버가 자동으로 설정
revision	long		0	0 ~ 9223372036854775805	리비전

TransactionSetting

트랜잭션 설정

GS2-StateMachine SDK API 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

모델

Namespace

네임스페이스

따라서 각 서비스의 이용을 시작하려면 먼저 네임스페이스를 생성해야 합니다.

상세

타입 활성화 조건 필수 기본값 값 제한 설명

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.

description string ~ 1024자 설명문

supportSpeculativeExecution

문자열 열거형
enum {
“enable”,
“disable”
}

“disable”

투기적 실행을 지원할지 여부

활성화하면 스테이트 머신 정의와 난수 상태가 Status 엔티티에 포함되어, 클라이언트가 서버 확인 전에 로컬에서 상태 전이를 시뮬레이션할 수 있게 됩니다. transactionSetting 설정이 필요합니다.

정의	설명
enable	활성화
disable	비활성화

transactionSetting

{supportSpeculativeExecution} == “enable”

트랜잭션 설정

스테이트 머신의 emit 액션 실행 시 트랜잭션 처리 방식을 제어하는 설정입니다. 투기적 실행을 활성화하는 경우 필요합니다.

※ supportSpeculativeExecution이(가) “enable” 이면 활성화

startScript

스테이트 머신을 시작했을 때 실행할 스크립트 설정

Script 트리거 레퍼런스 - start

passScript

스테이트 머신이 정상 종료되었을 때 실행할 스크립트 설정

Script 트리거 레퍼런스 - pass

errorScript

스테이트 머신이 이상 종료되었을 때 실행할 스크립트 설정

Script 트리거 레퍼런스 - error

lowestStateMachineVersion

long

스테이트 머신의 최저 버전

실행 가능한 스테이트 머신의 최저 버전입니다. 이 값보다 오래된 버전의 스테이트 머신으로 생성된 Status 인스턴스는 거부되며, 모든 실행 중인 인스턴스가 최신 정의를 사용하도록 보장됩니다.

logSetting