Adds a group chat invitation listener. When there is an invitation listener, the GTalk session will call on IGroupChatInvitationListener.onInvitationReceived() to notify of the invitation. When the group chat invitation listeners are removed, the GTalk session will post a notification using the NotificationManager.

Adds a chat listener. This should be a generic chat listener that listen to all incoming chat messages.

Adds a roster listener.

Approves the subscription request from the contact. This takes place after the client receives a subscription request from the contact.

Blocks the contact from subscribing to user's presence or sending the user messages. The contact is put on the blocked list, and is no longer visible in the roster.

Clears the connection statistics

Create a ChatSession with the specified contact.

Create a group chat session with a list of contacts. It will send a group chat request to the server, and invite the given contacts to join the group chat. On success the GTalkService will create a new group chat session, and a corresponding database chat session entry. Applications can query the contacts, which will show live chats at the top of the contact list.

Declines the group chat invitation.

Declines subscription request from the contact. This takes place after the client receives a subscription request from the contact.

Get the ChatSession that is associated with the specified contact. Note this method does not look up in the group chat sessions.

Returns the connection state. The connection state is defined in ConnectionState. The possible values are IDLE, PENDING, CONNECTING, CONNECTED, LOGGED_IN, REQUESTED_ROSTER

Returns the current connection's uptime.

Returns the GTalk JID in the form of username@domain/resource

Returns the time (millis since epoch) of the last activity received from the server.

Returns the time (millis since epoch) of the last activity sent to the server.

Returns the number of GTalk connections attempted to the server since the session is started or the stats last cleared by clearConnectionStatistics().

Returns the number of GTalk connections made to the server since the session is started or the stats last cleared by clearConnectionStatistics().

Get the login user's presence.

Returns the username for the GTalk session.

Send an subscription request to the contact. The client will be notified if the contact accepts the invitation.

Returns true if the client is connected to the GTalk server. Even though the GTalk session is active, the client can be disconnected from the service due to variety of reasons, including no data connection, etc.

Join the group chat with the specified roomAddress. On success the GTalkService will create a new group chat session, and a corresponding database chat session entry.

Log out of the GTalk session

Remove the contact from the roster. This also removes the presence subscription to the contact.

Remove a chat listener.

Remove a roster listener.

Request the roster from the GTalk server . This should be done if the client wants to retrieve the roster list. This is not needed for the purpose of sync tickle or peer to peer messaging for third party applications. This is required for the IM application. requestRoster is an asynchronous operation. It sends a roster request IQ stanza to the server, but doesn't block and wait for the roster list to be downloaded. In fact, one can call this before the user is successfully logged in. GTalkSession will cache it and make the actual request after a GTalk connection is established. When the roster is received, it will be put into the content provider content://im/contacts and the IGTalkSession will notify the IRosterListeners registered using addRemoteRosterListener(IRosterListener).

Sends a data message to the contact. A data message is a user non-visible message. This is a mechanism for peer to peer communication between two devices.

Set the login user's presence.

Unblocks the contact from blocked list.