Cette page est traduite de l'anglais. En cas de différence, la page anglaise fait foi. Lire la page en anglais
Un personnage de votre jeu peut tenir une conversation avec le joueur dans la langue qu’il apprend, adaptée à son niveau. Chaque réplique du joueur constitue un tour : le kit joueur l’envoie, et la réponse du personnage revient en flux, morceau par morceau.
Ce que contient un tour
Chaque tour envoie tout ce dont le personnage a besoin, car Lingara ne conserve aucune conversation entre les tours :
npc : qui parle. Son name compte de 1 à 32 caractères, et son persona facultatif est une ligne de description de 1 à 120 caractères, par exemple « un vendeur de raviolis ».
scene : facultatif, le lieu de la conversation, de 1 à 160 caractères.
source_lang et target_lang : la langue du joueur et celle qu’il apprend. Elles doivent être différentes, et le personnage ne parle que target_lang.
level : le niveau du joueur, de 1 à 9. Le guide de Lingara « Ce que signifie un niveau » décrit l’échelle.
line : ce que le joueur vient de dire, de 1 à 500 caractères.
history : la conversation jusqu’ici, de la plus ancienne à la plus récente, au plus 12 lignes. Chaque ligne a un speaker, soit player soit npc, et son text, de 1 à 500 caractères.
Chaque texte tient sur une seule ligne. C’est votre jeu qui conserve la conversation : le kit joueur garde la fenêtre de chaque dialogue que vous ouvrez, y ajoute chaque tour terminé, tronque chaque réponse à ses 500 premiers caractères et abandonne les lignes les plus anciennes au-delà de 12.
Lingara traite le persona et la scène comme du texte non fiable provenant de votre jeu. Ils façonnent la manière dont le personnage parle, jamais ce qu’il est autorisé à faire.
Comment arrive une réponse
La réponse arrive en flux sous forme de morceaux de texte, que votre jeu ajoute à mesure qu’ils arrivent. Un avis peut s’intercaler entre eux, par exemple pour indiquer que la réponse a été écourtée. Le tour se termine par done lorsque la réponse est complète, ou par error lorsqu’elle a échoué. Un tour ne peut pas être repris : si la connexion tombe, le joueur répète sa réplique.
Dites une seule réplique à la fois à chaque personnage. Une réplique dite pendant que le personnage répond encore est refusée plutôt que mise en file d’attente, car chaque tour est facturé.
Qui paie
Seuls les joueurs d’un client au compteur peuvent tenir une conversation, et chaque tour est facturé à ce client. Le jeton d’un joueur doit inclure embed:play.