카드수집형 RPG
서머너즈워, 마블퓨처파이트와 같이 다양한 캐릭터나 카드를 수집하고 플레이 하는 형식의 게임인 경우, 아래와 같이 메소드를 호출하세요.
유저는 게임을 플레이하면 미션을 완수할 수도 있고 특정 아이템을 이용하여 게임을 플레이하지 않고 미션을 건너뛸 수도 있습니다.
유저가 스테이지를 플레이하는 경우
유저가 스테이지를 직접 플레이하는 경우 다음 메소드를 호출하세요.
스테이지 시작
-
스테이지 시작에 재화가 사용되는 경우 아래와 같이
UseCurrency
를 호출하세요.where_to_entity
에는entity.PlayStage
를 넣습니다.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug
string
필수
스테미나
currency_quantity
float
필수
8
currency_total_quantity
float
선택
99999
where_to_entity
선택
entity.PlayStage
where_to_category_slug
string
선택
모험
(스테이지 유형)where_to_slug
string
선택
1-1-1
(스테이지명) -
스테이지 시작 시
PlayStage
를 호출하세요.-
더미 캐릭터 ID를 포함하여 스테이지 플레이에 활용하는 모든 캐릭터들을
character_uuids
에 리스트 형태로 입력합니다. -
stage_status
에는stageStatus.Start
를 입력하세요.
메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
, { 니케uuid }, { 아가멤논uuid }, { 천향uuid }, { 백설연uuid }, { 캐츠시uuid }stage_type
필수
stageType.PvE
stage_slug
string
필수
1-1-1
stage_category_slug
string
선택
모험
stage_level
string
선택
1
stage_score
int
선택
null
stage_status
선택
stageStatus.Start
stage_playtime
int
선택
null
-
-
스테이지 플레이 시 캐릭터가 아이템을 장착하고 있다면
PlayStageWithEquipment
를 아이템별로 호출하세요.메소드
파라미터
자료형
필수여부
비고
장비 A
장비 B
player_uuid
string
필수
character_uuid
string
필수
{백설연 uuid}
item_slug
string
필수
1 레벨 방어구
2 레벨 롱소드 (불)
stage_slug
string
선택
1-1-1
stage_type
선택
stageType.PvE
stage_category_slug
string
선택
모험
스테이지 종료
-
스테이지 종료 시
PlayStage
를 호출하세요.stage_status
값은 게임 종료 상황에 따라 Win, Lose, Quit 로 구분해주세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
, { 니케uuid }, { 아가멤논uuid }, { 천향uuid }, { 백설연uuid }, { 캐츠시uuid }stage_type
필수
stageType.PvE
stage_slug
string
필수
1-1-1
stage_category_slug
string
선택
모험
stage_level
string
선택
1
stage_score
int
선택
3
stage_status
선택
stageStatus.Win
stage_playtime
int
선택
30
캐릭터 레벨업
스테이지 플레이로 특정 캐릭터가 레벨업한 경우 LevelUpCharacter
를 호출하세요.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
{키레네 uuid} |
|
level_to |
int |
필수 |
|
|
level_from |
int |
선택 |
|
아이템 획득
스테이지 플레이 도중 아이템 획득 시 아래와 각 아이템 Object별 획득 메소드를 호출하세요.
-
순수하게 스테이지 플레이만으로 화폐를 획득한 경우
GetCurrency
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug
string
필수
골드
currency_quantity
float
필수
4947
currency_total_quantity
float
선택
999999
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
모험
from_slug
string
선택
1-1-1
-
순수하게 스테이지 플레이만으로 소비재(Consumable)를 획득한 경우
GetConsumable
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
필수
경험의 물약 대형
item_quantity
float
필수
29
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
모험
from_slug
string
선택
1-1-1
-
순수하게 스테이지 플레이만으로 장비(Equipment)를 획득한 경우
GetEquipment
를 호출하세요.메소드
파라미터
자료형
필수여부
비고
장비 A
장비 B
player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
필수
1성 은밀한 단검 (빛)
1성 병사의 검 (불)
item_quantity
float
필수
1
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
모험
from_slug
string
선택
1-1-1
보너스 획득
스테이지 플레이와 연계하여 보너스를 받는 경우 GetBonus
와 함께 보너스로 획득하는 Object 획득 메소드인 Get{ Object }
를 호출하세요.
|
아래 예시는 보너스로 화폐 재화와 소비재를 획득하여 GetBouns
에 GetConsumable
과 GetCurrency
를 추가로 호출한 경우를 보여줍니다.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
bonus_slug |
string |
필수 |
|
|
bonus_category_slug |
string |
필수 |
|
|
is_automated |
boolean |
선택 |
|
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
item_slug |
string |
필수 |
|
|
item_quantity |
float |
필수 |
|
|
from_entity |
선택 |
|
||
from_category_slug |
string |
선택 |
|
|
from_slug |
string |
선택 |
|
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
currency_slug |
string |
필수 |
|
|
currency_quantity |
float |
필수 |
|
|
currency_total_quantity |
float |
선택 |
|
|
from_entity |
선택 |
|
||
from_category_slug |
string |
선택 |
|
|
from_slug |
string |
선택 |
|
유저가 스테이지를 건너뛴 경우
유저가 스테이지를 직접 플레이하지 않고 클리어 티켓, 소탕권 등을 사용하여 미션을 자동으로 완료한 경우 다음 메소드를 호출하세요. 이 때는 결과 데이터만 수집할 수 있습니다.
스테이지 시작과 종료
-
전투 스킵 아이템 사용한 경우
UseConsumable
을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug
string
필수
소탕권
item_quantity
float
필수
1
where_to_entity
선택
entity.PlayStage
where_to_category_slug
string
선택
모험
where_to_slug
string
선택
1-4-10
-
스테이지 시작 시 필요한 재화를 소비하는 경우
UseCurrency
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug
string
필수
스태미나
currency_quantity
float
필수
8
currency_total_quantity
float
선택
99999
where_to_entity
선택
entity.PlayStage
where_to_category_slug
string
선택
모험
where_to_slug
string
선택
1-4-10
-
전투 스킵 아이템을 사용한 경우 스테이지 종료 시점에서
PlayStage
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
TentuPlayKeyword._DUMMY_CHARACTER_ID_
stage_type
필수
stageType.PvE
stage_slug
string
필수
1-4-10
stage_category_slug
string
선택
모험
stage_level
string
선택
44
stage_score
int
선택
null
stage_status
선택
stageStatus.Win
stage_playtime
int
선택
0
캐릭터 레벨업
스테이지 플레이를 통해 특정 캐릭터가 레벨업한 경우 LevelUpCharacter
를 호출하세요.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
level_to |
int |
필수 |
|
|
level_from |
int |
선택 |
|
아이템 획득
스테이지 결과를 통해 획득한 재화나 아이템을 기록하기 위해 각 Object별 획득 메소드인 Get{ Object }
를 호출하세요.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
currency_slug |
string |
필수 |
|
|
currency_quantity |
float |
필수 |
|
|
currency_total_quantity |
float |
선택 |
|
|
from_entity |
선택 |
|
||
from_category_slug |
string |
선택 |
|
|
from_slug |
string |
선택 |
|
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
item_slug |
string |
필수 |
|
|
item_quantity |
float |
필수 |
|
|
from_entity |
선택 |
|
||
from_category_slug |
string |
선택 |
|
|
from_slug |
string |
선택 |
|
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
|
|
item_slug |
string |
필수 |
|
|
item_quantity |
float |
필수 |
|
|
from_entity |
선택 |
|
||
from_category_slug |
string |
선택 |
|
|
from_slug |
string |
선택 |
|