diff --git a/xep-0224.xml b/xep-0224.xml new file mode 100644 index 00000000..3a62d48c --- /dev/null +++ b/xep-0224.xml @@ -0,0 +1,154 @@ + + +%ents; +]> + + +
+ Getting a User's Attention + This document defines an XMPP protocol extension for getting a user's attention. + &LEGALNOTICE; + 0224 + Experimental + Standards Track + Standards + Council + + XMPP Core + XEP-0030 + + + + NOT YET ASSIGNED + + Andreas + Monitzer + andy@monitzer.com + andy@monitzer.com + + + 0.1 + 2007-08-08 + psa +

Initial published version.

 + + + 0.0.1 + 2007-07-03 + am +

Initial version.

 + +
+ +

Even though a client might be available (as stated in the most recent presence stanza) the user this client belongs to might not have the focus on the client currently. &xep0132; defines a method for a physical test of user presence. Since this requires special hardware that can not be assumed to be available, this XEP defines a software-only implementation where no direct feedback is expected. This is known as 'nudge' or 'buzz' in some legacy IM protocols.

+

It was discussed whether this should be part of &xep0085;. However, the semantics are inherently different, since it describes the sender's state, not a request to change the receiver's. Thus, a separate extension is desirable.

+ + +

The specification addresses remotely getting the user's attention in a more assertive way than simple text messages.

+ + +

In the following conversation, a user talks to somebody, but this user doesn't respond. The second inquiry includes an attention extension.

+ + All right, then, Herbie, give! We're waiting. + + ]]> +

When no reply is received, the sending user might want to grab the other's attention. This is done by sending a message that includes an <attention/> element qualified by the 'http://www.xmpp.org/extensions/xep-0224.html#ns' namespace &NSNOTE;. Note: The message may or may not include a &BODY; element.

+ + + Why don't you answer, Herbie? + + ]]> +

Finally, the receiving user notices the urgency of the message and responds.

+ + I cannot. You know I cannot! Dr. Bogert and Dr. Lanning don't want me to. + + ]]> + + +

The following rules apply to generating and processing of the attention extension. +

    +
  1. Before sending an attention message stanza, the client MUST confirm support for it in the other client as described under Determining Support.
    2. +
  2. The message stanza containing the attention extension MAY contain a body and/or other extensions, which is to be displayed along with executing the attention event.
    3. +
  3. In message stanzas containing either &xep0203; data, attention extensions MUST be ignored, since this is an instant event which should not be replayed after a delay.
    4. +
  4. Messages containing an attention extension SHOULD use the headline message type to avoid offline storage.
    5. +
  5. Using the attention extension in &IQ; stanzas is not desirable, since this is part of the conversation.
    6. +
+

+ + +

If an entity supports receiving the attention extension, it MUST advertise that fact in its responses to &xep0030; information ("disco#info") requests by returning a feature of "http://www.xmpp.org/extensions/xep-0224.html#ns":

+ + + + ]]> + + + ... + + ... + + + ]]> +

In addition, support for receiving attention extensions in message stanzas can be determined through the dynamic profile of Service Discovery defined in &xep0115;.

+ + +

The implementation of the alert is up to the developer. Possible behavior is:

+ +

However, since some users might not want this feature to disturb them, a client SHOULD enable the user to disable support. When the feature is disabled, it MUST NOT be advertised in disco#info.

+

Rate-limiting might be desirable in some implementations.

+

Formal feedback in response to the attention request to the requesting user is not specified, and so the request might be silently dropped.

+ + +

It is recommended that only message stanzas containing attention extensions from peers on the user's roster are accepted. Finer grained control might be implemented.

+ + +

This document requires no interaction with &IANA;.

+ + + +

Until this specification advances to a status of Draft, its associated namespace shall be "http://www.xmpp.org/extensions/xep-0224.html#ns"; upon advancement of this specification, the ®ISTRAR; shall issue a permanent namespace in accordance with the process defined in Section 4 of &xep0053;.

+ + + + + + + + + + + + + + + + + ]]> + + +

The quotes have been taken from Isaac Asimov's short story "Liar!" as published in the book The Complete Robot.

+ +