DesignBuddyList » History » Version 13
Adrian Georgescu, 07/13/2009 05:27 PM
| 1 | 2 | Adrian Georgescu | = Buddy list = |
|---|---|---|---|
| 2 | |||
| 3 | [[TOC(Design*, depth=1)]] |
||
| 4 | 1 | Adrian Georgescu | |
| 5 | * Account |
||
| 6 | * Address-book |
||
| 7 | * Buddy list |
||
| 8 | 13 | Adrian Georgescu | * Presence watcher list |
| 9 | * Dialog watcher list |
||
| 10 | 1 | Adrian Georgescu | * Presence rules |
| 11 | 13 | Adrian Georgescu | * Dialog rules |
| 12 | 1 | Adrian Georgescu | |
| 13 | 3 | Adrian Georgescu | [[Image(sipsimple-buddy-list-design.png,width=600)]] |
| 14 | 1 | Adrian Georgescu | == Account == |
| 15 | |||
| 16 | * GET XCAP documents xcap-caps, pres-rules, resource-lists, pidf-manipulation, rls-services |
||
| 17 | * Sends Publish for event presence |
||
| 18 | * Maintains a '''Presentity''' attributed that is sent as body to Publish |
||
| 19 | * Sends Subscribe for event presence.info |
||
| 20 | * Sends Subscribe for event presence with Supported=eventlist |
||
| 21 | |||
| 22 | == Buddy lists == |
||
| 23 | |||
| 24 | Contains list of buddies. The buddylist is indexed by SIP URIs. Additional one can store full name or other attributes. Based on NOTIFY for event=presence each buddy has a '''Presentity''' attribute that contains published information. GUI displays parts of it. |
||
| 25 | |||
| 26 | 12 | Adrian Georgescu | * The buddy list is stored in the main resource-lists XCAP document '''index''' . |
| 27 | 1 | Adrian Georgescu | * If '''account.presence.subscribe_rls_services''' is true, a RLS document that contains a list of discrete SIP URIs we subscribe to is PUT on the server under SIP URI account-buddies@domain. Then a Subscribe is sent with Supported: eventlist for this SIP URI. |
| 28 | 12 | Adrian Georgescu | |
| 29 | 13 | Adrian Georgescu | == Presence watcher lists == |
| 30 | 1 | Adrian Georgescu | |
| 31 | Built based on the body of NOTIFY for event=presence.winfo. |
||
| 32 | 13 | Adrian Georgescu | |
| 33 | == Dialog watcher lists == |
||
| 34 | |||
| 35 | Built based on the body of NOTIFY for event=dialog.winfo. Need to be built in OpenSIPS. |
||
| 36 | 1 | Adrian Georgescu | |
| 37 | == Presence rules == |
||
| 38 | |||
| 39 | Based on NOTIFY for event watcher.info we update the policy and PUT pres-rules document on the XCAP server. |
||
| 40 | 12 | Adrian Georgescu | |
| 41 | == Dialog rules == |
||
| 42 | |||
| 43 | Based on NOTIFY for event dialog.info we update the policy and PUT dialog-rules document on the XCAP server. |
||
| 44 | 4 | Adrian Georgescu | |
| 45 | 10 | Adrian Georgescu | == Icon exhange flow == |
| 46 | 4 | Adrian Georgescu | |
| 47 | 11 | Adrian Georgescu | Support in OpenXCAP server is necessary, see http://openxcap.org/ticket/100 |
| 48 | |||
| 49 | 9 | Adrian Georgescu | Publishing end-point, on change: |
| 50 | 1 | Adrian Georgescu | |
| 51 | 9 | Adrian Georgescu | 1. Generate a random filename: XYZ |
| 52 | 1. Build URL http://xcap.example.com/xcap-root/icon/users/sip:alice@example.com/XYZ.png |
||
| 53 | 1. HTTP PUT to xcap server |
||
| 54 | 1. Update <icon> element of pidf and PUBLISH new pidf |
||
| 55 | 1. HTTP GET for xcap-directory and locate previously uploaded icons |
||
| 56 | 1. HTTP DELETE any previous icon files |
||
| 57 | 1 | Adrian Georgescu | |
| 58 | 9 | Adrian Georgescu | On reboot: |
| 59 | 1 | Adrian Georgescu | |
| 60 | 9 | Adrian Georgescu | 1. HTTP GET for xcap-directory and locate previously uploaded icon (e.g. XYZ) |
| 61 | 1. HTTP GET http://xcap.example.com/xcap-root/icon/users/sip:alice@example.com/XYZ.png |
||
| 62 | 1 | Adrian Georgescu | |
| 63 | 9 | Adrian Georgescu | Subscribing end-point: |
| 64 | |||
| 65 | 1. Parse <icon> element of pidf received in Notify |
||
| 66 | 2. HTTP GET http://xcap.example.com/xcap-root/icon/users/sip:alice@example.com/XYZ.png |
||
| 67 | 3. Cache picture and check periodically |