Storage API

Storage API

디바이스 로컬 스토리지에 데이터를 저장/조회합니다.

용량 제한:

• 단일 키 최대: 1MB (1024KB)
• 전체 스토리지 최대: 10MB (10240KB)
• JSON으로 직렬화 가능한 데이터만 지원

참고: Storage는 SDK 내부에서 관리되며 앱이 백그라운드로 전환되거나 종료될 때 자동으로 데이터를 동기화합니다.

비동기 API

setStorage(options)

로컬 스토리지에 데이터를 저장합니다.

옵션:

파라미터	타입	필수	설명
key	string	✅	저장할 키
data	any	✅	저장할 데이터
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

TudadaSDK.setStorage({
  key: 'userInfo',
  data: { name: '홍길동', level: 10 },
  success: () => console.log('저장 완료'),
  fail: (err) => console.error('저장 실패:', err.errMsg),
});

getStorage(options)

로컬 스토리지에서 데이터를 조회합니다.

옵션:

파라미터	타입	필수	설명
key	string	✅	조회할 키
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

성공 응답:

필드	타입	설명
data	any	저장된 데이터

TudadaSDK.getStorage({
  key: 'userInfo',
  success: (res) => console.log('데이터:', res.data),
});

removeStorage(options)

로컬 스토리지에서 데이터를 삭제합니다.

옵션:

파라미터	타입	필수	설명
key	string	✅	삭제할 키
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

TudadaSDK.removeStorage({
  key: 'tempData',
  success: () => console.log('삭제 완료'),
});

clearStorage(options?)

로컬 스토리지의 모든 데이터를 삭제합니다.

옵션:

파라미터	타입	필수	설명
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

TudadaSDK.clearStorage({
  success: () => console.log('전체 삭제 완료'),
});

동기 API

setStorageSync(key, data)

로컬 스토리지에 데이터를 동기적으로 저장합니다.

파라미터:

파라미터	타입	필수	설명
key	string	✅	저장할 키
data	any	✅	저장할 데이터

TudadaSDK.setStorageSync('score', 1000);
// 또는
TudadaSDK.setStorageSync({ key: 'score', data: 1000 });

getStorageSync(key)

로컬 스토리지에서 데이터를 동기적으로 조회합니다.

파라미터:

파라미터	타입	필수	설명
key	string	✅	조회할 키

반환값:

필드	타입	설명
(반환값)	any	저장된 데이터 (없으면 undefined)

const score = TudadaSDK.getStorageSync('score');
// 또는
const score = TudadaSDK.getStorageSync({ key: 'score' });

removeStorageSync(key)

로컬 스토리지에서 데이터를 동기적으로 삭제합니다.

파라미터:

파라미터	타입	필수	설명
key	string	✅	삭제할 키

TudadaSDK.removeStorageSync('tempData');

clearStorageSync()

로컬 스토리지의 모든 데이터를 동기적으로 삭제합니다.

TudadaSDK.clearStorageSync();

getStorageInfoSync()

스토리지 사용 현황을 동기적으로 조회합니다.

반환값:

필드	타입	설명
keys	string[]	저장된 키 목록
currentSize	number	현재 사용 용량 (KB)
limitSize	number	최대 용량 (KB)

const info = TudadaSDK.getStorageInfoSync();
console.log('저장된 키:', info.keys);          // ['score', 'userInfo', ...]
console.log('사용 용량:', info.currentSize, 'KB'); // 12 KB
console.log('제한 용량:', info.limitSize, 'KB');   // 10240 KB