화면 모드
로그인·계정
로그인 수단
| 수단 | 설명 | 필요한 연동 |
|---|---|---|
| 게스트 | 기기 ID로 바로 시작. 기기 단위라 앱을 지우면 사라져요 | 없음 |
| Google Sign-In / Credential Manager의 ID 토큰 | Google 클라이언트 ID | |
| Play Games | Play Games Services v2 서버 인증 코드 | Play Games 서버 클라이언트 ID·Secret |
| Apple | Sign in with Apple의 identity token | 번들 ID (웹은 Services ID) |
| 삼성 계정 | 삼성 Instant Plays에서만 — 삼성 Instant Plays | 삼성 로그인 서명 공개키 |
로그인 플러그인(Google Sign-In, Sign in with Apple 등)은 게임에서 골라 쓰고, SDK·API에는 받은 토큰만 넘겨요.
계정 연결
게스트로 시작한 유저에게 Google·Apple 계정을 연결하면, 다른 기기에서 그 계정으로 로그인해도 같은 유저로 이어져요. 진행이 어느 정도 쌓이면 계정 연결을 안내하세요.
- 이미 다른 유저에 연결된 계정이면 연결할 수 없어요 (
ALREADY_LINKED). 그 계정으로 로그인하면 그 유저로 들어가요. - 같은 종류 계정을 두 개 연결할 수는 없어요 (
PROVIDER_ALREADY_LINKED).
세션
- 로그인하면 Access Token(기본 1시간)과 Refresh Token(기본 30일)을 받아요. SDK는 만료되면 자동으로 갱신해요.
- Refresh Token은 쓸 때마다 새것으로 바뀌어요. 이미 쓴 토큰을 다시 쓰면 탈취로 보고 그 유저의 모든 세션을 끊어요.
- 제재된 유저는 로그인·토큰 갱신이 막혀요 (
PLAYER_BANNED). 이미 받은 Access Token은 만료(최대 1시간)까지 쓸 수 있어요.
탈퇴
게임 안에 탈퇴 메뉴를 꼭 넣어 주세요. Apple App Store와 Google Play 모두 계정을 만드는 앱에 계정 삭제 기능을 요구해요. 탈퇴를 요청하면 모든 세션이 끝나고, 유예 기간(기본 30일) 안에는 철회할 수 있어요. 자세한 내용은 개인정보·탈퇴를 보세요.