Unity로 시작하기
텐투플레이 유니티 패키지 다운로드
유니티용 텐투플레이 SDK를 다운로드 합니다.
텐투플레이 유니티 패키지 불러오기
유니티용 텐투플레이 SDK를 다운로드 합니다.
유니티 에디터에서 메뉴 > Assets > Import Package > Custom Package
를 클릭하세요.
다운로드 한 SDK TentuPlay_SDK_v2021.2.unitypackage
를 선택하고, 열기
를 클릭하세요.
_TentuPlaySDKDemo
데모 게임을 이용하여 텐투플레이 SDK 사용법을 익힐 수 있습니다.
TentuPlay
텐투플레이 패키지의 핵심. Dll 파일과 스크립트, 프리팹 등이 들어있습니다.
Plugins
텐투플레이를 실행시키는데에 필요한 3rd party plugins 입니다.
TPAdviceTemplates
텐투플레이 우편 화면에 필요한 스크립트와 프리팹입니다.
Import Unity Package 창에서 Import
를 클릭하면 텐투플레이 패키지가 설치됩니다. 설치 후 유니티 에디터 메뉴에 TentuPlay
항목이 생성되며, Assets 폴더 내에 TentuPlay
관련 폴더가 생성됩니다.
TentuPlay Settings 설정하기
텐투플레이 설정은 유니터 에디터에서 하거나 스크립트에서 할 수 있습니다.
유니티 에디터에서 지정하는 방법:
유니티 에디터 메뉴 > TentuPlay > Edit Settings에서 다음과 같이 설정할 수 있습니다.
Api Key
: 고객사 회원가입 시 발급되는 고객사 고유값. 텐투플레이 콘솔 - 프로젝트 - 프로젝트 설정 - 일반 설정 - 프로젝트 크레덴셜에서 발급받을 수 있습니다.
Secret
: 고객사 회원가입 시 발급되는 고객사 고유값. 텐투플레이 콘솔 - 프로젝트 - 프로젝트 설정 - 일반 설정 - 프로젝트 크레덴셜에서 발급받을 수 있습니다.
Get Client Key
: 버튼을 눌러 Client Key를 발급받습니다. Client Key가 있어야 텐투플레이가 정상적으로 작동됩니다.
TentuPlay Debug Mode
: 텐투플레이 SDK를 디버그 모드에서 실행하기 위해서는 체크합니다.
Auto Upload
: 클라이언트로부터 수집된 데이터를 자동으로 서버에 업로드 하기 위해서는 체크합니다. 데이터를 자동으로 업로드 하기 위해서는 AutoUpload가 체크되어있어야 합니다. Auto Upload가 체크되어있지 않으면 UploadData함수를 호출해야만 데이터가 업로드됩니다.
Upload Interval (sec)
: 서버 업로드 최소 간격 (기본값 1200초. 최대 3600초.)
Advice Sync Interval (sec)
: CRM을 사용하는 경우 새로운 Advice를 불러오는 최소 간격 (기본값 600초)
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.AdvicesGetInterval= 600;
TentuPlaySettings.OffersGetInterval= 600;
// 가장 처음으로 호출되는 TentuPlay.Api 혹은 TentuPlay.CRM의 클래스
TentuPlaySettingsEditor 클래스의 CreateClientKey(string apiKey, string secret) 메소드를 이용하여 ClientKey를 불러올 수 있습니다. 이 때 코드 내에 Api Key와 Secret Key를 하드코딩 하지 않도록 주의합니다.
도움이 필요한가요?
궁금한 것이 있으신가요? 텐투플레이 디스코드에서 바로 문의주세요.