GS2-Limit 마스터 데이터 레퍼런스
마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스
마스터 데이터 포맷
{
"version": "2019-04-05",
"limitModels": [
{
"name": "[string]횟수 제한 모델명",
"metadata": "[string?]메타데이터",
"resetType": "[문자열 열거형]리셋 타이밍",
"resetDayOfMonth": "[int]리셋 날짜",
"resetDayOfWeek": "[문자열 열거형]리셋 요일",
"resetHour": "[int]리셋 시각",
"anchorTimestamp": "[long]경과 일수를 계산하는 기준 일시",
"days": "[int]리셋 일수"
}
]
}| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| version | string | ✓ | 2019-04-05 | 마스터 데이터 포맷 버전 | ||
| limitModels | List<LimitModel> | ~ 100 items | 횟수 제한 모델 횟수 제한 모델에는 사용 횟수를 리셋하는 타이밍을 설정할 수 있습니다. 리셋 간격은 “매일”, “매주”, “매월”, “리셋하지 않음”, “일정 일수마다” 5가지 중에서 선택할 수 있습니다. 또한, 횟수 제한의 최대값은 마스터 데이터 쪽에서는 고정하지 않습니다. 이는 게임 내 컨텍스트에 따라 허용되는 최대 횟수를 동적으로 변경할 수 있도록 하기 위함입니다. 예를 들어 스텝업 가챠처럼, - 구매 횟수 카운터가 3회 미만일 때 구매할 수 있는 상품 - 위 상품을 구매할 수 없을 때, 구매 횟수 카운터가 5회 미만이면 구매할 수 있는 다른 상품 과 같이, 상황에 따라 “최대 횟수"를 전환할 수 있는 설계를 상정하고 있습니다. |
모델
LimitModel
횟수 제한 모델
횟수 제한 모델에는 사용 횟수를 리셋하는 타이밍을 설정할 수 있습니다.
리셋 간격은 “매일”, “매주”, “매월”, “리셋하지 않음”, “일정 일수마다” 5가지 중에서 선택할 수 있습니다.
또한, 횟수 제한의 최대값은 마스터 데이터 쪽에서는 고정하지 않습니다.
이는 게임 내 컨텍스트에 따라 허용되는 최대 횟수를 동적으로 변경할 수 있도록 하기 위함입니다.
예를 들어 스텝업 가챠처럼,
- 구매 횟수 카운터가 3회 미만일 때 구매할 수 있는 상품
- 위 상품을 구매할 수 없을 때, 구매 횟수 카운터가 5회 미만이면 구매할 수 있는 다른 상품
과 같이, 상황에 따라 “최대 횟수"를 전환할 수 있는 설계를 상정하고 있습니다.
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| limitModelId | string | ※ | ~ 1024자 | 횟수 제한 모델 GRN
※ 서버가 자동으로 설정 | ||||||||||||||||||
| name | string | ✓ | ~ 128자 | 횟수 제한 모델명 횟수 제한 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||||
| metadata | string | ~ 2048자 | 메타데이터 메타데이터에는 임의의 값을 설정할 수 있습니다. 이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. | |||||||||||||||||||
| resetType | 문자열 열거형 enum { “notReset”, “daily”, “weekly”, “monthly”, “days” } | ✓ | 리셋 타이밍 이 횟수 제한 모델 하위의 카운터 값이 자동으로 0으로 리셋되는 타이밍을 결정합니다. notReset(영구적, 리셋 없음), daily(매일 지정된 시각에 리셋), weekly(지정된 요일에 리셋), monthly(지정된 날짜에 리셋), days(기준 일시로부터 일정 일수마다 리셋) 중에서 선택합니다. 모든 시각은 UTC입니다.
| |||||||||||||||||||
| resetDayOfMonth | int | {resetType} == “monthly” | ✓※ | 1 ~ 31 | 리셋 날짜 resetType이 “monthly"인 경우 카운터가 리셋되는 날짜(일)입니다. 1~31 사이의 값이 유효합니다. 지정한 날짜가 해당 월의 일수를 초과하는 경우(예: 2월의 31일), 해당 월의 마지막 날에 리셋됩니다. ※ resetType이(가) “monthly” 이면 필수 | |||||||||||||||||
| resetDayOfWeek | 문자열 열거형 enum { “sunday”, “monday”, “tuesday”, “wednesday”, “thursday”, “friday”, “saturday” } | {resetType} == “weekly” | ✓※ | 리셋 요일 resetType이 “weekly"인 경우 카운터가 리셋되는 요일입니다. 이 요일의 resetHour(UTC)로 지정된 시각에 리셋됩니다.
※ resetType이(가) “weekly” 이면 필수 | ||||||||||||||||||
| resetHour | int | {resetType} in [“monthly”, “weekly”, “daily”] | ✓※ | 0 ~ 23 | 리셋 시각 daily, weekly, monthly 리셋 타입에서 카운터가 리셋되는 UTC 시각(0~23)입니다. 예를 들어 값이 0이면 UTC 자정에 카운터가 리셋됩니다. ※ resetType이(가) “monthly”,“weekly”,“daily"이면 필수 | |||||||||||||||||
| anchorTimestamp | long | {resetType} == “days” | ✓※ | 경과 일수를 계산하는 기준 일시 UNIX 시간(밀리초) ※ resetType이(가) “days” 이면 필수 | ||||||||||||||||||
| days | int | {resetType} == “days” | ✓※ | 1 ~ 2147483646 | 리셋 일수 resetType이 “days"인 경우 카운터 리셋 간격(일수)입니다. 리셋 주기는 anchorTimestamp를 기준으로 계산됩니다. 예를 들어 days가 7이고 anchorTimestamp가 월요일 정오라면, 매주 월요일 정오에 카운터가 리셋됩니다. ※ resetType이(가) “days” 이면 필수 |