Repository navigation
Home
Ilhwan Seo edited this page Aug 29, 2026
·
2 revisions
Seorilabs 앱과 게임이 공통 Platform API를 연결할 때 쓰는 SDK 가이드입니다.
Wiki는 통합 가이드이고, API 계약과 구현의 정본은
seorilabs/platform 저장소의
spec/, packages/sdk-ts/, sdk-gdscript/입니다.
처음이면 Getting Started부터 읽으세요. 10분 안에 로그인과 이벤트 전송까지 됩니다.
| 런타임 | 권장 버전 | 배포 방식 | 문서 |
|---|---|---|---|
| TypeScript / React Native / Web | 0.4.0 |
GitHub Release tarball 또는 GitHub Packages | TypeScript SDK · 0.4.0 |
| Godot 4.3 / GDScript | 0.6.7 |
GitHub Release tarball + sha256 | GDScript SDK · 버전 이력 |
두 SDK 산출물은 통합 릴리스
v0.6.7에 함께 붙어
있고, platform-release.json이 각 산출물의 sha256과 계약 revision을 기록합니다.
v0.6.5는 철회된 릴리스입니다. 자산이 발행되지 않았으므로 사용하지 마세요.
확인 기준일은 2026-08-29입니다. 새 버전을 배포할 때는 SDK 버전 정책의 문서 갱신 게이트도 함께 통과해야 합니다.
| 페이지 | 내용 |
|---|---|
| Getting Started | 사전 준비, 서비스 URL, 두 런타임의 최소 코드 |
| App Registration |
appId를 얻는 법 — 레지스트리 항목과 기능 플래그 |
| TypeScript SDK | 설치, 옵션, 인증, 이벤트, 결제, 설정, 광고, 계정 연결, 수명주기 |
| GDScript SDK | 가져오기, 노드 배선, 콜백 envelope, 어댑터, 검증 |
| Error Codes | 클라이언트가 분기해야 하는 오류 코드와 대응 |
| SDK Version Policy | 버전 정본, 발행 게이트, 호환성 원칙 |
- 앱을 레지스트리에 등록하고
appId를 확정합니다. - 정확한 SDK 버전을 고정 설치하거나 vendoring합니다.
- 앱 구성과 CI에서 SDK 빌드·회귀 검증을 통과시킵니다.
- 신규 기능 스위치(
presenceEnabled등)는 기본값을 끈 상태로 병합합니다. - 단일 canary에서 관찰한 뒤 앱별로 확대합니다.
- 오류 분기는 사람이 읽는
message가 아니라 안정적인code로 합니다. → Error Codes - 응답의 미지 필드는 무시합니다. 서버가 필드를 추가해도 배포된 앱이 깨지지 않습니다.
- Firebase token, 마켓 증명값, refresh token을 로그·저장소·앱 번들에 넣지 않습니다.
- 결제 검증과 광고 claim은 일반 네트워크 오류에서 자동 재시도하지 않습니다. 재시도는 사용자가 정합니다.
- Remote Config를 못 읽으면 열린 기본값으로 갑니다. 차단은 서버가 명시할 때만 합니다.
구현과 API 계약의 정본은 seorilabs/platform 저장소입니다.