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이 반환됩니다. 호출에 실패할 경우 유니티 에디터 콘솔 TentuPlay debug mode에서 다음과 같은 메시지가 출력됩니다.

TPError||ERROR inserting table_name: exception_error_message

스테이지 시작 또는 종료 이벤트 발생 시점과 메소드 호출 시점이 일치하지 않을 경우

PlayerStage는 스테이지 시작과 끝에 이벤트 발생 시점과 함께 호출해야하나, 게임 특성상 메소드의 각 호출 시점과 실제 스테이지의 시작과 끝이 일치하지 않을 경우 stage_playtime 파라미터에 값이 반드시 들어가야합니다. 스테이지 끝 이벤트에서 옵션 파라미터인 stage_playtime에 값을 넣지 않게되면 분석 시 플레이 시간이 잘못 계산됩니다. 스테이지 클리어 시 걸리는 시간을 정확히 측정하여 넣기 어려운 경우라면 대략적인 시간이라도 이벤트 기록 시에 넣어주어야 합니다.

파라미터

이름 설명 필수 여부

player_uuid

플레이어의 고유 ID(캐릭터 ID가 아닌)로 Steam 사용자 ID나 Google Play 사용자 ID를 말함

필수

character_uuids

플레이어 내 캐릭터의 고유 ID들의 리스트

게임에 캐릭터가 없거나, 캐릭터가 아닌 플레이어를 포함하고자 하는 경우 리스트는 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

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

선택