Passer au contenu principal

Correctif pour l’utilisation de LoginWithGoogleAccount avec Play Games Plugin for Unity v0.11.x

Cet article décrit une solution de contournement lorsque vous recevez des erreurs en utilisant l’API LoginWithGoogleAccount après la mise à niveau vers une version de Play Games Plugin for Unity. L’erreur se produit lorsque des joueurs existants n’ont pas migré vers LoginWithGooglePlayGamesServices après la mise à niveau de Play Games Plugin for Unity vers une version supérieure ou égale à v0.11.x. En effet, Google a supprimé la possibilité d’ajouter des étendues supplémentaires dans les versions du plug-in supérieures ou égales à 0.11.x. Cette solution de contournement doit être considérée comme une alternative de repli, car la connexion via le navigateur peut affecter l’expérience du joueur.

Avant de commencer

Suivez ces étapes générales pour corriger l’authentification lors de l’utilisation de la version la plus récente du plug-in.
  1. Appeler manuellement les API Google OAuth2
  2. Effectuer l’authentification du joueur dans un onglet du navigateur
  3. Renvoyer un code d’authentification de redirection vers le jeu à l’aide des liens profonds Android.

Recommandation

Tant que vous utilisez encore la version 0.10.x du plug-in, migrez vos utilisateurs vers l’API LoginWithGooglePlayGamesServices. Utilisez les étapes suivantes comme méthode de repli pour le reste de vos joueurs après la mise à niveau vers la version 0.11.x ou ultérieure du plug-in.

Étapes de correction

  1. Ajoutez un intent Android à votre jeu à l’aide des liens profonds. (Étapes adaptées de Unity - Manual: Deep linking on Android (unity3d.com)) a. Dans la fenêtre Project, accédez à Assets > Plugins > Android. b. Créez un nouveau fichier et nommez-le AndroidManifest.xml. Unity traite automatiquement ce fichier lorsque vous générez votre application. c. Copiez l’exemple de manifeste suivant dans le nouveau fichier, mettez à jour l’élément data avec l’URI de votre application et enregistrez-le. Pour plus d’informations sur la création d’une balise data appropriée, consultez cet article.
    d. Assurez-vous que la propriété autoVerify existe sur la balise intent-filter.
  2. Pour que les liens profonds fonctionnent, à partir d’Android 12, Google exige désormais que les développeurs hébergent un fichier assetlinks.json à un emplacement connu afin de rediriger correctement vers votre application. Par exemple, si votre URI de redirection est https://mytestapp.com/path1/subpath, vous devez héberger un fichier assetlinks.json valide à l’adresse https://mytestapp.com/.well-known/assetlinks.json ; sinon, les liens profonds ne fonctionnent pas et vous n’êtes pas redirigé vers votre application pour continuer. Pour plus d’informations sur la création d’un fichier assetlinks.json, consultez Verify Android App Links.
  3. Ajoutez le traitement des liens profonds à votre jeu. (Étapes adaptées de Unity - Manual: Deep linking (unity3d.com)).
  4. Ajoutez du code pour lancer un navigateur vers l’API Google OAuth2 et laisser le joueur se connecter via le navigateur. Si le joueur est déjà connecté dans son navigateur, la transition est transparente ; sinon, il doit saisir ses informations d’identification.
    L’URI de redirection doit correspondre au filtre d’intent Android ajouté à l’étape 1. Ainsi, lorsque l’utilisateur termine l’authentification, le navigateur accède à cet URI de redirection et doit demander à l’utilisateur s’il souhaite revenir à l’application.
  5. Vous devriez maintenant être prêt à tester. Lorsque vous déclenchez l’authentification, un navigateur doit s’ouvrir et l’utilisateur doit se connecter en conséquence. À moins que les données du navigateur ne soient supprimées, cette étape ne devrait être effectuée qu’une seule fois. Utilisation de LoginWithGoogleAccount, étape 1
  6. Une fois l’authentification terminée par l’utilisateur, le navigateur demande quelle application doit ouvrir l’URL de redirection. Utilisation de LoginWithGoogleAccount, étape 2
  7. Cette action ramène à notre application, et nous pouvons récupérer le code à partir des paramètres de requête de l’URL de redirection, puis appeler LoginWithGoogleAccount. Utilisation de LoginWithGoogleAccount, étape 3
  8. Enfin, nous vous recommandons d’utiliser cette méthode comme alternative de repli pour tous les utilisateurs qui n’ont pas pu être migrés à l’aide des étapes de migration.
N’oubliez pas que vous devez suivre les utilisateurs déjà migrés vers LoginWithGooglePlayGamesServices, privilégier le mécanisme de connexion automatique fourni par le plug-in et n’utiliser cette méthode que comme solution de contournement pour les utilisateurs qui n’ont pas été migrés.
Dernière modification le 6 octobre 2026