Skip to content

데이터 저장 ​

유저별 키-값 저장소예요. 값은 JSON이면 무엇이든 돼요(객체·배열·숫자·문자열). 진행 상황, 설정, 인벤토리 등을 저장해요.

항목기본 한도
키 이름1~64자 [A-Za-z0-9_.-]
유저당 키 개수100개
값 하나 크기64KB
한 번에 여러 키 저장20개 (전부 성공하거나 전부 실패)

version — 동시 저장 충돌 막기 ​

같은 계정으로 두 기기에서 플레이하면, 한쪽이 저장한 내용을 다른 쪽이 덮어쓸 수 있어요. 그래서 저장할 때마다 version을 함께 보내요.

  1. 새 키는 version: 0으로 써요.
  2. 그다음부터는 마지막으로 읽거나 쓴 version을 보내요. 저장할 때마다 1씩 올라가요.
  3. 다른 기기가 먼저 저장해서 version이 다르면 409 VERSION_CONFLICT가 와요. 다시 읽어서 합친 뒤 저장하세요.

SDK는 읽고 쓴 version을 기억하므로 보통은 신경 쓰지 않아도 되고, update 함수는 충돌이 나면 다시 읽어서 자동으로 재시도해요.

공개 데이터 ​

is_public으로 저장한 키는 다른 유저가 읽을 수 있어요. 닉네임·프로필처럼 남에게 보여 줄 데이터에 써요.

재화는 클라이언트 저장만 믿지 마세요

클라이언트가 저장하는 값은 조작될 수 있어요. 결제·광고 보상은 반드시 결제 검증·보상형 광고 흐름으로 지급하세요.

관련 문서 · 저장 API · Unity · HTML5

© WEBZEN K. All rights reserved.