PyArianneAPIDefinition: Difference between revisions

It is important that you respect the order of the functions; if not the behaviour of your application will be irratic.

Let's first have a look at the function calls and we will describe the data structures later.

This function sets the callback function that will be called each time the module needs to block for a given period of time. The callback function should return true to make the pyarianne module continue wait for data, and false will make the modile stop waiting.

<pre>

</pre>

This function is called to connect to an Arianne server running on the server whose name (DNS) or IP is <serverName> and that can be reached at port <port>.

This function will never fail.

</pre>

This function should be called AFTER connecting to the Arianne server; it tries to login to the server using the given username and password combination.

It will return true if the login is completed successfully or false if there is a problem and it then will set error to true.

</pre>

Once you have logged into Arianne, you can get the list of characters available for your account.

It will return a list of name of characters.

</pre>

Once you have logged into Arianne, you can get the list of server properties that may be relevant to the client.

It will return a list of properties of the form attribute=value.

</pre>

Returns a string containing the type of game we are playing.

<pre>

</pre>

Once have recieved the list of characters you can choose one of them that you will use to enter the game.

If it enters correctly it will return true, otherwise it will return false.

</pre>

This function returns true if there is a Map available for this game.

This functions returns a list of objects containing the data of the Map.

It is up to your client to process it and build an appropriate representation.

</pre>

This function returns true if there is a perception available for your game.

This function returns a perception that should have been previously stored by a call to hasPerception, using a polling technique. This function won't block the client.

<pre>

</pre>

Both these functions send an Action the server, but the blocking function will block until the server replies with a Action ACK message, which will be around the length of the trip time of the message.

They return nothing.

</pre>

Exits the Arianne enviroment and returns true.

If it returns false it means the logout didn't happened.

</pre>

Return true if there is a significant error

Returns a string containing an explanation of the error.

* Perception

* World

We use RPAction to tell the server to do something with our characters. Depending on the game different actions will be accomplished.

It has several methods:

Returns true if the action has the attibute whose name matches attribute.

Sets an attribute in the action where attribute's name is attribute and value is value. Value can either be a string or a number.

Returns a string containing the value of the attribute

This method will fail if it is called on a attribute that doesn't exist.

Returns an integer containing the value of the attribute

This method will fail if it is called on a attribute that doesn't exist.

Removes an attribute from the action or fails if it doesn't exist.

Remove all the attributes from the action

Return true if the action is equal to this action.

Return a string representation of the action

Returns the number of attributes of the action

This class represents RPObjects in the world, everything in Arianne is an object, keep that in mind.

It has several methods:

Returns true if the object has the attibute whose name matches attribute.

Sets an attribute in the object where attribute's name is attribute and value is value. Value can either be a string or a number.

Returns a string containing the value of the attribute

This method will fail if it is called on a attribute that doesn't exist.

Returns an integer containing the value of the attribute

This method will fail if it is called on a attribute that doesn't exist.

Removes an attribute from the object or fails if it doesn't exist.

Removes all the attributes from the object

Returns true if the object is equals to this object.

Returns a string representation of the object

Returns the number of attributes of the object plus all the attributes of the objects that exist in the slots.

Add an RPSlot to the object; it will fail if the slot already exists on the object. So if you want to replace a slot, first remove the current slot.

Returns an RPSlot from the Object whose name is name.

It will fail if there is no such slot.

Removes the slot from the object whose name is name.

It will fail if there is no such slot.

Returns true if the object has a slot named name.

Every object can be a slot, they are like extensions of an object that allow it to contains more objects. A pocket, a bag, a chest are examples of objects.

It has several methods:

It contains the name of the Slot. It is a string.

This method adds an object to the slot or replaces it if it exists.

Returns the object whose id is id or fails if there is no such object.

Returns the object whose position on the list of objects is i or fails if there is no such position

Returns true if there is an object whose id is id. False otherwise

Removes the object whose id is id or fails if it can't be found-

Removes all the objects in the slot.

Return true if the slot is equals to this slot.

Return a string representation of the slot

Returns the number of objects in the slot.

A perception is the basic unit of information of the Arianne system. You get one perception each turn and basically there are two different classes of perception:

It is an enum type that can be either 0 or 1 to indicate SYNC and DELTA perception type.

It is a constant incremental counter to mark each perception

These are a list of RPObjects that contain added, modified added, modified deleted and deleted objects respectively

It is a boolean value that will be true if myRPObject contains a valid value

It is our RPObject containing all the hidden attributes.

For a unknown reason if this structure is written in Python it is not understood by SWIG and objects are freed :(

It is a dict of integer<-->RPObject

This is the class that cares about perception handling, and this is the only thing you should ever use to handle a perception.

The class is very simple, it has a constructor a method to handle the perception and modify the world.

It is passed an instance of a subclass of ~PerceptionListener that handles everything related to the perception on a detailed way. You can choose to implement your own, or use the default one.

Just call this method with the perception you get from getPerception and the world where objects are stored, and voila... perception gets applied.

It is a listener class for handling perceptions.

Each method is called on the given event, you can execute whatever you want inside.

It is called when an object is added to the world.

It is called when an object is modified by adding slots or attributes.

It is called when an object is modified by removing slots or attributes.

It is called when an object has been modified by adding slots or attributes.

It is called when an object has been modified by removing slots or attributes.

It is called when an object is deleted of the world

It is called on each perception, if changed is true, object contains the resulting new object for our character, else it will contains None

It is called on each perception.

It is called each time the whole world is emptied

When you get out of sync this method is called

When you recover sync with server this method is called