개요

H5/웹 브라우저 게임에서 투다다(Tudada) 서비스를 연동하기 위한 SDK 사용 가이드

SDK 버전: 0.1.5 최종 업데이트: 2026-03-30 대상 독자: H5 웹 게임 개발자 (Cocos Creator, Phaser, PixiJS 등) 지원 플랫폼: iOS, Android

개요

TudadaSDK는 H5/웹 브라우저 환경에서 게임과 투다다 서비스를 연결하기 위한 SDK입니다. 기존 WeChat Mini Game(wx) API와의 레거시 호환도 제공하여, WeChat 게임을 최소한의 수정으로 투다다 플랫폼에 이식할 수 있습니다. 신규 개발 시에는 TudadaSDK API를 직접 사용하세요.

주요 특징

TudadaSDK 네이티브 API: TudadaSDK.login() 형태의 직접 호출 (권장)
WeChat API 호환 (레거시): 기존 WeChat 이식 게임을 위한 wx 객체 호환 지원
자동 초기화: SDK가 로드되면 자동으로 초기화되며, waitForReady()로 완료 대기
TypeScript 지원: tudada-sdk-types npm 패키지로 타입 자동완성 제공
모바일 최적화: iOS, Android 환경에서 최적의 성능 제공

API 호출 방식

SDK는 두 가지 방식으로 API를 호출할 수 있습니다:

// 방법 1: TudadaSDK 직접 호출 (권장)
TudadaSDK.login({
  success: (res) => console.log(res.code),
});

// 방법 2: wx 호환 호출 (레거시 — WeChat 이식 게임 전용)
wx.login({
  success: (res) => console.log(res.code),
});

wx 호환 레거시 안내

wx 객체를 통한 API 호출은 기존 WeChat 게임 이식을 위한 레거시 호환 기능입니다.

신규 프로젝트에서는 반드시 TudadaSDK 직접 호출을 사용하세요.

v0.1.2까지 등록된 API만 wx 객체에서 사용할 수 있습니다. v0.1.3부터 추가되는 신규 API(가속도계, checkFeature, getLaunchOptions 등)는 TudadaSDK 전용입니다.

향후 wx 호환 기능은 유지보수만 진행되며, 새로운 기능이 추가되지 않습니다.

wx 호환 API 전체 목록 (v0.1.2 기준, 고정)

카테고리	API	타입
인증	`login`	비동기
	`checkSession`	비동기
	`getUserInfo`	비동기
스토리지 (동기)	`getStorageSync`	동기
	`setStorageSync`	동기
	`removeStorageSync`	동기
	`clearStorageSync`	동기
	`getStorageInfoSync`	동기
스토리지 (비동기)	`setStorage`	비동기
	`getStorage`	비동기
	`removeStorage`	비동기
	`clearStorage`	비동기
클라우드 스토리지	`getTudadaStore`	동기 (인스턴스)
시스템 정보 (동기)	`getSystemInfoSync`	동기
	`getWindowInfo`	동기
	`getAppBaseInfo`	동기
	`getDeviceInfo`	동기
시스템 정보 (비동기)	`getSystemInfo`	비동기
	`getWindowInfoAsync`	비동기
	`getAppBaseInfoAsync`	비동기
	`getDeviceInfoAsync`	비동기
UI	`getMenuButtonBoundingClientRect`	동기
키보드	`showKeyboard`	비동기
	`hideKeyboard`	비동기
	`onKeyboardInput` / `offKeyboardInput`	콜백 등록
	`onKeyboardConfirm` / `offKeyboardConfirm`	콜백 등록
	`onKeyboardComplete` / `offKeyboardComplete`	콜백 등록
클립보드	`setClipboardData`	비동기
	`getClipboardData`	비동기
디바이스	`vibrateShort`	비동기
	`vibrateLong`	비동기
라이프사이클	`onShow` / `offShow`	콜백 등록
	`onHide` / `offHide`	콜백 등록
	`exitMiniProgram`	비동기
	`restartMiniProgram`	비동기
오디오	`createInnerAudioContext`	동기 (인스턴스)
광고	`showRewardedAd`	비동기 콜백 (권장)
	`showRewardedAdAsync`	비동기 Promise
	`createRewardedVideoAd`	동기 (인스턴스, 레거시)

미지원 API: wx.request(), wx.downloadFile() 등 네트워크 API는 지원하지 않습니다. 브라우저 fetch/XMLHttpRequest를 직접 사용하세요. wx.authorize(), wx.getSetting() 등 WeChat 전용 권한 API도 지원하지 않습니다. 가속도계는 wx API(wx.startAccelerometer 등)와 다른 TudadaSDK 독자 인터페이스(startAccelerometerSensor 등)로 제공되며, wx 객체에서 사용할 수 없습니다. 광고(showRewardedAd, showRewardedAdAsync)도 TudadaSDK 인스턴스에서 직접 호출해야 합니다.

개요​

주요 특징​

API 호출 방식​

개요

주요 특징

API 호출 방식