API에서 SDK로 이전

PC용 Google Play 게임즈 네이티브 게임이 Play 결제 API를 직접 호출하는 경우 PC SDK를 사용하도록 게임을 이전해야 합니다.

사용 중인 게임 엔진에 따라 C++ SDK 또는 C# SDK을 통합할 수 있습니다. 네이티브 게임을 SDK로 이전하는 데 사용할 수 있는 예를 보여주는 샘플 프로젝트를 참고하세요.

설정 및 준비

이 섹션에서는 API 기반 솔루션에서 PC용 Google Play 게임즈 네이티브 SDK로 이전하는 단계를 설명합니다.

명령줄 인수

PC용 Google Play 게임즈 네이티브 SDK는 게임 프로세스 시작 중에 전달되는 일부 명령줄 인수를 사용하여 사용자를 인증합니다. 이러한 인수는 SDK 초기화를 호출하는 프로세스에 전달해야 합니다. 게임 시작에 여러 프로세스가 포함되는 경우 최종적으로 SDK를 사용하는 프로세스에 모든 인수가 전달되는지 확인해야 합니다. 설정의 멀티 게임 프로세스 지원 단계를 확인하세요.

API 매핑

이전을 완료하려면 Play 서버에 대한 모든 직접 API 호출을 삭제해야 합니다. 동일한 기능을 구현하기 위한 SDK의 해당 함수 호출이 있습니다. 이 섹션에는 각 기능의 매핑이 나열되어 있습니다.

Google 로그인

Google 로그인은 Google로 로그인이라고도 하며, Google 계정이 있는 사용자에게 원클릭 인증 옵션을 제공하는 OAuth 인증 방법입니다. API 기반 프로젝트에서는 플레이어의 계정을 구매와 연결합니다. SDK 기반 솔루션에는 이 연결이 필요하지 않습니다.

SDK 기반 솔루션은 플레이어의 게이머 프로필 및 권한과 이미 연결된 Google Play 게임즈 클라이언트의 Google 계정을 사용합니다. 이렇게 하면 SDK가 IPC를 통해 Google Play 게임즈 클라이언트와 안전하게 통신할 수 있으므로 플레이어에게는 더 원활한 환경을 제공하고 개발자에게는 더 안전한 환경을 제공합니다.

Google 로그인 대신 가능한 한 빨리 SDK 초기화를 호출합니다. 오류 코드에 따라 조치를 취하여 게임 런타임에 안전한 환경을 제공하세요.

제품 목록 가져오기

API 솔루션에서 백엔드 서버는 Play 개발자 API inappproduct.gets 엔드포인트를 사용하여 제품 목록을 가져옵니다.

SDK에서 QueryProductDetails 함수를 사용하여 클라이언트에서 직접 인앱 상품 목록을 가져옵니다.

구매 증대

API 솔루션에서 백엔드 서버는 Play 개발자 API purchases.products.get 엔드포인트를 사용하여 사용자 구매를 가져옵니다.

SDK에서 게임 클라이언트의 QueryPurchases 함수를 직접 사용합니다.

구매 흐름 시작

API 솔루션에서 구매 흐름을 시작하려면 설정 및 필요한 토큰 획득을 위해 여러 엔드포인트를 호출해야 합니다.

SDK에서 BillingClient의 LaunchPurchaseFlow 함수를 호출하여 프로세스를 실행합니다. SDK가 필요한 모든 작업을 처리합니다.

구매 처리

사용자의 구매 처리에는 구매가 합법적인지 성공적으로 검증한 후 구매를 확인하고 사용하는 작업이 포함됩니다. API 솔루션과 SDK 솔루션 모두 보안을 위해 백엔드에서 완료해야 하는 단계를 권장합니다.

API 솔루션과 SDK 솔루션 모두 프로세스가 유사합니다.

API 솔루션의 ProductPurchase.purchaseToken 또는 SDK 솔루션의 ProductPurchaseDetails의 purchase_token과 같이 구매에서 purchaseToken을 가져온 후 인증을 위해 백엔드로 전송합니다.

확인이 완료되면 백엔드에서 자격을 부여한 후 구매를 안전하게 확인하거나 사용할 수 있습니다.

테스트용으로 제출

테스트를 위해 게임을 제출하려면 다음 단계를 따르세요.

제출용 패키지

SDK를 사용하는 게임은 Windows App Bundle 형식으로 패키징되어 Play Console을 통해 업로드되어야 합니다. 문서를 참고하여 다음을 위해 Windows App Bundle에 게임을 패키징하세요.