Réalisations

1. Accédez au tableau de bord développeur(se)s⁠ > Engagement > Achievements (Succès).
2. Sélectionnez Create Achievement (Créer un succès) et renseignez les informations suivantes :
   • API Name (Nom de l’API) : chaîne unique pour référencer le succès dans votre application. Attention, le nom est sensible à la casse et doit correspondre exactement à celui utilisé dans votre code.
   • Localization and Manage Languages (Localisation et gestion des langues) : (Facultatif) localisez le succès dans plusieurs langues. Sélectionnez Manage Languages (Gérer les langues), choisissez les langues souhaitées et saisissez les informations correspondantes. L’affichage dépendra des paramètres régionaux de l’appareil de l’utilisateur ou de l’utilisatrice.
     User Data Warning

     N’utilisez aucune information personnelle identifiable.
   • Title (Titre) : nom court et descriptif visible par l’utilisateur·ice.
   • Description : description complète du succès, incluant éventuellement comment le débloquer ou l’obtenir.
   • Unlocked Description (Optional) (Description débloquée (Facultatif) : remplace la description initiale une fois le succès débloqué.
   • Locked and Unlocked Icons (Optional) (Icônes verrouillée et déverrouillée (Facultatif)) : icônes associées au succès. L’icône verrouillée s’affiche pour les personnes n’ayant pas obtenu le succès, l’icône déverrouillée pour celles l’ayant obtenu. Si vous ne fournissez qu’une icône déverrouillée, nous utiliserons une version en niveaux de gris comme icône verrouillée. Sans icône, nous utiliserons une icône par défaut.
   • Write Policy (Politique d’écriture) : choisissez l’une des deux options :
     • Client Authoritative (par défaut) : l’application cliente peut écrire ou débloquer la progression du succès.
     • Server Authoritative : seules les API S2S peuvent écrire ou mettre à jour le succès, généralement pour réduire la triche lors de sessions de jeu gérées par des serveurs de confiance. L’application cliente peut toujours consulter les informations et la progression.
   • Is Achievement Secret (Le succès est-il secret) : choisissez Oui/Non pour masquer ou non le titre, la description, l’icône et la progression jusqu’au déblocage complet du succès. Non par défaut.
   • Type : Meta Quest prend en charge trois types de succès, chacun avec un mécanisme de déblocage différent :
     • Simple : succès de type tout ou rien. Ils se débloquent par un évènement unique ou l’achèvement d’un objectif précis. Par exemple, un succès simple est débloqué lorsque le ou la joueur·se atteint le haut de la montagne.
     • Compteur : succès débloqués lorsqu’un compteur atteint une cible définie. Vous devez définir la cible à atteindre qui déclenchera le succès. Par exemple, un succès de type Compteur avec une cible de 10 sera en cours de déblocage lorsqu’un·e joueur·se vainc 3 zombies (c’est-à-dire tout nombre inférieur à 10) et sera débloqué lorsque le ou la joueur·se aura vaincu 10 zombies.
     • Champs de bits : succès débloqués lorsqu’un nombre cible de bits dans un champ de bits est défini. Vous devez définir la cible et la longueur du champ de bits qui déclenchent le succès. Par exemple, un succès de type champ de bits avec une cible de 5 est en cours de déblocage lorsque bitfield_progress est « 000110 » et sera complètement débloqué lorsque bitfield_progress atteindra « 111110 ».
3. Sélectionnez Publish (Publier) pour enregistrer le succès. Vous pourrez le mettre à jour à tout moment dans le Tableau de bord développeur(se).

1. Dans votre Blueprint, ajoutez l’action Get Cached Achievement Description (Obtenir la description des succès mis en cache), accessible dans le menu contextuel Actions du Blueprint sous Online > Achievements (En ligne > Succès), pour récupérer les informations concernant un succès spécifique, y compris son type.
2. Ensuite, ajoutez Get Cached Achievement Progress (Obtenir la progression des succès mis en cache) pour récupérer la progression de cet·te utilisateur·ice.
3. Convertissez la valeur renvoyée au format approprié pour la présenter à l’utilisateur·ice.

1. Dans votre Blueprint, ajoutez Get Cached Achievement Description (Obtenir la description des succès mis en cache) pour récupérer les informations concernant un succès spécifique, y compris son type.
2. Ensuite, ajoutez Write Achievement Progress (Écrire la progression des succès) pour écrire la progression de cet·te utilisateur·ice. Lorsque vous écrivez la progression, convertissez-la comme suit :
   1. Simple : débloquez lorsque cet élément est appelé avec une valeur quelconque.
   2. Compteur : ajoutez la valeur de WriteObject à la progression des succès. Seules les valeurs Int32, Int64, UInt32 et UInt64 sont prises en charge.
   3. Champ de bits : utilisez une série de 0 et 1 pour le masque de bits. Les valeurs Int32 seront converties en leur représentation de chaîne : 101 → 101. Les valeurs de chaîne seront utilisées telles qu’elles ont été transmises.

curl -X POST -d "access_token=OC|$APP_ID|$APP_SECRET" -d "api_name=VISIT_3_CONTINENTS" -d "achievement_type=BITFIELD" -d "achievement_write_policy=SERVER_AUTHORITATIVE" -d "target=3" -d "bitfield_length=7" -d "is_archived=false" -d "title=Achievement Title" -d "description=How to earn me" -d "unlocked_description_override=You did it" -d "is_secret=false" -d "locked_image_file=@/path/to/locked_icon.png;type=image/png" -d "unlocked_image_file=@/path/to/unlocked_icon.png;type=image/png" https://graph.oculus.com/$APPID/achievement_definitions

{"id":"1074233745960170"}

curl -X GET "https://graph.oculus.com/$APP_ID/achievement_definitions?fields=api_name,achievement_type,achievement_write_policy,target,bitfield_length,is_archived,title,description,unlocked_description_override,is_secret,locked_image_uri,unlocked_image_uri&api_names=\[\"VISIT_3_CONTINENTS\"\]&access_token=OC\|$APP_ID\|$APP_SECRET"

{
    "data": [{
        "id": "1074233745960170",
        "api_name": "VISIT_3_CONTINENTS",
        "achievement_type": "BITFIELD",
        "achievement_write_policy": "SERVER_AUTHORITATIVE",
        "target": 3,
        "bitfield_length": 7,
        "is_archived": false,
        "title": "Achievement Title",
        "description": "How to earn me",
        "unlocked_description_override": "You did it",
        "is_secret": false,
        "locked_image_uri": "https://scontent.oculuscdn.com/...",
        "unlocked_image_uri": "https://scontent.oculuscdn.com/..."
    }]
}

curl -X POST -d "access_token=OC|$APP_ID|$APP_SECRET" -d "api_name=MY_ACHIEVEMENT" -d "add_count=25" -d "force_unlock=true" https://graph.oculus.com/$USER_ID/achievements

{"id":"1074233745960170","api_name":"MY_ACHIEVEMENT","just_unlocked":true}

curl -X GET "https://graph.oculus.com/$USERID/achievements?access_token=OC\|$APP_ID\|$APP_SECRET&api_names=\[\"VISIT_3_CONTINENTS\"\]&fields=target,bitfield_progress,is_unlocked,unlock_time"

    {
    "data": [{
        "id": "1074233745960170",
        "bitfield_progress": "1001100",
        "is_unlocked": true,
        "unlock_time": 1459815726
    }]
 }

curl -X POST "https://graph.oculus.com/achievement_remove_all?user_id=$USER_ID&access_token=OC\|$APP_ID\|$APP_SECRET"

{"success":true}