콘솔로 이동

카드수집형 RPG

서머너즈워, 마블퓨처파이트와 같이 다양한 캐릭터를 수집, 플레이 하는 형식의 게임인 경우, 아래와 같이 메소드를 호출하세요.

유저가 직접 스테이지를 플레이하는 경우

스테이지 시작

  • 스테이지 시작에 재화가 사용되는 경우 아래와 같이 UseCurrency 메소드를 호출하세요
UseCurrency 메소드의 where_to_entity 는 entity.PlayStage, where_to_category_slug 는 스테이지 종류, where_to_slug 는 스테이지명을 입력합니다.
UseCurrency
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug* { 스테미나 }
currency_quantity* 8
currency_total_quantity 99999
where_to_entity entity.PlayStage
where_to_category_slug { 모험 }
where_to_slug { 1-1-1 }


  • 스테이지 시작 시 PlayStage 메소드를 호출하세요.
PlayStage 메소드의 stage_status 값은 stageStatus.Start 로 입력하세요.
스테이지 플레이에 활용하는 모든 캐릭터들을 character_uuids에 리스트 형태로 입력하세요.
더미 캐릭터와 같이 유저(계정)를 반영하는 캐릭터는 PlayStage 메소드의 character_uuid 에 항상 포함시켜야 합니다.
PlayStage
player_uuid* { player_uuid }
character_uuid* [TentuPlayKeyword._DUMMY_CHARACTER_ID_, 니케uuid, 아가멤논uuid, 천향uuid, 백설연uuid, 캐츠시uuid]
stage_type* stageType.PvE
stage_slug* { 1-1-1 }
stage_category { 모험 }
stage_level 1
stage_score null
stage_status stageStatus.Start
stage_playtime null


  • PlayStageWithEquipment 를 호출하여 스테이지 플레이 시 캐릭터가 장착하고 있는 아이템을 아래와 같이 각 캐릭터 별로 기록해주세요.
PlayStageWithEquipment
player_uuid* { player_uuid } { player_uuid }
character_uuid* { 백설연 uuid } { 백설연 uuid }
item_slug * { 1 레벨 방어구 } { 2 레벨 롱소드 (불) }
stage_slug* { 1-1-1 } { 1-1-1 }
stage_type stageType.PvE stageType.PvE
stage_category_slug { 모험 } { 모험 }


스테이지 종료

  • 스테이지 종료 시 아래와 같이 PlayStage 메소드를 호출하세요.

PlayStage 메소드의 stage_status 값은 게임 종료 상황에 따라 Win, Lose, Quit 로 구분해주세요.
PlayStage
player_uuid* { player_uuid }
character_uuid* [TentuPlayKeyword._DUMMY_CHARACTER_ID_, 니케uuid, 아가멤논uuid, 천향uuid, 백설연uuid, 캐츠시uuid]
stage_type* stageType.PvE
stage_slug { 1-1-1 }
stage_category { 모험 }
stage_level 1
stage_score 3
stage_status stageStatus.Win
stage_playtime 30


캐릭터 레벨업

  • 스테이지 플레이를 통해 특정 캐릭터가 레벨업 한 경우 LevelUpCharacter 메소드를 호출하세요.
LevelUpCharacter
player_uuid* { player_uuid }
character_uuid* { 키레네uuid }
level_to* 2
level_from 1


아이템 획득

스테이지 플레이 도중 아이템 획득 시 아래와 각 아이템 Object 별 획득 메소드를 호출하세요

  • 순수하게 스테이지 플레이만으로 화폐를 획득한 경우 아래와 같이 GetCurrency 메소드를 호출하세요.
GetCurrency
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug* { 골드 }
currency_quantity* 4947
currency_total_quantity 999999
from_entity entity.PlayStage
from_category_slug { 모험 }
from_slug { 1-1-1 }


  • 순수하게 스테이지 플레이만으로 소비재(Consumable)를 획득한 경우 아래와 같이 GetConsumable 메소드를 호출하세요.
GetConsumable
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 경험의 물약 특대형 }
item_quantity* 29
from_entity entity.PlayStage
from_category_slug { 모험 }
from_slug { 1-1-1 }


  • 순수하게 스테이지 플레이만으로 장비(Equipment)를 획득한 경우 아래와 같이 GetEquipment 메소드를 호출하세요.
GetEquipment
player_uuid* { player_uuid } { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_ TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 1성 은밀한 단검 (빛) } { 1성 병사의 검 (불) }
item_quantity* 1 1
from_entity entity.PlayStage entity.PlayStage
from_category_slug { 모험 } { 모험 }
from_slug { 1-1-1 } { 1-1-1 }


보너스 획득

  • 스테이지 플레이와 연계하여 보너스를 제공하는 경우 아래와 같이 GetBonus와 함께 보너스로 획득하는 Object 획득 메소드를 호출하세요. 아래 예시는 GetConsumable 메소드를 추가로 호출하였습니다.

"스테이지 퍼펙트 클리어" 와 같이 스테이지 플레이 결과의 특정 조건을 만족하는 경우 얻는 보너스의 경우 GetBonus 와 함께 각 Object 별 메소드를 호출하세요. 여기서 Object 획득 메소드의 from_entity는 entity.PlayStage가 아닌 entity.GetBonus로 기록하세요.
GetBonus
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
bonus_slug* { 1-1-1 퍼펙트 클리어 보상 }
bonus_category_slug { 모험 }
is_automated* FALSE


GetConsumable
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 경험의 물약 소형 }
item_quantity* 20
from_entity entity.GetBonus
from_category_slug { 모험 }
from_slug { 1-1-1 퍼펙트 클리어 보상 }


GetCurrency
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
bonus_slug* { 1-1-1 퍼펙트 클리어 보상 }
bonus_category_slug { 모험 }
is_automated* FALSE


유저가 스테이지를 스킵하여 결과만 수집하는 경우

유저가 스테이지를 직접 플레이하지 않고 클리어 티켓, 소탕권 등을 사용하여 결과만 수집하는 경우 아래와 같이 메소드를 호출하세요.

스테이지 시작과 종료

  • 전투 스킵 아이템 사용한 경우 아래와 같이 UseConsumable 을 호출하세요
UseConsumable
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 소탕권 }
item_quantity* 1
where_to_entity entity.PlayStage
where_to_category_slug { 모험 }
where_to_slug { 1-4-10 }


  • 스테이지 시작 시 필요한 재화를 소비하는 경우 UseCurrency 를 호출하세요
UseCurrency
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug* { 스테미나 }
currency_quantity* 8
currency_total_quantity 99999
where_to_entity entity.PlayStage
where_to_category_slug { 모험 }
where_to_slug { 1-4-10 }


  • 전투를 스킵하는 아이템을 사용한 경우 스테이지 종료 시점에서 PlayStage 메소드를 호출하세요.
PlayStage
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
stage_type* stageType.PvE
stage_slug* { 1-4-10 }
stage_category_slug { 모험 }
stage_level 44
stage_score null
stage_status stageStatus.Win
stage_playtime 0


캐릭터 레벨업

  • 스테이지 플레이를 통해 특정 캐릭터가 레벨업 한 경우 LevelUpCharacter 메소드를 호출하세요.
LevelUpCharacter
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
level_to* 2
level_from 1


아이템 획득

  • 스테이지 결과를 통해 획득한 재화나 아이템을 기록하기 위해 아래와 같이 각 Object 별 획득 메소드를 호출하세요.
GetCurrency
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
currency_slug* { 골드 }
currency_quantity 4947
currency_total_quantity 999999
from_entity entity.PlayStage
from_category_slug { 모험 }
from_slug { 1-4-10 }


GetConsumable
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 경험의 물약 특대형 }
item_quantity* 29
from_entity entity.PlayStage
from_category_slug { 모험 }
from_slug { 1-4-10}


GetEquipment
player_uuid* { player_uuid }
character_uuid* TentuPlayKeyword._DUMMY_CHARACTER_ID_
item_slug* { 1성 은밀한 단검 (빛) }
item_quantity* 1
from_entity entity.PlayStage
from_category_slug { 모험 }
from_slug { 1-4-10 }