jcarr
/
libnotify
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add some protocol requests. change "buttons" in the overview to "actions".

This commit is contained in:
Mike Hearn 2004-07-01 23:01:36 +00:00
parent e52fa3acf3
commit 203f183810
2 changed files with 37 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ChangeLog
View File

@ -1,6 +1,6 @@
Thu Jul 1 23:46:28 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: Add info on icons/sounds, add CapsQuery
protocol request.
Thu Jul 1 23:46:28 GMT 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: Add info on icons/sounds, add some
protocol requests. Change "buttons" in the overview to "actions".
Wed Jun 30 14:03:51 GMT 2004 Mike Hearn <mike@navi.cx>
* SPECIFICATION: Initial version

32
SPECIFICATION
View File

@ -71,12 +71,13 @@ A notification has the following components:
- An optional sound: See the ICONS/SOUNDS section below.
- An array of buttons. The buttons send a request message back to the
notification client when clicked. This functionality may not be
- An array of actions. The actions send a request message back to the
notification client when invoked. This functionality may not be
implemented by the notification server, conforming clients should
check if it is available before using it (see the CapsQuery message
in the PROTOCOL section). An implementation is free to ignore any
requested by the client.
requested by the client. As an example one possible rendering of
actions would be as buttons in the notification popup.
- A timeout: the time in milliseconds after which the notification
should be hidden (FIXME: should this be a function of text length
@ -202,4 +203,29 @@ The following messages must be supported by all implementations.
contain spaces in their names (FIXME: this feels right but is it
really necessary?)
* Notify
This message requires the following parameters in the exact order
shown. For some parameters multiple types may be acceptable
STRING summary
STRING/NIL body: if nil the body is considered omitted.
ARRAY images: the array may be empty.
STRING/NIL sound: if nil the sound is considered omitted.
ARRAY actions
UINT32/NIL timeout: if nil the notification never times out
It returns a UINT32 that will never be reused within a
session unless more than MAXINT notifications have been generated
(ie an acceptable implementation for this is just an incrementing
counter).
* EndNotify
This message indicates that the notification should be removed from
the users view. It can be used, for instance, if the event the
notification pertains to is no longer relevant or to cancel a
notification with no timeout. It takes one UINT32 parameter, the ID
of the notificaton to cancel.
REFERENCE