TPStashEvent.GetCharacter

public int GetCharacter(
    string player_uuid,
    string character_uuid,
    string characterarchetype_slug,
    [entity from_entity = entity.None],
    [string from_category_slug = null],
    [string from_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_로 설정합니다.

필수

characterarchetype_slug

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

필수

from_entity

캐릭터를 획득한 경로나 획득하게 한 행동

개체
public enum entity {
    None,
    Etc,
    Join,
    LoginApp,
    LoginAsCharacter,
    InAppPurchase,
    ShopPurchase,
    Trade,
    WatchAd,
    PlayQuest,
    GetBonus,
    ChangeCharacterArchetype,
    ChangeStat,
    ChangeCustomAbility,
    PlayStage,
    GetCharacter,
    GetCurrency,
    GetInfrastructure,
    GetPet,
    GetToken,
    GetConsumable,
    GetMaterial,
    GetEquipment,
    GetCostume,
    GetRandomBox,
    UseCurrency,
    EquipInfrastructure,
    EquipPet,
    UseToken,
    UseConsumable,
    UseMaterial,
    EquipEquipment,
    EquipCostume,
    OpenRandomBox,
    EquipSkill,
    DismissCharacter,
    DismissInfrastructure,
    DismissPet,
    DismissToken,
    DismissConsumable,
    DismissMaterial,
    DismissEquipment,
    DismissCostume,
    DismissRandomBox,
    LevelUpCharacter,
    LevelUpInfrastructure,
    LevelUpPet,
    LevelUpConsumable,
    LevelUpMaterial,
    LevelUpEquipment,
    LevelUpCostume,
    LevelUpSkill,
    Deposit,
    Withdraw,
    FinishedTutorial,
}

선택

from_category_slug

캐릭터를 획득한 장소, 경로, 상황에 대한 카테고리(대분류)

선택

from_slug

캐릭터를 획득한 장소, 경로, 상황에 대한 상세명

선택