TPStashEvent.PlayStage

TPStashEvent.PlayStage(
    userId,
    character_uuids,
    stage_type,
    stage_slug,
    stage_category_slug,
    stage_level --[[Optional--]],
    stage_score --[[Optional--]],
    stage_status --[[Optional--]],
    stage_playtime --[[Optional--]]
)

説明

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

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

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

パラメータ

名前 説明 必須か

UserId

Robloxが提供するプレイヤーの固有ユーザーID(キャラクターIDではない): Player.UserId

必須

character_uuids

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

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

必須

stage_type

ステージの種類

TPStashEvent.StageType.Unknown
TPStashEvent.StageType.PvP
TPStashEvent.StageType.PvE

必須

stage_slug

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

必須

stage_category_slug

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

オプション

stage_level

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

オプション

stage_score

ステージ終了時のスコア

オプション

stage_status

ステージ状態

TPStashEvent.StageStatus.Start
TPStashEvent.StageStatus.Win
TPStashEvent.StageStatus.Lose
TPStashEvent.StageStatus.Draw  --引き分け
TPStashEvent.StageStatus.Quit   --途中で放棄
TPStashEvent.StageStatus.Timeout
TPStashEvent.StageStatus.Error --エラーによる終了

オプション

stage_playtime

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

オプション