게임 프로필 & 리더보드 연동하기

게임 프로필과 리더보드를 연동하여 사용자에게 더 몰입감 있는 경험을 제공해보세요.

게임 프로필 사용하기

게임에서 사용자 식별 및 소셜 기능(랭킹, 친구 맺기 등)을 위해 프로필 기능을 제공해요.
게임 프로필은 별도 연동 없이 SDK만 적용하면 사용할 수 있어요.

🚨 잠시만요

게임 프로필은 토스앱 5.221.0 버전 이상에서만 작동해요.
최소 버전 미만의 사용자는 사용할 수 없어요.
게임 진입 시, 토스앱 업데이트 안내 문구가 노출됩니다.

게임 전 프로필 등록은 필수예요. 프로필이 없는 사용자는 게임을 진행할 수 없어요.
사용자는 프로필 이미지를 선택하고 닉네임을 입력해요.
프로필 생성은 딱 한 번만 설정하면 되며, 이후에는 000님 반가워요! 형태의 환영 메시지가 노출돼요.

개발하기

1. 게임 리더보드에 점수 제출하기

SDK를 통해 연동해 주세요.

사용자가 게임이 완료되면 점수를 제출합니다.
사용자는 앱인토스 SDK에서 식별해요.
점수를 제출하면 사용자가 리더보드에서 확인할 수 있어요.
submitGameCenterLeaderBoardScore 페이지를 확인해주세요.

🚨 주의해주세요

게임 프로필이 생성되기 전에 점수를 제출하면 오류가 발생할 수 있어요.
게임에 진입하자마자 바로 점수를 제출하는 것은 피해 주세요.
보안상의 이유로, 사용자 식별자는 응답에 포함되지 않아요.

2. 게임 리더보드 열기

SDK를 통해 연동해 주세요.

사용자가 랭킹을 확인할 수 있어요.
서로 친구를 맺을 수 있고, 친구에게 내 점수를 자랑할 수 있어요.
openGameCenterLeaderboard 페이지를 확인해주세요.

🚨 주의해주세요

게임 프로필 WebView와 화면이 겹칠 수 있어요.
게임 진입 직후 바로 리더보드를 호출하는 것은 피해 주세요.
보안상의 이유로, 사용자 식별자는 응답에 포함되지 않아요.

자주 묻는 질문

Q. 게임 프로필과 리더보드 테스트가 되지 않아요.

샌드박스에서는 게임 프로필과 리더보드 테스트를 지원하지 않아요.
불편하시겠지만 콘솔 내 QR 코드로 테스트를 진행해 주세요.

Q. 사용자 식별 값을 따로 알 수 있나요 ?

보안상의 이유로, 게임 프로필과 리더보드 API에서는 사용자 식별자가 응답에 포함되지 않아요.