Presence interface (Version 2)
Module description
This module defines structures and operations for the presence V2 interface.
A version 2 of the presence interface was necessary to improve the amount of contact and service data.
The presence shows at any time the current availability of the person you wish to communicate with. For a detailed description see the help of the UCClient.
The following presence states are available:
Additionally the API delivers information in form of contact data, service states and much more.
With all these infromations, it is possible to create an application, which give user the ability to see a detailed picture of a contact enriched with live state changes.
The live changes are results of the different services the UCServer combines the presence state of the user:
Prerequisite for using the interface
Functionalities
Events
The Events that the client receives from the server are:
How the API works
Here is a very simple diagram of how the presence API works
Name | Description |
---|---|
AsnPresenceSubscriptionFlags |
This enum is for selecting the events and direct return values in which the client is interested when it calls asnGetAndSubscribePresence |
AsnSetDynamicRightsErrorEnum |
This enumeration describes the possible iErrorDetail values of AsnRequestError if an error occured in the operation asnSetDynamicRights |
AsnRemoveDynamicRightsErrorEnum |
This enumeration describes possible values returning from the server calling asnRemoveDynamicRights |
EnumRequestImageResult |
This enumeration describes the values possible returned by asnRequestContactImage and asnRequestLargeProfileImage |
AsnPresenceLine |
The structure is used to describe a phone line of a contact. |
AsnPresenceCall |
This structure describes the information about a call on a phone line. |
AsnPresenceForward |
This strutures describes the phone forward state of a phone line. |
AsnContactCapabilities |
- DEPRECATED - Structure of client capabilities. |
AsnActualUserDynamicRights |
Structure for AsnPresence to give the client a hint, whcih access rights are effective to set on an contact. |
AsnAgentState |
Struture for AsnPresence of the actual agent state of the contact |
AsnRemovePresenceArgument |
Argument for the event asnRemovePresence |
AsnGetAndSubscribePresenceArgument |
Call this operation to get information about and events of another contact. |
AsnUnsubscribePresenceArgument |
Argument for stopping contact subscrptions on the ucserver. |
AsnUnsubscribePresenceResult |
Result of asnUnsubscribePresence if the operation was executed successfully |
AsnSetDynamicRightsArgument |
Argument for asnSetDynamicRights to set/change access rights to contact data and its service informations |
AsnSetDynamicRightsResult |
Result of asnSetDynamicRights if the operation was successful. |
AsnRemoveDynamicRightsArgument |
Argument for asnRemoveDynamicRights |
AsnRemoveDynamicRightsResult |
Result of asnRemoveDynamicRights |
AsnRequestLargeProfileImageArgument |
Argument for asnRequestLargeProfileImage |
AsnRequestLargeProfileImageResult |
Result of asnRequestLargeProfileImage |
AsnRequestContactImageArgument |
Argument for asnRequestContactImage |
AsnRequestContactImageResult |
Result of asnRequestContactImage |
AsnMonitorGroupingAttribute |
Future use |
AsnPresenceLines |
List of AsnPresenceLine structures. |
AsnPresenceCalls |
List of AsnPresenceCall structures. |
AsnPresenceForwards |
List of AsnPresenceForward structures. |
AsnPresence |
This sequence contains the data and service states of a contact, called its 'presence'. |
AsnPresenceList |
List of AsnPresence sequences |
AsnUpdatePresenceArgument |
Argument of asnUpdatePresence |
AsnGetAndSubscribePresenceResult |
Result of asnGetAndSubscribePresence with the list of successfully subscribed contacts. |
Version 7