화면 모드
데이터 저장
유저별 키-값 저장소예요. 값은 JSON이면 무엇이든 돼요(객체·배열·숫자·문자열). 진행 상황, 설정, 인벤토리 등을 저장해요.
| 항목 | 기본 한도 |
|---|---|
| 키 이름 | 1~64자 [A-Za-z0-9_.-] |
| 유저당 키 개수 | 100개 |
| 값 하나 크기 | 64KB |
| 한 번에 여러 키 저장 | 20개 (전부 성공하거나 전부 실패) |
version — 동시 저장 충돌 막기
같은 계정으로 두 기기에서 플레이하면, 한쪽이 저장한 내용을 다른 쪽이 덮어쓸 수 있어요. 그래서 저장할 때마다 version을 함께 보내요.
- 새 키는
version: 0으로 써요. - 그다음부터는 마지막으로 읽거나 쓴 version을 보내요. 저장할 때마다 1씩 올라가요.
- 다른 기기가 먼저 저장해서 version이 다르면
409 VERSION_CONFLICT가 와요. 다시 읽어서 합친 뒤 저장하세요.
SDK는 읽고 쓴 version을 기억하므로 보통은 신경 쓰지 않아도 되고, update 함수는 충돌이 나면 다시 읽어서 자동으로 재시도해요.
공개 데이터
is_public으로 저장한 키는 다른 유저가 읽을 수 있어요. 닉네임·프로필처럼 남에게 보여 줄 데이터에 써요.