게임 시작

신규 유저 및 기존 유저의 게임 시작 시 아래와 같이 메소드를 호출하세요.

신규 가입

새로운 유저가 게임에 가입하는 시점에 다음 메소드를 호출하세요.

  • 신규 유저의 가입 최초 1회에만 아래와 같이 Join 메소드를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    Join

    player_uuid

    string

    필수

    정확한 리텐션 집계를 위해 Join 메소드 호출 후 바로 TPUploadData 메소드를 호출하는 것을 권장합니다.

  • 신규 유저가 회원가입 후 바로 로그인까지 진행한 경우 아래와 같이 LoginApp 메소드를 호출하세요

    메소드 파라미터 자료형 필수여부 비고

    LoginApp

    player_uuid

    string

    필수

    app_version

    string

    선택

    게임 클라이언트 버전

로그인

유저가 게임에 접속하는 시점에 다음 메소드를 호출하세요.

  • 유저가 게임에 접속할 때 LoginApp 메소드를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    LoginApp

    player_uuid

    string

    필수

    app_version

    string

    선택

    게임 클라이언트 버전

  • 유저가 게임에 접속한 후 캐릭터를 생성할 때 GetCharacter 메소드를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    GetCharacter

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    characterarchetype_slug

    string

    필수

    캐릭터 아키타입의 고유 구분자

  • 유저가 생성해둔 특정 캐릭터로 로그인하는 순간 LoginAsCharacter 메소드를 호출하세요.

    메소드 파라미터 자료형 필수여부 비고

    LoginAsCharacter

    player_uuid

    string

    필수

    character_uuid

    string

    필수

캐릭터 생성 단계가 없거나, 다양한 캐릭터가 없는 경우에도 GetCharacter와 LoginAsCharacter 메소드를 호출해야 합니다.

별도의 캐릭터 생성 로직이 없다면 character_uuid에 TentuPlayKeyword._DUMMY_CHARACTER_ID_를 입력하세요.