Presence

Version 19 (Adrian Georgescu, 09/18/2012 03:35 pm)

1 1 Adrian Georgescu
h1. Presence
2 1 Adrian Georgescu
3 15 Adrian Georgescu
h2. Design Principles
4 15 Adrian Georgescu
5 19 Adrian Georgescu
Blink should work with any SIP and XCAP servers that supports the same standards as Blink. There is nothing proprietary that would stop interoperability between two Blink clients using any properly configured SIP and XCAP server. Also there is nothing that should stop Blink interoperate with other client as far as SIP signaling is concerned. The only interoperability issues should be related to accessing the same XCAP documents by different clients. Blink would co-exist with any other SIP client that is using XCAP, that is it will preserve any information it did not create in those documents. Unfortunately, we have not found client that behave the same way.
6 1 Adrian Georgescu
7 18 Adrian Georgescu
h3. Disclaimer
8 1 Adrian Georgescu
9 19 Adrian Georgescu
There is no guaranty Blink Presence functionality would interoperate with other SIP clients or SIP servers due to the freedom allowed by the standards. 
10 18 Adrian Georgescu
11 1 Adrian Georgescu
h3. Interoperability
12 1 Adrian Georgescu
13 1 Adrian Georgescu
Presence is a complex issue and the mechanisms used internally by Blink may not necessarily work under your own server environment. If you want to troubleshot when things do not work as expected, first use the built-in Blink accounts that are designed to work with SIP2SIP domain. As full traces are available in the client you can easily access debug information and analyze Blink behavior.
14 1 Adrian Georgescu
15 18 Adrian Georgescu
We can provide support, if you encounter interoperability issues with any the following products and services against Blink has been fully tested:
16 1 Adrian Georgescu
17 1 Adrian Georgescu
 * SIP2SIP.info (a public free SIP service)
18 18 Adrian Georgescu
 * Interoperability with any XMPP domain supported by SIP2SIP.info (like @gmail accounts)
19 17 Adrian Georgescu
 * OpenSIPS + OpenXCAP combinations (server software you can run on your premisses)
20 16 Adrian Georgescu
21 18 Adrian Georgescu
You can also enable one SIP2SIP account in your Blink instance to perform presence and contact storage operations while using your preferred SIP provider to make phone calls.
22 18 Adrian Georgescu
23 15 Adrian Georgescu
h3. Support
24 15 Adrian Georgescu
25 17 Adrian Georgescu
As presence require proper infrastructure that many SIP service providers simply lack today, do not complain to use when Presence does not work. 
26 15 Adrian Georgescu
27 15 Adrian Georgescu
Contacts are stored on the XCAP server in the resource-lists document under a proprietary name space to avoid conflicts with other end-points that might use the same document as there is no common standard way for how to store a rich address book on a server. This means that different SIP user agents from different vendors cannot read or modify this data in a deterministic way. The contacts in the address-book are then used by standard OMA rls-services and pres-rules XCAP documents. The SIP and XCAP servers need to support OMA style XCAP documents in order to interoperate with Blink.
28 15 Adrian Georgescu
29 12 Adrian Georgescu
h2. Contacts
30 1 Adrian Georgescu
31 1 Adrian Georgescu
Contacts have two Presence related properties that can changed in Edit Contact Panel Subscriptions section:
32 12 Adrian Georgescu
33 1 Adrian Georgescu
 * Subscribe to Contact's Presence Information
34 8 Adrian Georgescu
 * Allow Contact to see my Presence Information
35 18 Adrian Georgescu
 * If an URI part of the contact is labelled as XMPP, when using a SIP2SIP.info account the session request will be forwarded to an XMPP gateway. 
36 1 Adrian Georgescu
37 4 Adrian Georgescu
h2. Watcher Information
38 4 Adrian Georgescu
39 13 Adrian Georgescu
Using SUBSCRIBE for presence.winfo event package, Blink keeps track of presence watchers and their status.
40 6 Adrian Georgescu
 
41 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.
42 4 Adrian Georgescu
 * Active watchers are shown in Status -> People Watching  My Presence Activity menu
43 4 Adrian Georgescu
44 6 Adrian Georgescu
h2. Published Presence
45 1 Adrian Georgescu
46 13 Adrian Georgescu
Using PUBLISH method for presence event package, the following information is published by Blink:
47 1 Adrian Georgescu
48 7 Adrian Georgescu
h3. Basic Status
49 7 Adrian Georgescu
50 7 Adrian Georgescu
Open or closed.
51 7 Adrian Georgescu
52 14 Adrian Georgescu
h3. Extended Status
53 7 Adrian Georgescu
54 14 Adrian Georgescu
Blink uses a proprietary extension for indicating the extented status compatible with XMPP end-points. 
55 7 Adrian Georgescu
56 6 Adrian Georgescu
h3. Location
57 1 Adrian Georgescu
58 6 Adrian Georgescu
Location is based on CIPID map extension. Location can be disabled per account in Presence section of account preferences.
59 6 Adrian Georgescu
60 6 Adrian Georgescu
h3. Homepage
61 6 Adrian Georgescu
62 6 Adrian Georgescu
A home page can be entered in Presence section of account preferences. Homepage is based on CIPID homepage extension.
63 1 Adrian Georgescu
64 3 Adrian Georgescu
h3. Note
65 6 Adrian Georgescu
66 14 Adrian Georgescu
Presence note can be typed in the text area right to own icon in the main GUI window. Note is attached to the service.
67 5 Adrian Georgescu
68 5 Adrian Georgescu
h3. Status
69 1 Adrian Georgescu
70 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. 
71 1 Adrian Georgescu
72 5 Adrian Georgescu
h3. Icon
73 1 Adrian Georgescu
74 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.
75 1 Adrian Georgescu
76 1 Adrian Georgescu
h3. Offline Presence
77 1 Adrian Georgescu
78 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.
79 1 Adrian Georgescu
80 1 Adrian Georgescu
h3. Media Capabilities
81 1 Adrian Georgescu
82 1 Adrian Georgescu
Type of media supported by the end-point.
83 1 Adrian Georgescu
84 1 Adrian Georgescu
h3. Device Information
85 1 Adrian Georgescu
86 1 Adrian Georgescu
The following information is published:
87 1 Adrian Georgescu
88 1 Adrian Georgescu
 * Hostname
89 1 Adrian Georgescu
 * Time offset
90 9 Adrian Georgescu
 * Idle status
91 1 Adrian Georgescu
 * GRUU contact address
92 8 Adrian Georgescu
93 10 Adrian Georgescu
h2. Subscribe To Presence
94 3 Adrian Georgescu
95 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).
96 1 Adrian Georgescu
 
97 10 Adrian Georgescu
h3. Presence Notifications
98 10 Adrian Georgescu
99 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:
100 1 Adrian Georgescu
101 1 Adrian Georgescu
 * Status icon overlaid on botton right of user icon, indicating away, busy, extended-away or available
102 1 Adrian Georgescu
 * Rectangular presence indicator on right side of the tile to provide a quick overview about availability
103 1 Adrian Georgescu
 * Presence note is rendered on second line, multiple notes and pending authorizations are rotated every 10 seconds
104 1 Adrian Georgescu
 * User icon is retrieved and updated when necessary from URL advertised by user 
105 2 Adrian Georgescu
106 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.
107 1 Adrian Georgescu
108 1 Adrian Georgescu
h2. Sessions
109 1 Adrian Georgescu
110 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.