放置系ゲーム

操作不要のオートプレイでゲームが進み、財貨が増える放置系ゲームの場合は以下のようにプレイに関するメソッドを呼び出して下さい。

ステージ開始と終了

放置系ゲームはステージのプレイ回数が非常に多いため、すべてのステージを記録せずにハードル（ボスステージなど）として設定した特定のステージをベースに、ステージをブロック単位でまとめて記録します。

各ステージブロックを開始またはクリアした場合、以下のようにPlayStageを呼び出します。

次の適用例では10ステージごとにハードルを設定した場合にステージの開始と終了を記録するためにどのように PlayStage メソッドを適用すべきかを確認することができます。

ステージブロックの開始
メソッド パラメータ データ型 必須 備考

PlayStage

player_uuid

string

必須

character_uuids

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

必須

stageType.PvE

stage_slug

string

必須

1-1

stage_category_slug

string

オプション

ブロンズ寿司

stage_level

string

オプション

1

stage_score

int

オプション

null

stage_status

オプション

stageStatus.Start

stage_playtime

int

オプション

null
ステージブロックの終了
メソッド パラメータ データ型 必須 備考

PlayStage

player_uuid

string

必須

character_uuids

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

必須

stageType.PvE

stage_slug

string

必須

1-1

stage_category_slug

string

オプション

ブロンズ寿司

stage_level

string

オプション

1

stage_score

int

オプション

null

stage_status

オプション

stageStatus.Win

stage_playtime

int

オプション

null
次のステージブロックの開始
メソッド パラメータ データ型 必須 備考

PlayStage

player_uuid

string

必須

character_uuids

string

必須

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

必須

stageType.PvE

stage_slug

string

必須

1-10

stage_category_slug

string

オプション

ブロンズ寿司

stage_level

string

オプション

10

stage_score

int

オプション

null

stage_status

オプション

stageStatus.Start

stage_playtime

int

オプション

null

財貨の獲得と使用

放置系ゲームでは頻繁に獲得するSoft Currency（ゲームプレイで獲得する財貨）はいちいち記録しません。

Soft Currencyの使用とHard Currencyの獲得、そして使用ログを記録するには以下のようにGetCurrencyとUseCurrencyメソッドを呼び出してください。

  • 放置系ゲームでゲームプレイ全般に影響するInfrastructureアイテムを獲得する場合、以下のように UseCurrency とGetInfrastructureメソッドを呼び出してください。

    ゴールドを使用してテーブル開放
    メソッド パラメータ データ型 必須 備考

    UseCurrency

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    必須

    gold

    currency_quantity

    float

    必須

    2500

    currency_total_quantity

    float

    オプション

    285700

    where_to_entity

    オプション

    entity.GetInfraStructure

    where_to_category_slug

    string

    オプション

    テーブル

    where_to_slug

    string

    オプション

    2番テーブル
    キャッシュを使用してテーブル開放
    メソッド パラメータ データ型 必須 備考

    UseCurrency

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    必須

    cash

    currency_quantity

    float

    必須

    20

    currency_total_quantity

    float

    オプション

    26

    where_to_entity

    オプション

    entity.GetInfraStructure

    where_to_category_slug

    string

    オプション

    テーブル

    where_to_slug

    string

    オプション

    2番テーブル
    テーブルの獲得
    メソッド パラメータ データ型 必須 備考

    GetInfrastructure

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    必須

    2番テーブル

    item_quantity

    float

    必須

    1

    from_entity

    オプション

    entity.UseCurrency

    from_category_slug

    string

    オプション

    テーブル

    from_slug

    string

    オプション

    2番テーブル

  • 重要なアイテムを獲得し、そのボーナスとして特定のオブジェクトを入手する場合、以下のように GetBonus と Get{ Object } メソッドを呼び出してください。

    GetBonusメソッドのis_automatedパラメータにはユーザーがボーナスを獲得するための行為（例えばクリックやタッチ）が求められる場合は FALSE を、何も操作しなくても自動的にボーナスを獲得する場合は TRUE の値を入力してください。
    メソッド パラメータ データ型 必須 備考

    GetBonus

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    bonus_slug

    string

    必須

    スキルポイント

    bonus_category_slug

    string

    必須

    テーブル

    is_automated

    boolean

    オプション

    FALSE
    メソッド パラメータ データ型 必須 備考

    GetCurrency

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    必須

    cash

    currency_quantity

    float

    必須

    5

    currency_total_quantity

    float

    オプション

    46

    from_entity

    オプション

    entity.GetBonus

    from_category_slug

    string

    オプション

    テーブル

    from_slug

    string

    オプション

    Lv10にスキルアップ

  • 財貨を使ってレベルアップする場合、UseCurrencyとLevelUpInfrastructureを呼び出してください。

    メソッド パラメータ データ型 必須 備考

    UseCurrency

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    必須

    gold

    currency_quantity

    float

    必須

    128930

    currency_total_quantity

    float

    オプション

    342300

    where_to_entity

    オプション

    entity.LevelUpInfrastructre

    where_to_category_slug

    string

    オプション

    テーブル

    where_to_slug

    string

    オプション

    1番テーブル
    メソッド パラメータ データ型 必須 備考

    LevelUpInfrastructure

    player_uuid

    string

    必須

    character_uuid

    string

    必須

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    必須

    1番テーブル

    item_level_to

    int

    必須

    10

    item_level_from

    int

    オプション

    1