본문으로 건너뛰기

Storage API

Storage API​

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

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

비동기 API​

SetStorage(key, data, onSuccess, onFail)​

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

파라미터:

파라미터타입필수설명
keystring✅저장할 키
datastring✅저장할 데이터
onSuccessAction<SetStorageResult>-성공 콜백
onFailAction<string>-실패 콜백
TudadaSDK.Instance.SetStorage("playerName", "홍길동",
    onSuccess: (result) => Debug.Log("저장 완료"),
    onFail: (err) => Debug.LogError("저장 실패: " + err)
);

GetStorage(key, onSuccess, onFail)​

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

파라미터:

파라미터타입필수설명
keystring✅조회할 키
onSuccessAction<GetStorageResult>-성공 콜백
onFailAction<string>-실패 콜백

성공 응답 (GetStorageResult):

필드타입설명
datastring조회된 데이터
TudadaSDK.Instance.GetStorage("playerName",
    onSuccess: (result) => Debug.Log("이름: " + result.data),
    onFail: (err) => Debug.LogError("조회 실패: " + err)
);

RemoveStorage(key, onSuccess, onFail)​

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

파라미터:

파라미터타입필수설명
keystring✅삭제할 키
onSuccessAction<RemoveStorageResult>-성공 콜백
onFailAction<string>-실패 콜백
TudadaSDK.Instance.RemoveStorage("tempData",
    onSuccess: (result) => Debug.Log("삭제 완료")
);

ClearStorage(onSuccess, onFail)​

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

파라미터:

파라미터타입필수설명
onSuccessAction<ClearStorageResult>-성공 콜백
onFailAction<string>-실패 콜백
TudadaSDK.Instance.ClearStorage(
    onSuccess: (result) => Debug.Log("전체 삭제 완료")
);

동기 API​

SetStorageSync(key, data)​

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

파라미터:

파라미터타입필수설명
keystring✅저장할 키
datastring✅저장할 데이터
TudadaSDK.Instance.SetStorageSync("score", "1000");

GetStorageSync(key)​

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

파라미터:

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

반환값 (string):

조회된 데이터 문자열을 반환합니다.

string score = TudadaSDK.Instance.GetStorageSync("score");
Debug.Log("점수: " + score);

RemoveStorageSync(key)​

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

파라미터:

파라미터타입필수설명
keystring✅삭제할 키
TudadaSDK.Instance.RemoveStorageSync("tempData");

ClearStorageSync()​

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

TudadaSDK.Instance.ClearStorageSync();

GetStorageInfoSync()​

스토리지 사용 정보를 동기적으로 조회합니다.

반환값 (StorageInfo):

필드타입설명
keysstring[]저장된 키 목록
currentSizeint사용 용량 (KB)
limitSizeint제한 용량 (KB)
StorageInfo info = TudadaSDK.Instance.GetStorageInfoSync();
Debug.Log("저장된 키 수: " + info.keys.Length);
Debug.Log("사용 용량: " + info.currentSize + " KB");
Debug.Log("제한 용량: " + info.limitSize + " KB");