SDK para Unity (PC, web) / Como migrar para o SDK versão 2.0.0 e superior
  Voltar aos Documentos

SDK para Unity (PC, web)

Como migrar para o SDK versão 2.0.0 e superior

Alterações estruturais na versão 2.0.0

  • Os métodos e classes de solicitação foram substituídos por estáticos.
  • A ID do projeto não é passada aos métodos como um parâmetro. O SDK usa o valor especificado nas configurações do projeto.
  • O token de autorização do usuário não é passado aos métodos como um parâmetro e não é retornado por funções de retorno de chamada. O SDK determina o token com base na autenticação anterior do usuário e o passa para os métodos para obter um catálogo, compras e exibição do inventário.
  • A lógica para determinar as informações sobre um dispositivo móvel foi adicionada ao SDK. Os dados são encapsulados em uma estrutura DeviceInfo.

Veja a lista completa de alterações no registro de mudanças.

Aprimoramento da classe XsollaAuth

  • Substitua as chamadas XsollaAuth.Instance por XsollaAuth.
  • Altere a assinatura do método de retorno de chamada onSuccess utilizado ao chamar o método de autenticação. Substitua Action<string> por Action.
  • Remova a passagem do parâmetro refreshToken ao chamar o método RefreshOAuthToken.
  • Remova a passagem do parâmetro token ao chamar o método GetUserInfo.
  • Substitua a chamada para XsollaAuth.Instace.OAuthLogout por XsollaAuth.Logout e remova a passagem do parâmetro token ao chamar o método.
  • Remova a passagem dos parâmetros deviceType, deviceId, device ao chamar o método AuthViaDeviceID. Remova a lógica para determinar as informações do dispositivo móvel.
  • Altere a assinatura do método de retorno de chamada onSuccess utilizado ao chamar o método Register. Substitua Action<int>, Action, Action<LoginUrlResponse> por Action<LoginLink>.
  • Remova a passagem do parâmetro rememberMe ao chamar o método SignIn.
  • Altere a assinatura do método de retorno de chamada onSuccess utilizado ao chamar os métodos StartAuthByEmail e StartAuthByPhoneNumber. Substitua Action<string> por Action<OperationId>.

Aprimoramento da classe XsollaCart

  • Substitua as chamadas XsollaCart.Instance por XsollaCart.
  • Substitua as chamadas XsollaCart.Instance.PurchaseCart por XsollaCart.CreateOrder.
  • Remova a passagem do parâmetro projectId ao chamar métodos de classe.
  • Se você estiver trabalhando apenas com o carrinho do usuário atual, remova a passagem do parâmetro cartId ao chamar os métodos da classe.

Aprimoramento da classe XsollaOrders

  • Substitua as chamadas XsollaOrders.Instance por XsollaOrders.
  • Altere o código para chamar o método OpenPurchaseUI. Passe o token de pagamento como o parâmetro paymentToken (o parâmetro purhaseData foi substituído por paymentToken).
  • Altere a assinatura do método de retorno de chamada onBrowserClosed utilizado ao chamar o método OpenPurchaseUI. Substitua Action<bool> por Action<BrowserCloseInfo>.
  • Remova a passagem do parâmetro projectId ao chamar métodos de classe.

Aprimoramento da classe XsollaUserAccount

  • Substitua as chamadas XsollaUserAccount.Instance por XsollaUserAccount.
  • Remova a passagem do parâmetro token ao chamar métodos de classe.

Aprimoramento da classe XsollaSubscriptions

  • Substitua as chamadas XsollaSubscriptions.Instance por XsollaSubscriptions.
  • Remova a passagem do parâmetro projectId ao chamar métodos de classe.

Aprimoramento da classe XsollaInventory

  • Substitua as chamadas XsollaInventory.Instance por XsollaInventory.
  • Remova a passagem do parâmetro projectId ao chamar métodos de classe.

Aprimoramento da classe XsollaGameKeys

  • Substitua as chamadas XsollaGameKeys.Instance por XsollaGameKeys.
  • Remova a passagem do parâmetro projectId ao chamar métodos de classe.

Aprimoramento da classe de token

  • Substitua as chamadas Token.Instance por XsollaToken.
  • Substitua as chamadas Token.Instance.GetSteamUserID por SteamUItils.GetSteamUserId.
  • Modifique o código para obter o valor dos tokens de acesso e atualização. Use as propriedades XsollaToken.AccessToken e XsollaToken.RefreshToken.

Atualizar classes utilitárias

  • Substitua o uso das classes AndroidSDKSocialAuthHelper e IosSDKSocialAuthHelper pela chamada XsollaAuth.AuthViaSocialNetwork.
  • Substitua o uso das classes AndroidSDKPaymentsHelper e IosSDKPaymentsHelper pela chamada XsollaWebBrowser.OpenPurchaseUI.

Substituição de pacotes

  1. Abra seu projeto Unity.
  2. Exclua a pasta Xsolla.
  3. Baixe o pacote SDK ou projeto de demonstração.
Observação
Se você usar trechos de código ou uma interface da cena de demonstração em seu projeto, baixe o pacote do projeto de demonstração pois ele já contém os arquivos do SDK. Se você incluiu um projeto de demonstração em seu projeto do Unity, não é preciso integrar o SDK.
  1. Descompacte o pacote.
  2. No Unity Editor, vá para Assets > Import Package > Custom Package no menu principal e selecione o pacote SDK ou do projeto de demonstração.
  3. Na janela de aviso de dependência, clique em Install/Upgrade. Como resultado, a janela Import Unity Package abrirá com uma lista de arquivos verificados e prontos para a instalação. A lista indicará quais arquivos permanecem inalterados, quais serão adicionados e quais serão substituídos.
  4. Clique em Import.
  5. Teste sua aplicação e faça alterações no código do projeto, se necessário.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 22 de Janeiro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!