본문으로 건너뛰기

버전 업데이트 내역

버전 업데이트 내역​

이전 버전(0.0.1)의 SDK 가이드를 보셨던 분들은 이 섹션에서 변경사항을 확인하세요.

v0.1.5 (2026-03-30) — 현재 버전​

새로운 기능​

  1. ShareForReward API 추가: 공유 완료 시 보상을 지급하는 API가 추가되었습니다.

    TudadaSDK.Instance.ShareForReward(
        url: "https://example.com/share",  // 선택
        onSuccess: (result) => {
            if (result.rewarded) Debug.Log("공유 완료 — 보상 지급");
        },
        onFail: (error) => Debug.LogError($"공유 실패: {error}")
    );
    • ShareForReward(url, onSuccess, onFail): 공유 + 보상 처리
    • 공유 처리는 플랫폼이 자동으로 수행

필요 파일:

  • Game SDK: tudadaGameSDK.0.1.5.js
  • Unity Client: tudada-unity-client-v0.1.5-hotfix0420.unitypackage

v0.1.4 (2026-03-18)​

새로운 기능​

  1. ShowRewardedAd API 추가: 보상형 광고를 한 번의 호출로 로드부터 표시까지 처리합니다.

    TudadaSDK.Instance.ShowRewardedAd("your-ad-unit-id",
        onSuccess: (result) => {
            if (result.isEnded) Debug.Log("시청 완료 — 보상 지급");
        },
        onFail: (error) => Debug.LogError($"광고 실패: {error.errMsg}")
    );
    • ShowRewardedAd(adUnitId, onSuccess, onFail): 로드 + 표시 일괄 처리
    • 로딩 UI, 재시도, 실패 팝업을 플랫폼이 자동 처리
    • CreateRewardedVideoAd는 레거시로 유지

  2. CheckFeature API 추가: 특정 API가 현재 플랫폼에서 지원되는지 사전에 확인할 수 있습니다.

    TudadaSDK.Instance.CheckFeature("startAccelerometerSensor",
        onSuccess: (result) => Debug.Log($"지원됨: {result.apiName}"),
        onFail: (result) => Debug.Log($"미지원: {result.status}")
    );
    • CheckFeature(apiName, onSuccess, onFail): API 지원 여부 확인
    • CheckFeatureStatus: supported, unknown_api, version_required, platform_unsupported, device_unsupported, permission_denied

  3. LaunchOptions API 추가: 게임 실행 시 전달된 쿼리 파라미터 및 리퍼러 정보를 조회할 수 있습니다.

    TudadaLaunchOptions options = TudadaSDK.Instance.GetLaunchOptions();
    Debug.Log("쿼리 JSON: " + options.query);
    • GetLaunchOptions(): 런치 옵션 동기 조회
    • query는 JSON 문자열 (서드파티 JSON 라이브러리로 파싱 필요)

필요 파일:

  • Game SDK: tudadaGameSDK.0.1.4.js
  • Unity Client: tudada-unity-client-v0.1.4.unitypackage

v0.1.3 (2026-02-26)​

새로운 기능​

  1. Accelerometer API 추가: StartAccelerometerSensor(), StopAccelerometerSensor(), OnAccelerometerChange 이벤트가 추가되었습니다.

    TudadaSDK.Instance.OnAccelerometerChange += (res) => {
        Debug.Log($"X: {res.x}, Y: {res.y}, Z: {res.z}");
    };

    TudadaSDK.Instance.StartAccelerometerSensor(
        sensitivity: AccelerometerSensitivity.normal,
        onSuccess: (result) => Debug.Log("센서 시작 완료")
    );

    TudadaSDK.Instance.StopAccelerometerSensor();
    • XYZ 축 기반 가속도 데이터 수신
    • 민감도 기반 제어: sensitive | normal | insensitive
    • 플랫 API 패턴: StartAccelerometerSensor(), StopAccelerometerSensor(), OnAccelerometerChange
    • Unity Editor에서 Input.acceleration 시뮬레이션 지원

필요 파일:

  • Game SDK: tudadaGameSDK.0.1.4.js
  • Unity Client: tudada-unity-client-v0.1.4.unitypackage

v0.1.2 (2026-02-26)​

새로운 기능​

  1. SystemInfo, AppBaseInfo에 environment 필드 추가

    현재 접속 환경을 나타내는 필드가 추가되었습니다.

    SystemInfo info = TudadaSDK.Instance.GetSystemInfoSync();
    Debug.Log(info.environment); // "prod" 또는 "dev"

    AppBaseInfo appInfo = TudadaSDK.Instance.GetAppBaseInfo();
    Debug.Log(appInfo.environment); // "prod" 또는 "dev"
    값설명
    "prod"프로덕션 환경
    "dev"개발 환경

필요 파일:

  • Game SDK: tudadaGameSDK.0.1.2.js
  • Unity Client: tudada-unity-client-v0.1.2.unitypackage

v0.1.1 (2026-02-20)​

  • 내부 개선 사항 적용 (게임 코드 변경 불필요)

v0.1.0 (2026-02-06)​

새로운 기능​

  1. Login 결과에 userId 필드 추가

    TudadaSDK.Instance.Login(
        onSuccess: (result) => {
            Debug.Log("코드: " + result.code);     // 기존
            Debug.Log("유저 ID: " + result.userId); // 새로 추가됨
        }
    );

  2. SystemInfo.wifiEnabled가 실제 값으로 변경

    이전에는 고정값이었으나, 이제 실제 Wi-Fi 활성화 상태를 반환합니다.

변경사항 (마이그레이션 필요)​

  1. Unity Client 패키지 업데이트 필요

    tudada-unity-client-v0.1.0.unitypackage 이상을 다시 임포트해야 합니다. 기존 패키지를 제거하고 새 패키지를 임포트하세요.

  2. CheckSession 콜백 결과 타입 변경

    // 0.0.1 — onSuccess에 로그인 정보가 포함되었음
    TudadaSDK.Instance.CheckSession(
        onSuccess: (result) => {
            // result에 code, userId 등 포함
        }
    );

    // 0.1.0 이후 — onSuccess는 일반 결과만 포함
    TudadaSDK.Instance.CheckSession(
        onSuccess: (result) => {
            // result.errMsg만 포함
            // 로그인 정보가 필요하면 Login()을 별도 호출
        }
    );

업데이트 절차​

  1. 새 .unitypackage 파일을 임포트합니다 (기존 파일 덮어쓰기)
  2. index.html의 SDK 스크립트 버전을 업데이트합니다: 
    <script src="tudadaGameSDK.0.1.0.js"></script>
  3. CheckSession 콜백에서 로그인 정보를 사용하고 있었다면 Login으로 분리합니다

v0.0.1 (2026-02-02) — 최초 릴리즈​

최초 릴리즈 버전입니다. 다음 API가 포함되었습니다:

  • Auth API (Login, CheckSession, GetUserInfo)
  • Storage API (Set/Get/Remove/Clear Storage + Sync 버전)
  • TudadaStore API (클라우드 스토리지)
  • System API (GetSystemInfoSync, GetWindowInfo, GetDeviceInfo 등)
  • Device API (진동, 키보드, 클립보드)
  • Ad API (보상형 비디오 광고)
  • Lifecycle API (OnShow, OnHide, ExitMiniProgram, RestartMiniProgram)

Copyright 2026 Tudada. All rights reserved.