SDK pour Unity / Connexion via les réseaux sociaux
  Retour à la documentation

SDK pour Unity

Connexion via les réseaux sociaux

Avis
Le SDK ne prend pas en charge l’authentification via les réseaux sociaux dans les builds WebGL.

Dans votre application, vous pouvez implémenter l’authentification utilisateur via des comptes de réseaux sociaux. Si l’utilisateur se connecte pour la première fois via un réseau social, un nouveau compte est automatiquement créé. L’utilisateur n’a pas besoin de saisir de nom d’utilisateur, d’adresse e-mail ou d’autres données.

Il existe deux manières d’implémenter l’authentification via les réseaux sociaux :

  • Authentification Web. Dans ce cas, l’application ouvre un formulaire dans le navigateur pour compléter l’authentification via le réseau social sélectionné. Cette option convient aux applications mobiles et de bureau ;
  • Authentification native. Dans ce cas, l’authentification est effectuée via l’application de réseau social sur l’appareil de l’utilisateur. Cette option ne convient qu’aux applications mobiles.

Note
Pour authentifier les utilisateurs de votre application iOS à l’aide de leur identifiant Apple, Face ID ou Touch ID, implémentez l’authentification Web. Dans ce cas, les méthodes SDK utilisent des bibliothèques natives pour iOS.

La connexion via les réseaux sociaux peut être utilisée comme méthode d’authentification principale ou alternative dans votre application.

Si vous utilisez la connexion via les réseaux sociaux comme méthode d’authentification alternative, le compte de réseau social est automatiquement lié à un compte utilisateur existant si les conditions suivantes sont remplies :

  • l’utilisateur inscrit par nom d’utilisateur/adresse e-mail et mot de passe se connecte à votre application via un compte de réseau social ;
  • le réseau social renvoie une adresse e-mail ;
  • l’adresse e-mail de l’utilisateur sur le réseau social est la même que celle utilisée pour l’inscription dans votre application.

Vous pouvez également implémenter la liaison manuelle d’un compte de réseau social.

Instructions

Pour en savoir plus sur les configurations avancées, consultez nos instructions.

Comment configurer l'authentification Web via les réseaux sociaux

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

Avis
Dans le Compte éditeur, assurez-vous que les options Classic login et Social login sont sélectionnées pour le projet de connexion que vous utilisez dans votre application. Vous pouvez modifier la méthode de connexion ultérieurement en cliquant sur le lien Change Login method. Les paramètres précédemment enregistrés ne seront pas perdus.
  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.

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

    • Pour connecter le réseau social souhaité, cliquez sur l'icône ⚙ et sélectionnez Connect
    • 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
    • Pour connecter simultanément tous les réseaux sociaux disponibles, cliquez sur Select all. Ensuite, dans le menu déroulant Manage, sélectionnez Connect
Note
L’ID et la clé secrète d’application de Xsolla sont utilisés par défaut pour l’authentification. Si votre application est configurée à l’aide d’un compte de développeur de fournisseur de réseau social, vous pouvez spécifier vos propres ID et clé secrète d’application. Des instructions détaillées pour obtenir l’ID et la clé secrète d’application sont disponibles dans les paramètres de la carte de réseau social dans le Compte éditeur.

Intégration côté application

Pour implémenter la logique de connexion via les réseaux sociaux, appelez la méthode SDK AuthViaSocialNetwork et passez les arguments suivants à la méthode :

  • SocialProvider — nom du réseau social ;
  • onSuccess — fonction de rappel d'authentification utilisateur réussie ;
  • onCancelled — fonction de rappel d'annulation d'authentification par l'utilisateur ;
  • onError — fonction de rappel d'erreur.
Note
Un exemple d’implémentation de cette logique est disponible dans le script Assets/Xsolla.Demo/Login/Scripts/Login/Auth/SocialAuth.cs du projet de démo.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Masquer

Comment configurer l'authentification native via les réseaux sociaux

L’authentification native permet aux utilisateurs de se connecter à votre application via un compte de réseau social configuré sur un appareil mobile.

La première fois qu’un utilisateur se connecte, l’application de réseau social est lancée et demande l’autorisation d’authentifier l’utilisateur. Ensuite, l’authentification est effectuée automatiquement sans que l’utilisateur ne fasse quoi que ce soit.

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 le build de votre projet Unity pour Android.
  3. 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.

  1. 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.
  2. Configurez l'asset pour votre projet Unity.
  3. Implémentez la logique d'authentification côté application.

Créer un build de projet Unity pour Android

  1. Accédez à votre projet Unity.
  2. Dans le menu principal, cliquez sur File > Build settings.
  3. Dans le panneau Platform, cliquez sur Android.
  4. Cliquez sur Build.

Pour poursuivre la configuration de l’authentification native, vous aurez besoin :

  • Du nom du package, qui se trouve dans le champ Package Name, sous le panneau Inspector, après avoir sélectionné la plateforme Android dans File > Build settings ;
  • Du nom de classe Android — nom de classe de l’activité principale, y compris l’espace de nom de l’application (par exemple, com.domain.appname.activity). Le nom de classe se trouve dans le AndroidManifest.xml. La balise de l’activité principale doit comprendre une balise intent-filter avec l’action android.intent.action.MAIN et la catégorie android.intent.category.LAUNCHER ;
  • Clé de hachage Android. Vous pouvez l’obtenir avec OpenSSL.

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 du package de votre projet Unity dans le champ Google Play Package Name.
  5. Spécifiez le nom de classe Android de votre projet Unity dans le champ Class Name.
  6. Spécifiez la clé de hachage Android de votre projet Unity dans le champ Key Hashes.
  7. Cliquez sur Save Changes.

Pour poursuivre la configuration de l’authentification native, vous aurez besoin de l’App ID et de l’App Secret, qui se trouvent dans les paramètres du projet sous la section Settings > Basic.

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 Unity :

    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 du package de votre projet Unity dans le champ Package name ;
    5. Spécifiez la clé de hachage Android de votre projet Unity dans le champ SHA-1 certificate fingerprint ;
    6. Cliquez sur Create ;
    7. Cliquez sur OK.

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

Avis
Dans le Compte éditeur, assurez-vous que les options Classic login et Social login sont sélectionnées pour le projet de connexion que vous utilisez dans votre application. Vous pouvez modifier la méthode de connexion ultérieurement en cliquant sur le lien Change Login method. Les paramètres précédemment enregistrés ne seront pas perdus.
  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.
  1. 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.
Note
Pour utiliser l’autorisation via les réseaux sociaux, dans les paramètres de la carte de réseau social dans votre projet, spécifiez l’ID d’application et la clé secrète d’application. Ces informations se trouvent dans votre compte de développeur sur le fournisseur de réseau social. Des instructions détaillées pour obtenir l’ID et la clé secrète d’application sont disponibles dans les paramètres de la carte de réseau social dans le Compte éditeur.

Configurer un asset pour le projet Unity

  1. Accédez à votre projet Unity.
  2. Dans le menu principal, cliquez sur Window > Xsolla > Edit Settings.
  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 Google server ID, spécifiez le Client ID de l'application Web Google API Console ;
    3. Dans le champ WeChat App ID, spécifiez l'AppID des paramètres de l'application WeChat ;
    4. Dans le champ QQ App ID, spécifiez l'AppID des paramètres de l'application QQ.

Intégration côté application

Pour implémenter la logique de connexion via les réseaux sociaux, appelez la méthode SDK AuthViaSocialNetwork et passez les arguments suivants à la méthode :

  • SocialProvider — nom du réseau social ;
  • onSuccess — fonction de rappel d'authentification utilisateur réussie ;
  • onCancelled — fonction de rappel d'annulation d'authentification par l'utilisateur ;
  • onError — fonction de rappel d'erreur.
Note
Un exemple d’implémentation de cette logique est disponible dans le script Assets/Xsolla.Demo/Login/Scripts/Login/Auth/SocialAuth.cs du projet de démo.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Masquer

Liens utiles

Dernière mise à jour: 22 Janvier 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !