Le SDK prend en charge la connexion via les fournisseurs suivants :

• 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

Pour configurer l’authentification via les services Web :

1. Dans l’interface de l’application, ajoutez des boutons d’authentification via les réseaux sociaux.
2. Configurez les réseaux sociaux pour le projet de connexion dans le Compte éditeur.
3. Implémentez la logique d’authentification côté application.

Configurer les réseaux sociaux pour le projet de connexion dans le Compte éditeur Xsolla

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Login.
3. Dans le volet du projet de connexion, cliquez sur Configure.
4. Accédez au bloc Authentication et sélectionnez la section Social login.

5. Connectez les réseaux sociaux que les utilisateurs peuvent utiliser pour s'inscrire et se connecter à l'application :

1. • Pour connecter le réseau social souhaité, cliquez sur l'icône ⚙ et sélectionnez Connect

1. • Pour connecter plusieurs réseaux sociaux à la fois, sélectionnez les volets requis (leurs bordures deviennent vertes). Ensuite, dans le menu déroulant Manage, sélectionnez Connect

1. • Pour connecter simultanément tous les réseaux sociaux disponibles, cliquez sur Select all. Ensuite, dans le menu déroulant Manage, sélectionnez Connect

Intégration côté application

Implémentez la logique suivante lorsque l’utilisateur clique sur le bouton de connexion via un réseau social :

1. Ouvrez la page d'inscription/connexion à l'aide de la méthode SDK AuthenticateViaSocialNetwork.
2. Abonnez-vous aux événements SuccessCallback, ErrorCallback et CancelCallback.
3. Obtenez un jeton à partir du paramètre LoginData ou en appelant la méthode GetLoginData et utilisez-le dans les requêtes aux serveurs Xsolla.

Un exemple d’implémentation de cette logique est disponible dans le blueprint BP_LoginController du projet de démo.

L’authentification native permet aux joueurs de se connecter à votre application via des applications installées qui utilisent des comptes de réseaux sociaux. Actuellement, le SDK implémente l’authentification native via les réseaux sociaux suivants :

• Google
• Facebook
• WeChat
• QQ

Pour configurer l’authentification native :

1. Dans l’interface de l’application, ajoutez des boutons d’authentification via les réseaux sociaux.
2. Créez un build de votre projet Unreal Engine pour Android.

2. Configurez l'application dans le compte de développeur de réseau social :
   1. Pour l'authentification via Facebook :
      1. Inscrivez-vous et créez une nouvelle application ;
      2. Configurez la page de l'application dans votre compte de développeur Facebook.
   2. Pour l'authentification via Google, configurez le projet dans Google API Console.
   3. Pour l'authentification via WeChat :
      1. Inscrivez-vous et créez une nouvelle application ;
      2. Soumettez la demande pour examen.
   4. Pour l'authentification via QQ :
      1. Inscrivez-vous et créez une nouvelle application ;
      2. Soumettez la demande pour examen.

3. Configurez l'authentification via les réseaux sociaux côté Xsolla :
   1. Pour Facebook et Google, configurez les réseaux sociaux dans le Compte éditeur ;
   2. Pour WeChat et QQ, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.
4. Configurez le SDK pour votre projet Unreal Engine.
5. Implémentez la logique d'authentification côté application.

Configurer une page d'application dans le compte de développeur Facebook

1. Accédez aux paramètres du projet dans le compte de développeur Facebook.
2. Accédez à Settings > Basic.
3. Cliquez sur Add Platform et sélectionnez Android.
4. Spécifiez le nom de package de votre application Android dans le champ Google Play Package Name.
5. Spécifiez le nom complet de classe Activity dans le champ Class Name (la valeur par défaut est com.epicgames.ue4.GameActivity).
6. Générez la clé de hachage et spécifiez-la dans le champ Key Hashes.
7. Cliquez sur Save Changes.

Pour poursuivre la configuration de l’authentification, vous aurez besoin des éléments suivants :

• App ID et App Secret, qui se trouvent dans les paramètres du projet sous la section Settings > Basic ;
• Client token, qui se trouve dans les paramètres du projet sous la section Settings > Advanced > Security.

Configurer un projet dans Google API Console

1. Accédez à Google API Console.
2. Cliquez sur New Project.
3. Spécifiez Project et Location et cliquez sur Save.
4. Accédez au projet créé et cliquez sur l'OAuth consent screen dans le menu latéral.
5. Sélectionnez l'option External et cliquez sur Create.
6. Spécifiez les paramètres nécessaires et cliquez sur Save.
7. Cliquez sur Credentials dans le menu latéral.
8. Créez un client OAuth 2.0 pour votre application Android :

1. 1. Cliquez sur Create credentials et sélectionnez OAuth client ID ;
   2. Spécifiez Android dans le champ Application type ;
   3. Spécifiez Name ;
   4. Spécifiez le nom de package de votre application Android dans le champ Package name ;
   5. Générez une clé SHA ;
   6. Spécifiez la clé SHA générée à l'étape précédente dans le champ SHA-1 certificate fingerprint ;
   7. Cliquez sur Create ;
   8. Cliquez sur OK.

9. Créez un client OAuth 2.0 pour l'application Web :
   1. Cliquez sur Create credentials et sélectionnez OAuth client ID ;
   2. Spécifiez Web application dans le champ Application type ;
   3. Spécifiez Name ;
   4. Cliquez sur Add URI dans la section Authorized redirect URIs et spécifiez https://login.xsolla.com/api/social/oauth2/callback ;
   5. Cliquez sur Create ;
   6. Cliquez sur OK.

Pour poursuivre la configuration de l’authentification native, vous aurez besoin du Client ID et du Client Secret, qui se trouvent dans les paramètres de l’ID client de l’application Web.

Configurer les réseaux sociaux pour le projet de connexion dans le Compte éditeur Xsolla

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Login.
3. Dans le volet du projet de connexion, cliquez sur Configure.
4. Accédez au bloc Authentication et sélectionnez la section Social login.

5. Pour configurer un réseau social, accédez à la carte de réseau social, cliquez sur l'icône ⚙ à droite du nom, puis sélectionnez Connect.

Configurer le SDK pour un projet Unreal Engine

1. Accédez à votre projet Unreal Engine.
2. Accédez à Settings > Project Settings > Plugins > Xsolla Settings > Android.
3. Spécifiez l'ID d'application :
   1. Dans le champ Facebook App Id, spécifiez l'ID d'application du compte de développeur Facebook ;
   2. Dans le champ Facebook Client Token, spécifiez le Client token du compte de développeur Facebook ;
   3. Dans le champ Google App Id, spécifiez le Client ID de l'application Web Google API Console ;
   4. Dans le champ We Chat App Id, spécifiez l'AppID des paramètres de l'application WeChat ;
   5. Dans le champ QQ App Id, spécifiez l'AppID des paramètres de l'application.

Intégration côté application

Implémentez l’appel à la méthode LaunchNativeSocialAuthentication lorsque l’utilisateur clique sur le bouton de connexion via un réseau social. Un exemple d’implémentation est fourni dans le projet de démo dans la méthode AuthenticateViaSocialNetwork du contrôleurBP_LoginController.