Presence

Version 9 (Adrian Georgescu, 09/18/2012 03:07 pm)

1 1 Adrian Georgescu
h1. Presence
2 1 Adrian Georgescu
3 1 Adrian Georgescu
h2. Subscriptions
4 1 Adrian Georgescu
5 1 Adrian Georgescu
Contacts have two properties that can changed in Edit Contact Panel Subscriptions section:
6 1 Adrian Georgescu
7 8 Adrian Georgescu
 * Subscribe to Contact's Presence Information
8 8 Adrian Georgescu
 * Allow Contact to see my Presence Information
9 1 Adrian Georgescu
10 4 Adrian Georgescu
h2. Watcher Information
11 4 Adrian Georgescu
12 6 Adrian Georgescu
Using standard SIP SUBSCRIBE for presence.winfo event package, Blink keeps track of presence watchers and their status.
13 6 Adrian Georgescu
 
14 4 Adrian Georgescu
 * Contacts that have subscribed to our presence are rendered in the 'New Contact Requests' group that is rendered on top of the contacts list. Right click or dragging the contact can be used to allow or deny the request. Blocked contacts are displayed in the Blocked group.
15 4 Adrian Georgescu
 * Active watchers are shown in Status -> People Watching  My Presence Activity menu
16 4 Adrian Georgescu
17 6 Adrian Georgescu
h2. Published Presence
18 1 Adrian Georgescu
19 1 Adrian Georgescu
Using standard SIP PUBLISH method for presence event package, the following information is published by Blink:
20 1 Adrian Georgescu
21 7 Adrian Georgescu
h3. Basic Status
22 7 Adrian Georgescu
23 7 Adrian Georgescu
Open or closed.
24 7 Adrian Georgescu
25 7 Adrian Georgescu
h3. Extended status
26 7 Adrian Georgescu
27 7 Adrian Georgescu
Status uses an extension for indicating the extented status compatible with XMPP. 
28 7 Adrian Georgescu
29 6 Adrian Georgescu
h3. Location
30 1 Adrian Georgescu
31 6 Adrian Georgescu
Location is based on CIPID map extension. Location can be disabled per account in Presence section of account preferences.
32 6 Adrian Georgescu
33 6 Adrian Georgescu
h3. Homepage
34 6 Adrian Georgescu
35 6 Adrian Georgescu
A home page can be entered in Presence section of account preferences. Homepage is based on CIPID homepage extension.
36 1 Adrian Georgescu
37 3 Adrian Georgescu
h3. Note
38 6 Adrian Georgescu
39 5 Adrian Georgescu
Presence note can be typed in the text area right to own icon in the main GUI window.
40 5 Adrian Georgescu
41 5 Adrian Georgescu
h3. Status
42 1 Adrian Georgescu
43 7 Adrian Georgescu
Presence status can be changed from the main GUI window and Status menu. Last combination of Presence state and note are saved in the history build at the end of the menu. 
44 1 Adrian Georgescu
45 5 Adrian Georgescu
h3. Icon
46 1 Adrian Georgescu
47 1 Adrian Georgescu
User icon is uploaded to XCAP server using OMA pres-content application, replicated among multiple Blink instances and location of icons storage URL on XCAP server is published in PIDF.
48 1 Adrian Georgescu
49 1 Adrian Georgescu
h3. Offline Presence
50 1 Adrian Georgescu
51 1 Adrian Georgescu
In status menu, one can change its presence state and also an offline state when Blink is offline. This is done using pidf-manipulation XCAP application.
52 1 Adrian Georgescu
53 1 Adrian Georgescu
h3. Media Capabilities
54 1 Adrian Georgescu
55 1 Adrian Georgescu
Type of media supported by the end-point.
56 1 Adrian Georgescu
57 1 Adrian Georgescu
h3. Device Information
58 1 Adrian Georgescu
59 1 Adrian Georgescu
The following information is published:
60 1 Adrian Georgescu
61 1 Adrian Georgescu
 * Hostname
62 1 Adrian Georgescu
 * Time offset
63 1 Adrian Georgescu
 * Idle status
64 9 Adrian Georgescu
 * GRUU contact address
65 1 Adrian Georgescu
66 8 Adrian Georgescu
h3 Example:
67 1 Adrian Georgescu
68 8 Adrian Georgescu
<pre>
69 8 Adrian Georgescu
Internet address: sip:tijmen@test.sip2sip.info
70 8 Adrian Georgescu
  Service: SID-040aafba-3bb5-4209-b6ad-27f513726e8a
71 8 Adrian Georgescu
      Timestamp: 2012-09-18T14:47:53.535157+02:00
72 8 Adrian Georgescu
      Note: I am happy
73 8 Adrian Georgescu
      Basic status: Open
74 8 Adrian Georgescu
      Extended status: Available
75 8 Adrian Georgescu
      Location: Netherlands/Meppel
76 8 Adrian Georgescu
      Contact: user@test.sip2sip.info
77 8 Adrian Georgescu
      Icon: https://xcap.test.sipthor.net/xcap-root/org.openmobilealliance.pres-content/users/sip:user@test.sip2sip.info/oma_status-icon/index
78 8 Adrian Georgescu
      Media capabilities: Audio, Chat, File Transfer, Screen Sharing
79 8 Adrian Georgescu
      Device: 040aafba-3bb5-4209-b6ad-27f513726e8a (Majoor)
80 8 Adrian Georgescu
          Hostname: Majoor
81 8 Adrian Georgescu
          User Agent: Blink Pro 2.0.0 (MacOSX)
82 8 Adrian Georgescu
          Current time: 14:48 (UTC+2)
83 8 Adrian Georgescu
      Device is active
84 8 Adrian Georgescu
          Idle threshold: 600 seconds
85 8 Adrian Georgescu
</pre>
86 8 Adrian Georgescu
87 8 Adrian Georgescu
88 6 Adrian Georgescu
h2. Subscribed Presence
89 3 Adrian Georgescu
90 8 Adrian Georgescu
Using SIP SUBSCRIBE for RLS, Bink subscribes to the SIP addresses stored in rls-services document uploaded on the XCAP server by contacts management actions in the GUI (add/update/delete contacts).
91 6 Adrian Georgescu
 
92 6 Adrian Georgescu
Presence information received from the SIP URIs as RLMI notifications from the RLS server is used to update each contact in the contacts list with:
93 1 Adrian Georgescu
94 1 Adrian Georgescu
 * Status icon overlaid on botton right of user icon, indicating away, busy, extended-away or available
95 1 Adrian Georgescu
 * Rectangular presence indicator on right side of the tile to provide a quick overview about availability
96 1 Adrian Georgescu
 * Presence note is rendered on second line, multiple notes and pending authorizations are rotated every 10 seconds
97 1 Adrian Georgescu
 * User icon is retrieved and updated when necessary from URL advertised by user 
98 2 Adrian Georgescu
99 2 Adrian Georgescu
Selecting  Show Presence Information menu item from contextual contact menu show a panel with detailed information, not all information may have been rendered in the GUI.
100 1 Adrian Georgescu
101 1 Adrian Georgescu
h2. Sessions
102 1 Adrian Georgescu
103 1 Adrian Georgescu
 * When subscribed to Presence, if information is received, the contextual menu of each contact is updated with the possibility of starting a session to a specific device. This requires the remote device to use GRUU.