유니티 설정하기

텐투플레이 유니티 패키지 다운로드

유니티용 텐투플레이 SDK를 다운로드 합니다.

텐투플레이 유니티 패키지 불러오기

  1. 유니티 에디터를 실행합니다.

  2. Assets  Import Package  Custom Package를 클릭합니다.

    Getting started sdk import unity1 KR

  3. 다운로드 한 SDK TentuPlay_SDK_v2021.4_DemoGame.unitypackage를 선택하고, 열기를 클릭합니다.

    image (33)

  4. Import Unity Package 창에서 Import를 클릭하면 텐투플레이 패키지가 설치됩니다.

    image (34)

    TentuPlay 유니티 패키지 구성은 다음과 같습니다.

    ShingGoongDemo

    데모 게임을 이용하여 텐투플레이 SDK 사용법을 익힐 수 있습니다.

    TentuPlay

    텐투플레이 패키지의 핵심. Dll 파일과 스크립트, 프리팹 등이 들어있습니다.

    Plugins

    텐투플레이를 실행시키는데에 필요한 3rd party plugins 입니다.

    TPPersonalizedOfferTemplates

    텐투플레이 우편 화면에 필요한 스크립트와 프리팹입니다.

  5. 설치 후 유니티 에디터 메뉴에 TentuPlay 항목이 생성되며, Assets 폴더 내에 TentuPlay 관련 폴더가 생성됩니다.

    image (36)

TentuPlay Settings 설정하기

텐투플레이 SDK 설정은 유니티 에디터나 스크립트를 통해 할 수 있습니다.

유니티 에디터를 사용하는 경우

  1. 유니티 에디터 메뉴에서 TentuPlay  Edit Settings을 클릭합니다.

    image (37)

  2. 각 항목을 설정합니다.

    • Api Key: 고객사 회원가입 시 발급되는 고객사 고유값

    • Secret: 고객사 회원가입 시 발급되는 고객사 고유값

      Api Key와 Secret 키는 텐투플레이 콘솔 > 프로젝트 > 프로젝트 설정 > 일반 설정 > *프로젝트 크레덴셜*에서 발급받을 수 있습니다.

    • Get Client Key: 버튼을 눌러 Client Key를 발급받습니다. Client Key가 있어야 텐투플레이가 정상적으로 작동됩니다.

    • TentuPlay Debug Mode: 텐투플레이 SDK를 디버그 모드에서 실행하기 위해서는 체크합니다.

    • Auto Upload: 클라이언트로부터 수집된 데이터를 자동으로 서버에 업로드 하기 위해서는 체크합니다.

      • 데이터를 자동으로 업로드하려면 Auto Upload가 체크되어 있어야 합니다. Auto Upload가 체크되어 있지 않으면 TPUploadData 함수를 호출해야만 데이터가 업로드됩니다.

      • 텐투플레이 함수는 메인 스레드에서만 호출이 가능합니다. 메인 스레드에서 호출이 불가능 할 경우, Auto Upload를 해제하고 TPUploadData를 이용하여 수동으로 업로드해주세요

    • Upload Interval (sec): 서버 업로드 최소 간격 (기본값 1200초, 최대 3600초)

    • Offer Sync Interval (sec): CRM을 사용하는 경우 새로운 Offer를 불러오는 최소 간격 (기본값 600초)

스크립트를 사용하는 경우

텐투플레이의 클래스/메소드 호출에 앞서서 가장 먼저 TentuPlaySettings 클래스의 정적필드(static field) 값을 지정하면 TentuPlaySettings.asset 없이도 TentuPlay Setting을 설정할 수 있습니다.

스크립트 예제
using TentuPlay;
TentuPlaySettings.ClientKey= "MY_CLIENT_KEY";
TentuPlaySettings.DEBUG = true; // 기본 값은 false 입니다. 디버깅 하려면 true라고 해주세요.
TentuPlaySettings.AutoUpload = true; // 수동으로 TPUpload를 부르지 않을 거면 true로 설정해야 합니다.
TentuPlaySettings.DeferredSendIntervalSec = 1200; // 기본값은 1200입니다. 숫자가 작으면 작은 데이터를 자주 올리고, 숫자가 크면 많은 데이터를 가끔 올리게 됩니다.
TentuPlaySettings.OffersGetInterval= 600;

// 가장 처음으로 호출되는 TentuPlay.Api 혹은 TentuPlay.CRM의 클래스

TentuPlaySettingsEditor 클래스의 CreateClientKey(string apiKey, string secret) 메소드를 이용하여 ClientKey를 불러올 수 있습니다.

코드 내에 Api Key와 Secret Key를 하드코딩 하지 않도록 주의하십시오.

도움이 필요한가요?

궁금한 것이 있으신가요? 텐투플레이 디스코드에서 바로 문의주세요.