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

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

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

게임 진행 플로우 가이드

게임을 실행하고 게임 로비에 진입하는 플로우는 대부분의 게임에서 공통적으로 적용되는 기능이 있다. 서비스 정책 및 법규를 준수하고 유저에게 익숙한 경험을 제공하기 위해 표준이 되는 플로우를 정했으며, 복수의 게임들 간에 지표를 비교하여 의미있는 분석을 하기 위해서도 지표 산정 기준을 동일하게 유지해야 한다. 따라서 Hive 게임은 다음과 같은 플로우를 준수해야 한다.

0. 게임 실행

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

게임을 실행하고 가장 먼저 노출되는 것은 퍼블리셔와 개발사 등의 CI 로고이다. CI 로고를 노출하는 방법은 각 퍼블리싱 회사에서 별도의 규정을 가지고 있다.

2. 게임 서버 자동 선택

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

3. 언어 자동 선택

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

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

4. 앱 접근 권한 고지

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

5. 약관 동의

API: C2SModuleSocial_Initialize
게임 서버, 언어 기본값을 지정한 뒤에 Hive의 초기화 시 진행되며, 이 기능은 Hive 콘솔에서 설정한 약관 내용을 Hive에서 자동으로 노출한다.

6. 게임 서버 수동 선택

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

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

API: C2SModuleSocial_Show (type=notice)
Hive SDK 적용 시 별도로 설정하지 않으면 약관 동의에 이어서 Hive One에 등록된 내용이 자동으로 노출된다.

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

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

9. 게임 타이틀

게임 시작을 위해 필요한 리소스의 로딩이 완료된 뒤에 로그인을 위한 UI를 표시한다. 게임 타이틀에서 로그인 방법은 해당 단말에서 Hive 로그인 이력이 있는지 여부에 따라 다르게 노출해야 한다.

로그인 기록 없음 Hive 로그인 또는 게스트 로그인 선택 가능
로그인 기록 있음 게스트 로그인은 불가하며 로그인 세션의 상태에 따라 수동 또는 자동 로그인

타이틀 화면에 저작권 등을 노출하는 방법은 퍼블리싱 회사에서 별도로 규정한다. 컴투스홀딩스에서 퍼블리싱하는 게임은 타이틀 내에 무료충전소 링크 버튼을 반드시 추가해야 한다.

10. 로그인

API: C2SModuleSns_GetLoginType, C2SModuleSns_Login
게임 타이틀에서 유저가 화면 또는 로그인 버튼을 터치하면 호출하는 동작이다. 상세한 내용은 Hive 개요 > Hive 인증 항목에 기술되어 있다. 모바일 게임의 이용 행태를 고려하여 게임이 백그라운드 상태가 되더라도 일정 시간 동안은 로그인 세션을 유지하도록 권장한다.

11. 대배너

API: C2SModuleHivePromotion_Show (type=banner)
API: C2SModulePromotion_Show (type=fullBanner)
게임 로비에 진입하기 전에 Hive 백오피스에 설정된 대배너를 노출한다. 이에 대한 상세 내용은 Hive 프로모션 항목에 기술되어 있다.

게임 로비의 구성

유저가 Hive에서 제공하는 주요 기능을 이용할 수 있도록 게임 로비 내에는 다음과 같은 아이콘 또는 링크를 제공해야 한다.