Script on Game Server Services | Docs

트랜잭션 설정(V2)

이 네임스페이스가 발행하는 트랜잭션을 어떻게 실행할지 정하는 설정입니다. 설정하는 항목은 실행에 사용하는 GS2-Distributor 네임스페이스와, 트랜잭션에 포함된 액션을 한 건씩 실행해 앞서 실행된 액션의 결과를 후속 액션에서 사용할 수 있게 할지, 한꺼번에 동시에 실행해 응답 시간을 줄일지의 2가지뿐입니다.
새로 생성하는 네임스페이스에서는 이쪽을 설정하십시오. 이것으로 대체되어 비권장이 된 transactionSetting은 이쪽이 설정되어 있지 않은 동안에만 사용됩니다.

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

※

네임스페이스

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

상세

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

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

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

description string ~ 1024자 설명문

transactionSettingV2

트랜잭션 설정(V2)

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 0 ~ 9223372036854775805 리비전

TransactionSettingV2

트랜잭션 설정(V2)

GS2-Money2 SDK API 레퍼런스

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

모델

Namespace

네임스페이스

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

상세

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

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

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

description string ~ 1024자 설명문

transactionSettingV2

트랜잭션 설정(V2)

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

※

네임스페이스

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

상세

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

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

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

description string ~ 1024자 설명문

transactionSettingV2

트랜잭션 설정(V2)

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

※

네임스페이스

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

상세

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

namespaceId

string

※

~ 1024자

네임스페이스 GRN

※ 서버가 자동으로 설정

name

string

✓

~ 128자

네임스페이스 이름

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

description string ~ 1024자 설명문

supportSpeculativeExecution

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

“disable”

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

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

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

transactionSettingV2

트랜잭션 설정(V2)

startScript

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

Script 트리거 레퍼런스 - start

passScript

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

Script 트리거 레퍼런스 - pass

errorScript

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

Script 트리거 레퍼런스 - error

lowestStateMachineVersion

long

스테이트 머신의 최저 버전

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

logSetting