Hive SDK v4와 인증 v1을 사용하는 경우 다음의 연동 가이드라인에 따라 Hive 적용하여 게임을 개발하세요.

Hive 연동 가이드라인 체크리스트

Hive 연동 가이드라인 체크리스트는 게임과 Hive의 연동이 잘 되었는지 확인할 수 있는 항목들을 각 Hive 서비스 별로 제공합니다. 이를 통해 게임이 Hive의 정책을 잘 구현하였는지, 게임과 Hive와의 연동이 잘 되었는지, 누락된 기능이 없는지 여부를 쉽게 확인할 수 있습니다.

게임 진행 플로우 가이드

Hive를 이용하는 유저들이 공통된 UX를 경험하고, 게임이 준수해야 하는 서비스 정책과 법규를 수행하기 위해 Hive는 게임을 최초로 실행시켰을 때의 흐름에 대해 다음과 같은 가이드라인을 제시합니다. 각 단계에 대한 상세한 설명을 읽어 보세요.

0. 게임 실행

유저가 단말기에서 게임을 실행합니다.

1. CI (Corporate Identity) 로고 띄우기

게임을 실행하면 가장 먼저 여러분 회사의 CI 로고를 화면에 띄우세요. CI 로고는 회사 규정에 따라 활용하면 됩니다.

2. 게임 서버 자동 선택

게임 서버 선택 단계는 선택적으로 구현하며, 화면에 나타나지 않습니다. 하나의 빌드로 글로벌 서비스를 제공한다면, 유저가 사용할 게임 서버를 여러분이 지정해야 합니다. 유저가 게임을 최초로 실행하면 GeoIP 등 위치 서비스를 활용하여 유저 위치를 탐지한 후, 여러분의 게임 서비스 정책에 따라 접속할 게임 서버를 지정해 주세요. 지정된 게임 서버 정보는 유저의 단말기에 저장하고, 이후 게임을 실행할 때는 저장된 정보를 바탕으로 게임을 플레이할 수 있게 하세요. 이 단계는 필수 요소가 아닙니다.

3. 언어 자동 선택

API: Configuration.setGameLanguage
언어 선택 단계는 선택적으로 구현하며, 화면에 나타나지 않습니다. 서버 지정 단계와 동일한 시점에 유저의 단말기에 설정된 언어를 기준으로 게임에서 사용할 언어를 결정합니다. 만약 게임에서 유저의 단말기 설정 언어를 지원하지 않는다면 영어를 기본 언어로 설정하세요. 게임 언어에 대한 정보는 유저 단말기에 저장하고, 이후 게임을 실행할 때는 저장된 언어로 게임을 플레이할 수 있게 하세요.

  • 게임에 새로운 언어를 지원하면 설정된 게임 언어도 변경할까요?
    단말기 설정 언어를 지원하지 않아 영어로 제공하던 게임에 언어가 업데이트된다면, 게임 언어를 단말기 설정 언어로 변경하세요. 만약 게임 언어를 업데이트한 후에 유저가 다른 언어로 변경한다면, 변경 후 접속했을 때, 혹은 추가 언어 업데이트가 적용되었을 때 유저가 설정한 언어로 게임을 제공하세요.

4. 앱 접근 권한 고지

API: Auth.initialize
접근 권한이 설정된 정보 및 기능에 접근하기 위해 유저에게 어떤 접근 권한이 필요한지 고지합니다. Hive SDK v4.5.0 이상부터는 Hive에서 제공하는 앱 접근 권한 외 게임에서 필요한 앱 접근 권한을 추가하여 고지할 수 있습니다. 추가 고지가 필요하다면 앱 접근 권한 고지화면에 대한 커스터마이징 항목을 참고하세요.

5. 약관 동의

API: Auth.initialize
약관 동의 단계는 Hive가 초기화 될 때 자동으로 진행하는 단계로, Hive가 Hive 콘솔에서 설정한 약관 내용을 자동으로 띄웁니다.

6. 게임 서버 수동 선택

API: Configuration.setServerId
약관 동의 단계와 업데이트/점검/공지 팝업을 띄우는 단계 사이에 게임 서버를 선택하도록 제공하세요.
유저가 게임 서버를 선택하면 지정된 게임 서버 정보는 유저의 단말기에 저장하고, 이후 게임을 실행할 때는 서버 수동 선택이 더 이상 노출되지 않도록 구현합니다.

7. 업데이트/점검/공지 팝업

API: Auth.checkMaintenance
업데이트/점검/공지 팝업은 선택사항입니다. 필요에 따라 Hive One에 설정한 정보로 업데이트/점검/공지 팝업을 띄워주세요. 만약 세 가지 팝업이 모두 활성화 되어 있다면 서버 점검, 게임 강제 업데이트, 공지 순으로 팝업이 노출됩니다.

8. 게임 리소스 추가 다운로드

유저가 게임 리소스를 추가로 다운로드하는 기능은 필요 시에만 제공하고 게임에서 직접 구현해야 합니다. 글로벌 유저에게 양호한 서비스 품질을 제공하기 위해 일반적으로 CDN (Content Delivery Network)을 이용합니다.

9. 게임 타이틀

게임 시작에 필요한 리소스가 모두 로딩되면 게임 타이틀을 띄우세요. 게임 타이틀에는 로그인 버튼이나 링크가 제공되어야 하는데, 유저의 단말기에서 여러분의 게임을 이용한 Hive 로그인 기록이 있는지 없는지에 따라 로그인 버튼을 다음과 같이 구성하세요.

  • Hive 로그인 기록 없음: Hive 로그인이나 게스트 로그인을 선택할 수 있도록 구성하세요.
  • Hive 로그인 기록 있음: 게스트 로그인을 제공하지 마세요. Hive 로그인 UI를 제공하거나, 로그인 세션 키가 남아 있다면 자동 로그인을 시켜 주세요.

10. 로그인

API: Auth.login
유저가 게임 타이틀의 로그인 UI를 이용해서 로그인하거나 자동 로그인할 때 진행되는 단계입니다. 모바일 게임의 이용 행태를 고려하여 게임이 백그라운드 상태가 되더라도 일정 시간 로그인 세션을 유지하도록 권장합니다. 자세한 내용은 로그인 가이드를 참고하세요.

11. 전면 배너

API: Promotion.showPromotion
게임 로비에 진입하기 전 크로스 프로모션 배너와 이벤트 배너를 띄우는 단계입니다. 크로스 프로모션 배너는 Hive가 탑재된 다른 게임을 홍보하며, 이벤트 배너는 여러분의 게임에서 진행하는 이벤트를 홍보하는 배너입니다. 배너를 구성하려면 프로모션 설정 가이드를, 배너를 띄우려면 전면 배너 띄우기 가이드를 참고하세요.

12. 게임 로비

유저가 Hive에서 제공하는 주요 기능을 이용할 수 있도록 게임 로비에 아이콘이나 링크를 제공해 주세요.