O framework usa um sistema de recompensa no qual o usuário pode receber um certo tipo de conquista quando uma tarefa é executada ou realizada no aplicativo. Conforme ilustrado na figura abaixo, no Esfinge Gamification, quatro tipos de conquistas podem ser encontradas: Ponto, Classificação, Recompensa e Troféu. A interface Achievement também pode ser estendida para incluir outros tipos de recompensas.

O tipo Ponto representa um affordance que contém uma medida de número discreto, tais como pontos ou moedas, que podem ser utilizados para alcançar outras conquistas, ou para usar dentro do próprio sistema. O mesmo sistema pode ter diferentes tipos de Ponto. O tipo Ranking representa um nível de usuário escalar (semelhante a uma hierarquia militar), e é descrito por dois atributos, um nome e um nível. Ele pode ser usado para explicar a melhoria de alguma tarefa do usuário ou representar o seu status. Por exemplo, quando uma tarefa é concluída com êxito um certo número de vezes, o usuário pode subir um nível naquela habilidade. Isso incentiva o usuário a explorar as tarefas a serem realizadas e também melhorar o trabalho realizado.

A conquista de Recompensa representa algo que o usuário ganha e pode gastar. As suas características são um nome e uma variável booleana que indica se a Recompensa já foi usada. O usuário mantém esta Recompensa até que ele decida usá-la para algum propósito. Por exemplo, se a Recompensa é um cupom de desconto, ele estará disponível até que o usuário o utilize. O tipo Troféu, que é semelhante ao de distintivos, como no mundo real, descreve um prêmio recebido apenas uma vez. O usuário pode receber um Troféu para a realização de uma tarefa, mas ele não vai ganhar de novo se ele repetir a mesma tarefa.

Novos tipos de realizações podem ser adicionados ao implementar a interface Achievement. Esta interface possui métodos para definir o que deve ser feito quando uma nova conquista desse tipo é adicionado para um usuário. A seguir estão os métodos definidos por esta interface:

public String getName(): retorna o nome de identificação da conquista.
public void addAchievement(Object user, Achievement achievement): usado para atribuir um usuário a uma conquista, tando no caso de inserção como no caso de upgrade.
public void removeAchievement(Object user, Achievement achievement): usado para remover uma conquista de um determinado usuário. Dependendo do tipo de conquista, a operação pode ser efetuada uma supressão ou de atualização.

Gerenciamento de conquistas

As subclasses concretas do jogo devem gerenciar as conquistas sem o uso de seus tipos concretos. Isto é importante para permitir a extensão dos tipos de conquista.

As implementações da classe Game podem fornecer métodos mais específicos para consultar as informações gamification. Por exemplo, pode haver métodos para recuperar as classificações ou para localizar a posição do usuário. Em versões futuras esses recursos devem ser padronizados na API do framework.

public interface ITestAnnotations {
	@PointsToUser(name = "GOLD", quantity = 1000)
	public void doSomething();
      
	@RewardsToUser(Name = "lunch", used = false)
	public void doSomethingRemarcable();
      
	@RemovePoints(name = "GOLD", quantity = 500)
	public void doBadThing();
      
	@RemoveReward(Name = "lunch", used = true)
	public void useReward();
      
	@PointsToParam (name = "SILVER", quantity = 100, param = "owner")
	public void niceComment(String comment, @Named("owner") String owner);
      
	@PointsToParam (name = "SILVER", quantity = 300, param = "comment"
		prop ="user.login")
	public void niceComment(@Named("comment") Comment c);
      }

      @Retention(RetentionPolicy.RUNTIME)
      @Target(ElementType.METHOD)
      @GamificationProcessor(PointsToUserProcessor.class)

      public @interface PointsToUser {
        int quantity();
        String name();
      }

public class PointsToUserProcessor implements AchievementProcessor {
        private int quantity;
        private String name;

        @Override
        public void receiveAnnotation(Annotation an) {
        PointsToUser ptu = (PointsToUser) an;
        quantity = ptu.quantity();
        name = ptu.name();
      }

      @Override
      public void process(Game game, Object encapsulated, Method method,
            Object[] args) {
          Object currentUser = UserStorage.getUserID();
          Point p = new Point(quantity, name);
          game.addAchievement(currentUser, p);
        }
      }

Apoio