My favorites | Sign in
Project Home Wiki Issues Source
READ-ONLY: This project has been archived. For more information see this post.
Search
for
ProtocolBasics  
High-level summary of the protocol
Updated Nov 7, 2011

To get a good feel of the protocol, you need to be familiar with the official mobile client, available for download at http://www.mxit.co.za/wap/.

Connecting

A TCP/IP connecting to stream.mxit.co.za on port 9119 (by default) is used for all communication. An HTTP method also exists, but is inefficient. The server and port may be altered either in the jad file when the mobile client is downloaded, or when the client connects to the server.

Contacts

When a user logs in, it receives a contact list. Each contact has a global unique id, which corresponds to a jabber id (this id is also used when connecting to another jabber network). For normal users, it is usually number@mxit.co.za, for example 27123456789@mxit.co.za. It also has a contact type (e.g. normal user, jabber user or service).

Each contact has an associated alias and group, which can be specified by the user. It also has a presence and mood, which is specified by the contact.

Some contacts are predefined by the server. Of these, most can be edited, but some - like the info contact, cannot be changed at all.

More contacts can then be invited by the user. When they accept the invitation, they are added to the contact list, and presence updates will be received from them.

Rooms

MultiMX rooms can be created by the user to be able to chat to multiple contacts at the same time. These rooms are emulated as a virtual contact that is added to each user's contact list, and messages to this virtual contact are forwarded to all the participating contacts.

Powered by Google Project Hosting