TPStashEvent.GetBonus

public int GetBonus(
    string player_uuid,
    string character_uuid,
    string bonus_slug,
    bool is_automated,
    [string bonus_category_slug = null]
);

설명

캐릭터가 게임 내에서 보너스를 획득한 이벤트 데이터를 수집합니다.

보너스란 게임 내의 컨텐츠 플레이와 상관없이 노력없이 얻게되는 보상을 총칭합니다.

  • 예: 특정 시간 접속하면 보상을 받거나 보상을 받을 기회가 생기는 모든 시스템

  • 예: '접속시간 n분마다' 또는 '일일 n회 한정' 등 특정 조건을 충족하면 얻을 수 있는 추가 보상 시스템

  • 예: 쿠폰 사용

호출이 성공한 경우 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_로 설정합니다.

필수

bonus_slug

보너스의 고유 구분자

필수

bonus_category_slug

보너스의 카테고리명

선택

is_automated

자동 획득형 보너스 여부

  • True: 사용자가 가만히 있어도 자동으로 보너스가 획득됨

  • False: 사용자가 보너스 획득을 위해 특정 행동(예: 룰렛 돌리기나 특정 버튼 누리기)을 해야함

필수