カード収集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

    必須

    Lv1防具

    Lv2ロングソード（火）

    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