그밖의 문제 해결

그밖의 Hive 제품 사용과 관련한 FAQ 모음입니다.

Hive Certification Key 기반 API 서비스 종료 및 JWT 기반 API 전환 FAQ
  1. 어떤 API들이 전환 대상인가요?
  2. client_id 및 client_secret은 어디서 확인할 수 있나요?
    • Hive Console > 앱센터 > 보안 키 설정 메뉴에서 보안 키를 발급한 후 확인할 수 있습니다. 자세한 내용은 관련 콘솔 가이드를 참고하세요.
  3. App ID마다 OAuth Token을 따로 발급해야 하나요?
    • OAuth Token은 프로젝트 단위로 발급되므로 App ID마다 발급하지 않아도 됩니다.
    • 동일 프로젝트에 속한 여러 App ID 중 하나로 발급받으면 해당 프로젝트 내 모든 플랫폼 및 App ID에서 함께 사용할 수 있습니다.
  4. 토큰을 여러 번 발급하면 이전 토큰은 만료되나요?
    • 만료되지 않습니다. 토큰 발급 API를 호출할 때마다 새로운 토큰이 생성되며, 각 토큰은 발급 시점부터 1시간 동안 유효합니다.
    • 단, 잦은 토큰 발급 호출은 서버 부하를 유발할 수 있으므로, 토큰 만료 임박 시점 또는 검증 실패 전까지는 기존 발급된 토큰을 캐싱하여 재사용하는 것을 권장합니다.
  5. client_id가 변경되면 기존 토큰은 바로 무효화되나요?
    • client_id는 발급 후 임의로 변경할 수 없는 값입니다. 또한 이미 발급된 토큰은 토큰 자체의 유효기간(1시간)이 만료되기 전까지 유효합니다.
  6. 앱 클라이언트에서 대응해야 할 사항이 있나요?
    • X-Access-Token는 인증 방식에 따라 앱 클라이언트로부터 반환된 User Token과 OAuth 2.0 Access Token으로 나뉩니다. 자세한 내용은 토큰 검증 가이드를 참고하세요.
    • 앱 내에서 초기화 및 SignIn 이후 호출하는 서버 API(토큰 검증, 계정 삭제 등)는 앱 클라이언트로부터 PlayerInfo.accessToken 값을 서버로 전달받아 X-Access-Token 헤더 값으로 사용해야 합니다.
    • PlayerInfo.accessToken의 유효기간은 1시간이며, 토큰 만료 시 Hive SDK의 AuthV4.refreshAccessToken() 메서드를 호출하여 갱신된 토큰을 앱 서버로 전달해야 합니다.
Google Play에서 인앱 결제 중 "구입하려는 항목을 찾을 수 없습니다." 가 노출되면 어떻게 해야 하나요?
  • Google Play 앱(이하 마켓앱)을 설치하고 단말에서 Google Play Services가 동작해야합니다.
  • 구매수단을 설정한 계정이 마켓앱에 등록되어야 하며, 앱을 한 번 이상 실행해 마켓 약관 동의를 최신버전으로 유지해야 합니다.
  • Google Console에 등록된 빌드를 sign한 keystore 파일과 테스트 하는 앱의 keystore 파일이 같아야 합니다.
  • Google Console 출시 관리 > 앱 버전에서 최소 alpha 이상 버전에 출시되어야 합니다.
  • 단말에 등록한 Google 계정이 출시된 버전의 테스터에 등록되어야 합니다.
  • 단말에 등록한 계정을 Google Console 테스터에 등록했어도 단말 계정은 Google Console 출시 관리에 있는 ‘테스트 참여 URL’을 통해 동의해야 합니다.
  • 자세한 사항은 Google Developer 가이드를 참고바랍니다.
Google Cloud API 사용량 상한 설정은 어떻게 하나요?

Hive가 제공하는 PGS 로그인을 사용할 때, 유저가 "Google Play 게임 활동 생성, 수정, 삭제" 항목에 체크할 경우 PGS 신규 프로필이 생성되며 이때 Google Cloud API를 사용되게 됩니다.

API 사용량은 기본적으로 10,000 으로 설정되며, 요청이 초과할 경우 오류가 발생하므로 게임 런칭 이전에 상향 신청이 필요합니다.

Google Cloud 가이드를 참고바랍니다.