animate GO 연동 가이드¶

animate Games Online은 Android 환경에서 스토어 출시를 위한 인증 및 결제를 지원합니다.

앱에 animate Games Online를 연동하려면 사전 계약을 체결해야 합니다. 계약 체결 후 아래 가이드를 참고하여 구현하세요.

사전 준비¶

1. 자격 증명 발급 및 키 값 확인¶

animate GO 개발자 사이트에서 Game ID와 Client Secret, clientId을 확인

2. App ID 준비¶

앱센터 > App ID 관리 > [새 App ID] 에서 OS: Android, 스토어: animate Games Online를 선택하여 App ID를 생성합니다.
App ID 예시: com.[회사명].[프로젝트명].android.ago

3. 보안 키 발급¶

서비스 간 인증 보안 강화를 위해 Hive 콘솔 > 앱센터 > 보안 키 설정에서 보안 키를 반드시 발급받아야 합니다.

4. hive_config.xml에 키 설정¶

Note

animate Games Online 로그인은 Android 플랫폼만 지원합니다.

animate Games Online 로그인을 사용하려면 animate Games Online 개발자 대시보드에서 필요한 키 값을 발급받아야 합니다.

아래 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

Android

        ``` xml
        <properties>
                        <!-- Hive SDK 공통 설정 생략 -->

                        <!-- Hive SDK 인증 설정: START -->
                        <providers>
                                        <!-- animateGO로 로그인 -->    
                                        <animatego clientId="YOUR_ANIMATEGO_CLIENT_ID"/>
                        </providers>
                        <!-- Hive SDK 인증 설정: END -->
        </properties>
        ```

clientId (Android)¶

animate Games Online 개발자 대시보드에서 발급받은 animate Games Online 로그인용 고유 클라이언트 식별자(clientId)를 설정합니다.

5. AAR 라이브러리 추가¶

모듈 수준의 build.gradle 파일에 libs 폴더에 대한 의존성을 설정합니다.

dependencies {
    implementation fileTree(include: ['*.aar'], dir: 'libs')
}

모듈 수준의 libs 폴더에 SDK 배포 버전에 포함된 외부 라이브러리(.aar)를 추가합니다. animate Games Online IdP 로그인 및 빌링 지원 시 아래 파일이 필요합니다.

sdk-XXXXXXXXXXXXXXXXXXXXXXX.aar
예시: sdk-bf62685719935e68ec4100c0d51aa469.aar

6. 로그인 설정¶

Hiv 콘솔 > 인증 > 로그인 설정에서 animate GO IdP를 노출할 App ID를 선택한 후 Game ID와 Client Secret을 입력하여 로그인 설정을 진행합니다.

animate GO 로그인 구현하기¶

animate Games Online 로그인은 OAuth 2.0 Authorization Code + PKCE 방식으로 동작합니다. 로그인 콜백이 정상적으로 동작히려면 animate Games Online 개발자 대시보드에서 앱의 Redirect URIs를 등록하세요.

Redirect URIs는 <packageName>://store-login-callback 형식입니다. <packageName>은 앱의 패키지명으로 대체합니다.

예시: com.com2us.hivesdk.android.ago://store-login-callback

이후 로그인/로그아웃을 참고하여 Android 모바일 기준으로 구현합니다.구현합니다.

animate GO 결재 구현하기¶

animate Games Online 스토어의 결제 결과를 수신하려면 animate Games Online 개발자 대시보드에서 Callback URLs을 등록하세요.

Callback URLs 항목으로 아래의 4개 URL을 등록합니다.

이후 로그인/로그아웃을 참고하여 Android 모바일 기준으로 구현합니다.