Integrar o SDK do Google Play Games para PC com o Unity

project, covering steps from SDK download to initialization and build configuration. keywords_public: Google Play Games PC, Unity, SDK integration, native PC, game development, IL2CPP, manifest, Play Games PC Unity SDK

Este guia oferece instruções detalhadas para integrar o SDK do Google Play Games no PC ao seu projeto do Unity.

Etapa 1: fazer o download do SDK

Faça o download da versão mais recente do pacote do Unity usando o link de download.

Download: SDK do Google Play Games para PCUnity

Etapa 2: importar o pacote

O SDK é distribuído como um arquivo tar compatível com o Unity Package Manager (UPM). Para mais informações, consulte Instalar um pacote UPM de um arquivo tar local

Etapa 3: definir as configurações de build

Para verificar se as bibliotecas nativas são carregadas corretamente, configure seu projeto para usar o back-end de script IL2CPP e direcionar a arquitetura correta.

1. Crie um perfil de build com o Windows como plataforma.

2. Selecione as configurações de plataforma como Windows. Para a arquitetura, use as opções:

   • Intel de 64 bits (recomendado)
   • Intel de 32 bits

   Observação:a plataforma Google Play Games no PC é executada em um ambiente de 64 bits. Você pode criar seu jogo como 32 bits (x86) ou 64 bits (x64).

3. Defina o Scripting Backend como IL2CPP. Para mais informações, consulte Criar um projeto com IL2CPP.

   • Defina o Nível de compatibilidade da API como .NET Standard 2.0 (ou .NET Framework).

Etapa 4: criar o manifesto do aplicativo

Antes de usar o SDK no jogo, é necessário associar o executável do jogo ao nome do pacote do Google Play reivindicado no Play Console. Para fazer isso, adicione um arquivo manifest.xml no mesmo diretório do executável do jogo.

Observação:esta é uma etapa manual que precisa ser realizada.

1. Para criar o arquivo executável do jogo, selecione Arquivo > Build e execução ou clique em Ctrl+B.
2. Abra um editor de texto e crie um novo arquivo chamado manifest.xml.

3. Copie e cole o seguinte código XML no arquivo:

   <?xml version="1.0" encoding="utf-8"?>
   <?Manifest version="1">
      <?Application>
        <?PackageName>com.example.package<?/PackageName>
      <?/Application>
   <?/Manifest>

4. Salve o arquivo como manifest.xml.

5. Mova esse arquivo para a mesma pasta do arquivo executável do jogo criado.

   Exemplo: se o jogo estiver em Builds/MyGame.exe, o manifesto precisará estar em Builds/manifest.xml.

Observação:se você quiser usar o SDK para PC durante o desenvolvimento no Editor do Unity sem precisar assinar digitalmente o executável do jogo ou iniciá-lo no Google Play Games. Para outras etapas de configuração do manifesto, consulte o guia de configuração do modo de desenvolvedor.

Etapa 5: inicializar o SDK

É necessário inicializar o SDK antes de acessar qualquer recurso, como faturamento ou integridade. Use PlayPcSdkFactory para criar o handler de inicialização e iniciar a conexão.

Crie um novo script em C#, por exemplo, SdkInitialization.cs, e adicione o seguinte código:

using UnityEngine;
using System;
using System.Threading.Tasks;
// Import the SDK namespaces
using PlayPcSdkManaged.Initialization;
using PlayPcSdkManaged.Unity;

public class GooglePlayPCSDKInit : MonoBehaviour
{
    // Prevent double-initialization if this script is reloaded
    private static bool _isInitialized = false;

    private void Start()
    {
        // Use the "Safe Runner" pattern to fire the async method
        _ = InitializeSdkAsync();
    }

    private async Task InitializeSdkAsync()
    {
        if (_isInitialized)
        {
            Debug.LogWarning("Google Play PC SDK is already initialized. Skipping.");
            return;
        }

        try
        {
            Debug.Log("Initializing Google Play PC SDK...");

            // 1. Get the Unity-specific initialization handler from the factory
            var initHandler = PlayPcSdkFactory.InitializationHandler;

            // 2. Call InitializeAsync to start the connection
            var result = await GooglePlayInitialization.InitializeAsync(initHandler);

            // 3. Check the result
            if (result.IsOk)
            {
                _isInitialized = true;
                Debug.Log("<color=green>Google Play PC SDK Initialized Successfully!</color>");
                // You can now create BillingClient or IntegrityClient instances
            }
            else
            {
                Debug.LogError($"<color=red>Initialization Failed!</color>");
                Debug.LogError($"Error Code: {result.Code}");
                Debug.LogError($"Message: {result.ErrorMessage}");
            }
        }
        catch (Exception ex)
        {
            // Catch unexpected crashes or task failures
            Debug.LogError($"Exception during initialization: {ex.Message}");
            Debug.LogException(ex);
        }
    }
}

Anexe esse script a um GameObject na primeira cena. Ao executar o jogo, confira a mensagem "SDK Initialized Successfully!" no console.