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 Games 클라이언트의 Google 계정을 사용합니다. 이렇게 하면 SDK가 IPC를 통해 PC용 Google Play 게임즈 클라이언트와 안전하게 통신할 수 있으므로 플레이어에게는 더 원활한 환경을 제공하고 개발자에게는 더 안전한 환경을 제공합니다.

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

제품 목록 가져오기

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

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

구매 증대

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

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

구매 흐름 시작

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

SDK에서 BillingClient's LaunchPurchaseFlow 함수를 호출하여 프로세스를 시작합니다. SDK는 필요한 모든 작업을 처리합니다.

구매 처리

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

이 프로세스는 API 솔루션과 SDK 솔루션 모두에서 비슷합니다.

API 솔루션의 ProductPurchase.purchaseToken 또는 SDK 솔루션의 ProductPurchaseDetails's purchase_token과 같이 구매에서 purchaseToken을 가져온 후 확인을 위해 백엔드로 보냅니다.

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

테스트를 위해 제출

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

제출을 위한 패키지

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