Akiwrapper

Akiwrapper is a Java API wrapper for Akinator, the popular online 20Q-type game.

Installation

Maven

Add the following dependency to your pom.xml:

<dependency>
    <groupId>com.github.markozajc</groupId>
    <artifactId>akiwrapper</artifactId>
    <version>1.6</version>
</dependency>

Gradle

Add the following dependency to your build.gradle:

implementation group: 'com.github.markozajc', name: 'akiwrapper', version: '1.6'

Usage

To access the Akinator API, you'll need an Akiwrapper object. One can be created like so:

Akiwrapper aw = new AkiwrapperBuilder().build();

If you, for example, wish to use a different language that the default English, or if you wish Akinator to guess something other than characters, you may use the following setup:

Akiwrapper aw = new AkiwrapperBuilder()
    .setLanguage(Language.GERMAN)
    .setGuessType(GuessType.PLACE)
    .build();

(keep in mind that not all language-guesstype combinations are supported, though all languages support CHARACTER)

You'll typically want to set up a question-answer loop afterwards. Fetch questions with

Question question = aw.getQuestion();

Display the question to the player, collect their answer, and feed it to Akinator with

aw.answer(Answer.YES);

If the player wishes to undo their previous answer, you can let do that with

aw.undoAnswer();

You can undo answers all the way to the first question.

Akinator will occasionally try guessing what the player is thinking about.

var guess = aw.suggestGuess()
if (guess != null) {
    // ask the player to confirm or reject the guess
    if (playerConfirmedGuess) {
        aw.confirmGuess(guess); // let Akinator know that the guess is right
        return; // finish the game

    } else {
        aw.rejectLastGuess();  // let Akinator know that the guess is not right - this also gives us a new question
    }
}
;

When a guess is available, the player should be asked to confirm it. If the guess is confirmed, we finish the game and optionally let Akinator know. If the guess is rejected, we let Akinator know and continue. Akiwrapper also keeps track of rejected guesses for you, so suggestGuess() never returns the same guess.

At some point (normally after question #80) Akinator will run out of questions to ask. This is indicated by aw.isExhausted(). After there are no questions left, the last guess should be retrieved and shown to the player.

Unless you provide your own UnirestInstance to AkiwrapperBuilder, you should make sure to shut down the singleton instance that Akiwrapper uses by default after you're done with Akiwrapper (calling System.exit() also works):

UnirestUtils.shutdownInstance();

That's it! If you need more help, be sure to check the bundled example here for an out-of-the-box implementation.

Available on:

• https://git.zajc.eu.org/akiwrapper.git/
• https://github.com/markozajc/Akiwrapper