rocks.xmpp.extensions.attention

Class AttentionManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ExtensionManager

rocks.xmpp.extensions.attention.AttentionManager

public final class AttentionManager
extends ExtensionManager

This manager allows to capture another user's attention.

XEP-0224: Attention

This feature is known as 'nudge' or 'buzz' in some non-XMPP IM protocols.

If you want to listen for incoming attention requests, listen for incoming messages and check if they have the Attention extension.

Sample

 
 xmppSession.addMessageListener(new MessageListener() {
      @Override
     public void handle(MessageEvent e) {
         if (e.isIncoming() && e.getMessage().getExtension(Attention.class) != null) {
             // Handle attention request.
         }
     }
 });
 
 

If you use attentions, enable this manager class, in order to register this extension in service discovery:

 
 xmppSession.getExtensionManager(AttentionManager.class).setEnabled(true);
 
 

Author:

Christian Schudt

Field Summary

Fields inherited from class rocks.xmpp.core.session.ExtensionManager

features, xmppSession

Method Summary

Modifier and Type	Method and Description
void	captureAttention(rocks.xmpp.core.Jid jid) Captures the attention of another user.

Methods inherited from class rocks.xmpp.core.session.ExtensionManager

setEnabled

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

captureAttention

public void captureAttention(rocks.xmpp.core.Jid jid)

Captures the attention of another user.

Parameters:

jid - The user