RetroAchievements

RetroAchievements

L'intégration de la version multiplateforme est raccordée sur Android, avec le SDK officiel rcheevos 12.5.0 en mode Softcore. La connexion est facultative ; l'application peut être utilisée sans compte.

La reconnaissance des jeux, l'affichage des badges et l'attribution synchronisée de succès restent à valider avec un compte et une ROM reconnue sur téléphone. Un build réussi ne prouve pas un déblocage côté serveur.

Se connecter

1. Ouvrez Paramètres → RetroAchievements, ou le tableau de bord depuis le menu du jeu.
2. Utilisez votre compte RetroAchievements existant.
3. Lancez une ROM reconnue par le service.
4. Consultez le profil, les points, le jeu identifié, les badges et les filtres de succès.

Dans le menu du jeu, l'encart RetroAchievements résume le compte : avatar, nom, points Softcore puis Hardcore, progression du jeu en cours et mode actif (Softcore ou Hardcore). Hors connexion, il invite à se connecter ou affiche la raison donnée par le serveur. Le toucher ouvre le tableau de bord. La session d'un jeu ne dure que le temps de la partie : en quittant le lecteur, la bibliothèque n'affiche plus ses succès.

Une première connexion propre à cette application est nécessaire : le jeton de l'ancienne application n'est pas partagé. Le mot de passe n'est pas conservé ; le jeton est chiffré via Android Keystore.

Console et identification

L'intégration transmet au SDK la console du jeu : Game Boy, Game Boy Color ou Game Boy Advance. La ROM est utilisée localement pour son identification. Un jeu modifié, une région ou une révision différente peut ne pas être reconnu. Le lancement distingue un jeu reconnu, une ROM inconnue du service, un serveur qui ne répond pas et un refus du serveur, avec sa raison.

Le SDK observe la mémoire fournie par l'API C de RavenCore. Les restaurations d'état réinitialisent les conditions temporaires des succès.

Notifications de progression

Le popup affiche un seul succès à la fois. Lorsque plusieurs mesures progressent, leurs notifications passent à tour de rôle, pendant deux secondes chacune par défaut. Les mises à jour d'un même succès sont regroupées avec sa valeur la plus récente, sans repousser le tour des autres.

Les notifications s'appuient sur les mesures de la liste complète du SDK : son événement de progression ne signale que le succès le plus proche de son objectif lorsque plusieurs mesures changent dans la même image. Une valeur déjà atteinte dans la session ne relance pas le popup à chaque oscillation du compteur. Les valeurs présentes au chargement servent de référence et les notifications anciennes sont abandonnées.

Seuls les succès qui possèdent une mesure définie par leur auteur peuvent produire ces notifications. Les mesures sont relevées au rythme du tableau de bord, environ toutes les 1,2 seconde ; plusieurs hausses rapprochées peuvent être regroupées. La notification ne signifie pas que le succès est débloqué ou synchronisé.

Références officielles : intégration de l'indicateur de progression et fonctionnement de Measured.

Tableau de bord et synchronisation

La liste permet de rechercher dans le titre et la description, de filtrer les succès à obtenir ou obtenus et de changer le tri : ordre du jeu, progression mesurée, date de déblocage. Les dates utilisent le fuseau et le format de l'appareil. Le texte d'activité du jeu (Rich Presence), s'il existe, figure sous son titre.

Chaque succès distingue débloqué localement, en attente d'envoi et confirmé par RetroAchievements. Une réponse HTTP seule ne suffit pas : le corps de la réponse doit confirmer la réussite. Comme dans le SDK rcheevos, la réponse « User already has… » confirme aussi le succès : il est déjà sur le compte. Les succès déjà obtenus dans la liste chargée du serveur sont confirmés. Le compteur d'attente concerne le compte connecté sur cet appareil, tous jeux confondus ; il ne modifie jamais les conditions ou les attributions du SDK.

Les demandes légitimes du SDK restent dans le journal chiffré jusqu'à confirmation, à raison d'une entrée par succès : chaque nouvelle tentative du SDK remplace la précédente. À la connexion suivante au même compte, elles sont retentées ; une tentative confirmée retire toutes celles du même succès. Une erreur de stockage affiche un avertissement : garder le jeu ouvert jusqu'à la synchronisation. Se déconnecter explicitement efface ce journal local.

Bandeau des succès

Comme sur PC, chaque notification est un bandeau centré. Le badge descend du haut de l'écran (ou monte du bas), puis le bandeau s'ouvre de part et d'autre avec un en-tête et le titre en grand. À la fin, il se replie dans le badge, qui repart. Un succès débloqué ou un jeu terminé a un cadre et un en-tête dorés. Au lancement d'un jeu reconnu, le bandeau montre l'icône du jeu et le nombre de succès disponibles. Les progressions gardent leur carte, sous le bandeau.

Réglages des notifications

Dans Paramètres → RetroAchievements, les popups de déblocage et de fin de jeu et ceux de progression ont des interrupteurs distincts. Leur position peut être en haut ou en bas. La durée des déblocages va de 2 à 10 secondes, celle des progressions de 1 à 5 secondes ; les nouvelles durées s'appliquent aux prochains tours. Son des succès, activé par défaut, joue un court carillon créé par RavenEmu, mélangé au son du jeu et à son volume. Les erreurs et avis de connexion ne sont pas masqués par l'interrupteur des succès.

Une fin de jeu affiche son image, le compte, le nombre de succès et les points. Jeu terminé correspond au Softcore ; Jeu maîtrisé est réservé au Hardcore. Ce bilan suit l'événement du SDK et ne garantit pas à lui seul la synchronisation de tous les succès : consulter aussi les états d'envoi.

Classements

Depuis le tableau de bord en jeu ou dans les paramètres, choisir un classement puis Meilleurs scores ou Autour de moi. Chaque demande charge au plus 20 entrées ; le lien vers le site ouvre le classement complet. Les scores ne sont demandés qu'après une action, avec un indicateur de chargement, une erreur et un bouton de réessai si nécessaire.

La consultation fonctionne en Softcore. Les tentatives et soumissions officielles nécessitent le Hardcore. Après soumission, le dernier résultat présente le score, le record personnel et le rang renvoyés par le SDK. Aucun score n'est inventé localement.

Préparation du mode Hardcore

Le verrou HardcoreAvailability.APPROVED reste à false. Le réglage ne peut pas activer ce mode tant que RavenEmu n'a pas été validé par RetroAchievements (RAdmin).

L'identifiant HTTP (User-Agent) est composé à partir du build, sans version recopiée à la main, par exemple RavenEmu/0.2.0 (Android 14; arm64-v8a) RavenCore/0.8.0 rcheevos/12.5 : version numérique de l'application, version d'Android et architecture, version du moteur et clause du SDK. Le même identifiant est envoyé au serveur d'images. Le nom du client, RavenEmu, est aussi celui de la version PC : le format reste à confirmer avec RAdmin.

Ce que le code fait déjà en Hardcore :

• Barrière de démarrage. Le jeu n'avance pas tant que le compte n'est pas connecté et que la ROM n'est pas identifiée ; le SDK continue d'être servi pendant l'attente. Dès que le jeu est reconnu, il redémarre depuis l'allumage, comme le demande le SDK, pour effacer les quelques images éventuellement jouées avant.
• Réseau absent. Une connexion ou une identification sans réponse du serveur n'est pas un refus : le jeu reste en attente et l'application réessaie (5 s, puis 10, 20, 40 et 60 s au plus). Un message le dit une fois et propose de désactiver le Hardcore pour jouer hors ligne.
• ROM inconnue ou refus du serveur. Rien ne peut être évalué : le jeu tourne sans succès et un message en donne la raison. Le réglage Hardcore est conservé.
• Défaillance critique. Si le redémarrage du jeu échoue ou si le SDK ne peut pas évaluer une image, le Hardcore est quitté explicitement et le réglage repasse en Softcore.
• États. Le chargement d'un état est refusé dès que le Hardcore est demandé ou actif, par la session de jeu elle-même, juste avant la restauration native et sous son verrou : un changement de mode ne peut pas se glisser entre la vérification et le chargement. L'enregistrement d'un état reste possible.
• Pause. Le menu respecte rc_client_can_pause. Les fonctions de triche, rewind et ralenti ne sont pas proposées dans cette application.

Avant de lever ce verrou, il reste à tester sur appareil le cycle complet d'activation/redémarrage, la barrière de démarrage (en ligne, hors ligne, ROM inconnue), les pauses, le refus de restauration, un déblocage reconnu en Hardcore sur le site et une soumission de classement, puis obtenir la validation externe. Les tests synthétiques et de politique ne remplacent pas ces essais. Le lecteur à deux n'évalue pas les succès ; iOS reste à raccorder.

Références : User-Agent et validation, Hardcore et restrictions, notification de jeu terminé.

Limites

• Hardcore reste désactivé.
• Les classements se consultent en Softcore ; les soumissions restent indisponibles tant que le Hardcore est verrouillé.
• Les déblocages et leur synchronisation nécessitent une validation réelle.
• La première session iOS raccorde le lecteur ; son service RetroAchievements reste à développer.

Données et réseau

La connexion et la session utilisent HTTPS vers RetroAchievements. Le service reçoit les informations de compte et de session, l'identification du jeu et les données de succès prévues par le SDK. Les images de profil et badges sont téléchargées et conservées en cache.

Aucune ROM ni sauvegarde n'est téléversée. Pour les détails de conservation et de traitement, consultez la politique de confidentialité de RavenEmu et celle de RetroAchievements.

Signaler un problème

Indiquez le commit RavenEmu, l'appareil, la console, le jeu/région, l'étape qui échoue et le message visible. Ne publiez ni mot de passe, ni jeton, ni ROM. Voir Dépannage.

Source : contrôleur Android.