Warning
Relocation notice for 1.6.1 and above:
Akiwrapper's artifact has relocated from com.github.markozajc:akiwrapper to org.eu.zajc:akiwrapper. Additionally,
the same change has been made on the base package name. You will need to change Akiwrapper's dependency's groupId
in your pom.xml or build.gradle (as shown in the installation section) and you will need to replace
com.github.markozajc.akiwrapper with org.eu.zajc.akiwrapper in your imports.
Akiwrapper is a Java API wrapper for Akinator, the popular online 20Q-type game.
Add the following dependency to your pom.xml:
<dependency>
<groupId>org.eu.zajc</groupId>
<artifactId>akiwrapper</artifactId>
<version>2.0.0</version>
</dependency>Add the following dependency to your build.gradle:
implementation group: 'org.eu.zajc', name: 'akiwrapper', version: '2.0.0'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)
.setTheme(Theme.OBJECT)
.build();(keep in mind that not all language-theme combinations are supported, though all languages support CHARACTER)
Akinator sends two types of queries: questions ("Is your character an X?", "Does your character Y?") and guesses ("Is this your character?"). You'll typically want to set up a query-answer loop. Fetch the first query with
Query query = aw.getCurrentQuery();Then split your logic based on the type using instanceof:
if (query instanceof Question) {
// Show the question, get an answer
} else if (query instanceof Guess) {
// Show the guess, get a rejection or confirmation
} else if (query == null) {
// Akinator has run out of questions, the player wins
}Questions can be responded to in two ways: by answering them
query = ((Question) query).answer(Answer.YES); // or any other Answer... or by undoing them
query = ((Question) query).undoAnswer();Doing either will return the next query or null if there are none left (after answering question #80). You can also
ignore the return value and use Akiwrapper#getCurrentQuery() instead.
Guesses can also be responded to in two ways: by rejecting them
query = ((Guess) query).reject();... or by confirming them
((Guess) query).confirm()Confirming a guess ends the game, meaning no more queries are returned past that point. This is also why
Guess#confirm() lacks a return value.
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 out the bundled example code to see how the library is used.