SDK para Unreal Engine / Login social
  Voltar aos Documentos

SDK para Unreal Engine

Login social

Em seu aplicativo, você pode implementar a autenticação do usuário usando sua conta nas redes sociais. Se o primeiro login do usuário for por meio de uma rede social, uma nova conta será criada automaticamente. O usuário não precisa inserir um nome de usuário, endereço de e-mail ou outros dados.

Há duas maneiras de implementar a autenticação por meio de redes sociais:

  • Autenticação pela web. Nesse caso, o aplicativo abre um formulário no navegador para concluir a autenticação por meio da rede social selecionada. Essa opção é adequada para aplicativos móveis e desktop.
  • Autenticação nativa. Nesse caso, a autenticação é realizada por meio do aplicativo da rede social no dispositivo do usuário. Esta opção só é adequada para aplicativos móveis.

Observação
Para autenticar usuários de seu aplicativo iOS usando seu ID Apple, Face ID ou Touch ID, implemente a autenticação pela web. Nesse caso, os métodos SDK usam bibliotecas nativas para iOS.

O login social pode ser o método de autenticação principal ou alternativo do seu aplicativo.

Se você usar o login social como um método de autenticação alternativo, a conta da rede social será vinculada automaticamente a uma conta de usuário existente se as seguintes condições forem atendidas:

  • Um usuário que se cadastrou com um nome de usuário/endereço de e-mail e senha fez login no seu aplicativo por meio de uma conta de rede social.
  • Uma rede social retorna um endereço de e-mail.
  • O endereço de e-mail do usuário em uma rede social corresponde ao endereço de e-mail utilizado para se cadastrar em seu aplicativo.

Você também pode implementar a vinculação manual de uma conta de rede social.

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como configurar a autenticação pela web via redes sociais

O SDK oferece suporte aos seguintes provedores para o login social:

  • Amazon
  • Apple
  • Baidu
  • Battle.net
  • Discord
  • Facebook
  • GitHub
  • Google
  • Kakao
  • LinkedIn
  • MSN
  • Mail.ru
  • Microsoft
  • Naver
  • Odnoklassniki
  • PayPal
  • QQ
  • Reddit
  • Steam
  • Twitch.tv
  • Twitter
  • VK
  • Vimeo
  • WeChat
  • Weibo
  • Xbox Live
  • Yahoo
  • Yandex
  • YouTube

Para configurar a autenticação por meio de serviços da web:

  1. Na interface do aplicativo, adicione botões para autenticação via redes sociais.
  2. Configure as conexões sociais para um projeto de login na Conta de Distribuidor.
  3. Implemente a lógica de autenticação no lado do aplicativo.

Configure conexões sociais para o projeto Login na Conta de Distribuidor Xsolla

Aviso
Na Conta de Distribuidor, verifique se as opções Social login e Social login estão selecionadas para o projeto Login que você usa em seu aplicativo. Você poderá alterar o método de login mais tarde clicando no link Change Login method. As configurações salvas anteriormente não serão perdidas.
  1. Abra seu projeto na Conta de Distribuidor.
  2. No menu lateral, clique em Login.
  3. Clique em Configure no painel de um projeto Login.
  4. Vá para o bloco Authentication e selecione a seção Social login.

  1. Conecte as redes sociais que os usuários podem usar para se cadastrar e fazer login no aplicativo:

    • Para conectar uma rede social, clique no ícone ⚙ e selecione Connect.
    • Para conectar várias redes sociais ao mesmo tempo, selecione os painéis necessários (suas bordas ficarão verdes). Em seguida, no menu suspenso Manage, selecione Connect.
    • Para conectar todas as redes sociais disponíveis, clique em Select all. Em seguida, no menu suspenso Manage, selecione Connect.
Observação
O ID do aplicativo e a chave secreta da Xsolla são usadas para a autenticação por padrão. Se seu aplicativo estiver configurado usando uma conta de desenvolvedor do provedor social, você poderá especificar seu próprio ID do aplicativo e chave secreta. Você pode encontrar instruções mais detalhadas sobre a localização do ID do aplicativo e o segredo nas configurações do cartão de rede social na Conta de Distribuidor.

Integre no lado do aplicativo

Implemente a seguinte lógica ao clicar no botão de login social:

  1. Abra a página de cadastro/login usando o método SDK AuthenticateViaSocialNetwork.
  2. Inscreva-se nos eventos SuccessCallback, ErrorCallback e CancelCallback.
  3. Obtenha o token do parâmetro LoginData ou chamando o método GetLoginData e utilize-o nas solicitações aos servidores Xsolla.
Observação
Após a autenticação bem-sucedida, a função SuccessCallback retorna um token de autorização no parâmetro LoginData. O token é armazenado em um cache local no método GetLoginData.

Você pode encontrar um exemplo da implementação dessa lógica no blueprint BP_LoginController do projeto de demonstração.

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.
Ocultar

Como configurar a autenticação nativa via redes sociais

A autenticação nativa permite que os jogadores façam login em seu aplicativo por meio de aplicativos instalados que usam contas de redes sociais. Atualmente, o SDK implementou a autenticação nativa através das seguintes redes sociais:

  • Google
  • Facebook
  • WeChat
  • QQ

Para configurar a autenticação nativa:

  1. Na interface do aplicativo, adicione botões para autenticação via redes sociais.
  2. Crie sua compilação do projeto Unreal Engine para Android.

Observação
Para configurações de autenticação nativa adicionais, você precisará do nome do pacote do seu aplicativo Android encontrado na seção Edit > Project Settings > Platforms > Android no campo Android Package Name (‘com.YourCompany.Project’ [PROJECT] is replaced with project name).
  1. Configure o aplicativo na conta de desenvolvedor para a rede social:
    1. Para a autenticação via Facebook:
      1. Cadastre-se e crie um novo aplicativo.
      2. Configure a página do aplicativo em sua conta de desenvolvedor do Facebook.
    2. Para a autenticação via Google, configure o projeto no Google API Console.
    3. Para a autenticação via WeChat:
      1. Cadastre-se e crie um novo aplicativo.
      2. Envie a solicitação de revisão.
    4. Para a autenticação via QQ:
      1. Cadastre-se e crie um novo aplicativo.
      2. Envie a solicitação de revisão.
  1. Configure a autenticação via redes sociais no lado Xsolla:
    1. Para Facebook e Google, configure as conexões sociais na Conta de Distribuidor.
    2. Para WeChat e QQ, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
  2. Configure o SDK para o seu projeto Unreal Engine.
  3. Implemente a lógica de autenticação no lado do aplicativo.

Configure a página do aplicativo na sua conta de desenvolvedor do Facebook

  1. Vá para as configurações do projeto na conta de desenvolvedor do Facebook.
  2. Vá para Settings > Basic.
  3. Clique em Add Platform e selecione Android.
  4. Especifique o nome do pacote do seu aplicativo Android no campo Google Play Package Name.
  5. Especifique um nome de classe totalmente qualificado da Atividade no campo Class Name (o valor padrão é com.epicgames.ue4.GameActivity).
  6. Gere uma chave hash e insira-a no campo Key Hashes.
  7. Clique em Save changes.

Para mais configurações de autenticação nativa, você precisará de:

  • App ID e App Secret, encontrados nas configurações do projeto na seção Settings > Basic.
  • Client token encontrado nas configurações do projeto na seção Settings > Advanced > Security.

Configure o projeto no Google API Console

  1. Vá para o Google API Console.
  2. Clique em New Project.
  3. Especifique o Project name e Location, e clique em Save.
  4. Vá para o projeto criado e clique em OAuth consent screen no menu lateral.
  5. Selecione a opção External e clique em Create.
  6. Especifique os parâmetros necessários e clique em Save.
  7. Clique em Credentials no menu lateral.
  8. Crie um cliente OAuth 2.0 para seu aplicativo Android:

    1. Clique em Create credentials e selecione OAuth client ID.
    2. Especifique Android no campo Application type.
    3. Especifique o Name.
    4. Especifique o nome do pacote do seu aplicativo Android no campo Package name.
    5. Obtenha a chave SHA.
    6. Especifique a chave SHA gerada na etapa anterior SHA-key no campo SHA-1 certificate fingerprint.
    7. Clique em Create.
    8. Clique em OK.

  1. Crie um cliente OAuth 2.0 para o aplicativo web:
    1. Clique em Create credentials e selecione OAuth client ID.
    2. Especifique Web application no campo Application type.
    3. Especifique o Name.
    4. Clique em Add URI na seção Authorized redirect URIs e especifique o URL https://login.xsolla.com/api/social/oauth2/callback.
    5. Clique em Create.
    6. Clique em OK.

Para configurações de autenticação nativa adicionais, você precisará do Client ID e Client Secret, encontrados nas configurações do ID do Cliente para o aplicativo web.

Configure conexões sociais para o projeto Login na Conta de Distribuidor Xsolla

Aviso
Na Conta de Distribuidor, verifique se as opções Social login e Social login estão selecionadas para o projeto Login que você usa em seu aplicativo. Você poderá alterar o método de login mais tarde clicando no link Change Login method. As configurações salvas anteriormente não serão perdidas.
  1. Abra seu projeto na Conta de Distribuidor.
  2. No menu lateral, clique em Login.
  3. Clique em Configure no painel de um projeto Login.
  4. Vá para o bloco Authentication e selecione a seção Social login.
  1. Para configurar uma rede social, vá para o cartão de rede social, clique no ícone ⚙ à direita do título e selecione Connect.
Observação
Para usar a autorização de rede social, nas configurações do cartão de rede social, especifique o ID do aplicativo e o segredo do aplicativo em seu projeto. O ID do aplicativo e o segredo estão disponíveis na conta de desenvolvedor do provedor social. Você pode encontrar instruções mais detalhadas sobre a localização do ID do aplicativo e o segredo nas configurações do cartão da rede social na Conta de Distribuidor.

Configure o SDK para o projeto Unreal Engine

  1. Vá para o seu projeto Unreal Engine.
  2. Vá para Settings > Project Settings > Plugins > Xsolla Settings > Android.
  3. Especifique o ID do aplicativo:
    1. Especifique o ID do App obtido na conta de desenvolvedor do Facebook no campo Facebook App Id.
    2. Especifique o token do cliente da conta de desenvolvedor do Facebook no campo Facebook Client Token.
    3. Especifique o ID do Cliente para um aplicativo web no Google API Console no campo Google App Id.
    4. Especifique o campo AppID obtido nas configurações do aplicativo WeChat no campo We Chat App Id.
    5. Especifique o AppID obtido nas configurações do aplicativo QQ no campo QQ App Id.

Integre no lado do aplicativo

Ao clicar no botão de login social, implemente a chamada do método LaunchNativeSocialAuthentication. Um exemplo de implementação é fornecido no BP_LoginController no método do controlador AuthenticateViaSocialNetwork no projeto de demonstração.

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.
Ocultar

Links úteis

Ú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!