카드수집형 RPG

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

유저는 게임을 플레이하면 미션을 완수할 수도 있고 특정 아이템을 이용하여 게임을 플레이하지 않고 미션을 건너뛸 수도 있습니다.

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

유저가 스테이지를 직접 플레이하는 경우 다음 메소드를 호출하세요.

스테이지 시작

  • 스테이지 시작에 재화가 사용되는 경우 아래와 같이 UseCurrency를 호출하세요.

    where_to_entity에는 entity.PlayStage를 넣습니다.
    메소드 파라미터 자료형 필수여부 비고

    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-1-1 (스테이지명)

  • 스테이지 시작 시 PlayStage를 호출하세요.

    • 더미 캐릭터 ID를 포함하여 스테이지 플레이에 활용하는 모든 캐릭터들을 character_uuids에 리스트 형태로 입력합니다.

    • stage_status에는 stageStatus.Start를 입력하세요.
    메소드 파라미터 자료형 필수여부 비고

    PlayStage

    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

    PlayStageWithEquipment

    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 로 구분해주세요.
    메소드 파라미터 자료형 필수여부 비고

    PlayStage

    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를 호출하세요.

메소드 파라미터 자료형 필수여부 비고

LevelUpCharacter

player_uuid

string

필수

character_uuid

string

필수

{키레네 uuid}

level_to

int

필수

2

level_from

int

선택

1

아이템 획득

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

  • 순수하게 스테이지 플레이만으로 화폐를 획득한 경우 GetCurrency를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    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를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    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

    GetEquipment

    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 }를 호출하세요.

  • "스테이지 퍼펙트 클리어"와 같이 특정 조건을 만족하여 보너스를 받는 경우에만 해당합니다.

  • Object 획득 메소드의 from_entity에는 entity.PlayStage가 아닌 entity.GetBonus를 입력하세요.

아래 예시는 보너스로 화폐 재화와 소비재를 획득하여 GetBouns에 GetConsumable과 GetCurrency를 추가로 호출한 경우를 보여줍니다.

메소드 파라미터 자료형 필수여부 비고

GetBonus

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

bonus_slug

string

필수

1-1-1 퍼펙트 클리어 보상

bonus_category_slug

string

필수

모험

is_automated

boolean

선택

FALSE
메소드 파라미터 자료형 필수여부 비고

GetConsumable

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

필수

경험의 물약 소형

item_quantity

float

필수

20

from_entity

선택

entity.GetBonus

from_category_slug

string

선택

모험

from_slug

string

선택

1-1-1 퍼펙트 클리어 보상
메소드 파라미터 자료형 필수여부 비고

GetCurrency

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

currency_slug

string

필수

골드

currency_quantity

float

필수

1000

currency_total_quantity

float

선택

999999

from_entity

선택

entity.GetBonus

from_category_slug

string

선택

모험

from_slug

string

선택

1-1-1 퍼펙트 클리어 보상

유저가 스테이지를 건너뛴 경우

유저가 스테이지를 직접 플레이하지 않고 클리어 티켓, 소탕권 등을 사용하여 미션을 자동으로 완료한 경우 다음 메소드를 호출하세요. 이 때는 결과 데이터만 수집할 수 있습니다.

스테이지 시작과 종료

  • 전투 스킵 아이템 사용한 경우 UseConsumable을 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    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를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    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를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    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를 호출하세요.

메소드 파라미터 자료형 필수여부 비고

LevelUpCharacter

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

level_to

int

필수

2

level_from

int

선택

1

아이템 획득

스테이지 결과를 통해 획득한 재화나 아이템을 기록하기 위해 각 Object별 획득 메소드인 Get{ 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-4-10
메소드 파라미터 자료형 필수여부 비고

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-4-10
메소드 파라미터 자료형 필수여부 비고

GetEquipment

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

필수

1성 은밀한 단검 (빛)

item_quantity

float

필수

1

from_entity

선택

entity.PlayStage

from_category_slug

string

선택

모험

from_slug

string

선택

1-4-10