author | cgandhi <chandradeep.gandhi@sasken.com> |
Tue, 06 Apr 2010 16:35:37 +0530 | |
changeset 2 | 86af6c333601 |
permissions | -rw-r--r-- |
2
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
1 |
/** |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
2 |
* Copyright (c) 2010 Sasken Communication Technologies Ltd. |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
3 |
* All rights reserved. |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
4 |
* This component and the accompanying materials are made available |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
5 |
* under the terms of the "Eclipse Public License v1.0" |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html" |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
8 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
9 |
* Initial Contributors: |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
10 |
* Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
11 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
12 |
* Contributors: |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
13 |
* Manasij Roy, Nalina Hariharan |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
14 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
15 |
* Description: |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
16 |
* Intro Page |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
17 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
18 |
* @ref smf_high_level_design |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
19 |
*/ |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
20 |
|
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
21 |
/** |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
22 |
* @mainpage SMF (Social Mobile Framework Interfaces) |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
23 |
* @defgroup smf_high_level_design SMF high level design |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
24 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
25 |
* Social Mobile Framework is a application level framework which allows Qt Applications |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
26 |
* use the common web APIs to perform social web activities. |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
27 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
28 |
* Product name is "SMF" |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
29 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
30 |
* For details please refer to http://developer.symbian.org/wiki/index.php/Social_Mobile_Framework |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
31 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
32 |
* @section smf_interfaces SMF Interfaces |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
33 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
34 |
* There are two sets of interfaces - |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
35 |
* @subsection smf_client_interfaces Client Interfaces |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
36 |
* - Client Applications (e.g. Media Player, Contacts, Game) uses these APIs to access SMF. see @ref smf_client_group |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
37 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
38 |
* @subsection smf_plugin_interfaces Plugin Interfaces |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
39 |
* - Service Providers (e.g. Facebook, Flickr, last.fm) implements these APIs to provide service to SMF - see @ref smf_plugin_group |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
40 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
41 |
* Currently, @ref smf_client_interfaces and @ref smf_plugin_interfaces are defined for remote contacts, remote |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
42 |
* image gallery and remote music services. There are common classes defined for holding data accross clients |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
43 |
* and plugins, present in inc\common, see - @ref smf_common_group |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
44 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
45 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
46 |
* @section smf_client_usage Client Usage Example |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
47 |
* - This shows how to use the SMF client APIs in applications, e.g. Client can define suitable Models using lists returned by these APIs |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
48 |
* - how to fetch a list of contacts from a remote server e.g. Facebook, see @ref MyApplication::displayFriends() |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
49 |
* - how to get a @ref QContact from a SmfContacts see @ref MyApplication::showlist() |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
50 |
* - how to get a list of images from a remote gallery e.g. Flickr.com, see @ref MyApplication::displayGallery() |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
51 |
* - how to post privately to a contact see @ref MyApplication::postUpdate() |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
52 |
* - how to tell others about the music you are currently listen to, see @ref MyApplication::updateCurrentPlaying() |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
53 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
54 |
* |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
55 |
* @section smf_dependency Dependency |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
56 |
* SMF uses QtMobility for mainly contacts information, see QtMobility project. |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
57 |
*/ |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
58 |
/** |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
59 |
* @defgroup smf_common_group Common Data Classes |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
60 |
*/ |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
61 |
/** |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
62 |
* @defgroup smf_client_group Client Classes |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
63 |
*/ |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
64 |
/** |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
65 |
* @defgroup smf_plugin_group Plugin Classes |
86af6c333601
Changed the common classes for location, events. Changed APIs for paged results. Added exporting to QContacts.
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
66 |
*/ |