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들의 리스트

게임에 캐릭터가 없거나, 캐릭터가 아닌 플레이어를 포함하고자 하는 경우 리스트는 { 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 -- Exit in the middle of play
TPStashEvent.StageStatus.Timeout
TPStashEvent.StageStatus.Error -- Abnormal termination

선택

stage_playtime

스테이지 종료 시 스테이지 총 플레이 타임

선택

«ChangeCustomAbility

PlayStageWithInfrastructure»