TPStashEvent.PlayQuest

public int PlayQuest(
    string player_uuid,
    string character_uuid,
    string quest_slug,
    string quest_status,
    [string quest_category_slug = null]
);

설명

게임 내 퀘스트를 수행한 이벤트 데이터를 수집합니다. 퀘스트를 받거나 퀘스트를 종료할 경우 호출되어야하는 메소드입니다.

퀘스트는 '미션', '임무', '퀘스트' 등 특정 조건을 달성하고 정해진 보상을 받는 모든 시스템을 총칭하며 여기에는 일일 퀘스트, 시나리오 클리어 퀘스트, 이벤트 던전 등이 있습니다.

호출이 성공한 경우 1이, 실패한 경우 -1이 반환됩니다. 호출에 실패할 경우 유니티 에디터 콘솔 TentuPlay debug mode에서 다음과 같은 메시지가 출력됩니다.

TPError||ERROR inserting table_name: exception_error_message

파라미터

이름 설명 필수 여부

player_uuid

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

필수

character_uuid

플레이어 캐릭터의 고유 ID

게임에 캐릭터가 없거나, 캐릭터가 아닌 플레이어를 가리킬 경우 character_uuid를 TentuPlayKeyword._DUMMY_CHARACTER_ID_로 설정합니다.

필수

quest_slug

퀘스트의 고유 구분자

필수

quest_status

퀘스트 진행 상태

public enum questStatus {
    Accept,
    Clear,
    Fail,
    Abandon,
    Timeover
}
  • Accept: 능동적으로 퀘스트를 수락함

  • Clear: 퀘스트를 성공적으로 수행함

  • Fail: 퀘스트 수행 실패

  • Abandon: 능동적으로 퀘스트를 포기함

  • Timeover: 클리어하는데에 시간 제한이 있는 퀘스트(예: 5분 이내에 수행, 일일퀘스트)가 시간 초과로 인해 자동적으로 실패 또는 취소 처리됨

필수

quest_category_slug

퀘스트 카테고리명

선택