TPStashEvent.PlayStage

public int PlayStage(
    string player_uuid,
    string[] character_uuids,
    stageType stage_type,
    string stage_slug,
    [string stage_category_slug = null],
    [string stage_level = null],
    [int? stage_score = null],
    [stageStatus stage_status = stageStatus.Unknown],
    [int? stage_playtime = null]
);

説明

ゲームの各種ステージをプレイしたデータを収集します。ステージの開始・終了などのイベントが発生すると必ず呼び出されるメソッドであり、ステージのプレイと関係している分析モデルに使用されます。

データのアップロードに成功した場合1をリターンし、成功できなかった場合には-1をリターンします。-1リターンとなった場合TentuPlay debug modeに設定されている状態でUnity Editorを使用している場合、Unity Editorコンソールから以下のメッセージが表示されます。

TPError||ERROR inserting table_name: exception_error_message

ステージの開始・終了のイベント発生タイミングとメソッドの呼び出しが一致しない場合の注意事項

PlayerStageは、ステージ開始と終了でイベント発生するタイミングと同時に呼び出しますが、ゲームの特徴によりメソッドの各呼び出しタイミングと実際のステージ開始と終了が一致しない場合、stage_playtimeのパラメータに必ず数値を入れる必要があります。ステージ終了のイベントでオプションパラメータである「stage_playtime」に何も入れない場合、分析の際に誤ったプレイタイムが計算されます。ステージクリアにかかる時間を想定して入れることが難しい場合、大体の時間をイベント記録の際に入れてください。

パラメータ

名前 説明 必須か

player_uuid

プレイヤーの固有ID

必須

character_uuids

プレイヤー内キャラクターの固有IDのList

ゲームにキャラクターがない、もしくはキャラクターではなくプレイヤーを示す場合、Listは string[] { TentuPlayKeyword._DUMMY_CHARACTER_ID_ }になる。

必須

stage_type

ステージの種類

public enum stageType {
    Unknown,
    PvP,
    PvE
}

必須

stage_slug

ゲームステージの固有識別子

必須

stage_category_slug

ゲームのステージタイプを区分けできるカテゴリー名

オプション

stage_level

ステージのレベルストリング

オプション

stage_score

ステージ終了時のスコア

オプション

stage_status

ステージ状態

public enum stageStatus {
    Start,
    Win,
    Lose,
    Draw,   //引き分け
    Quit,   //途中で放棄
    Timeout,
    Error   //エラーによる終了
}

オプション

stage_playtime

ステージ終了時、ステージの合計プレイタイム

オプション