Avaya Client Services API Reference (OS X)
|
The class encapsulates all of presence related features available to the user. More...
#import <CSPresenceService.h>
Inherits NSObject.
Instance Methods | |
(void) | - publishPresence: |
Publishes presence state, location mode and optional note for the local user. More... | |
(CSPresenceListSubscription *) | - createPresenceListSubscription |
Creates a new empty ad-hoc presence subscription object. More... | |
(void) | - removePresenceListSubscription: |
Removes the specified presence list subscription. More... | |
Properties | |
id< CSPresenceServiceDelegate > | delegate |
The delegate responsible for handling presence service related events. More... | |
BOOL | serviceAvailable |
Exposes the service availability status. More... | |
BOOL | serviceConfigured |
Exposes the service configuration status. More... | |
NSTimeInterval | autoAwayTimeout |
Sets the timeout for the user inactivity timer at runtime. More... | |
BOOL | sendAllCallsOnDoNotDisturb |
Sets a link between "Do Not Disturb" presence state and "Send All Calls" call service feature at runtime. More... | |
CSPresence * | selfPresence |
Property to get current self-presence based on the last received presence data from the presence server. More... | |
NSUInteger | presenceNoteMaxTextLength |
Get the maximum text length value (in characters) accepted for presence note. More... | |
CSCapability * | presenceAccessControlListCapability |
Returns CSCapability object describing whether the Presence service supports Presence Access Control List(ACL). More... | |
CSCapability * | automaticModeCapability |
Returns CSCapability object describing whether the Presence service supports automatic mode for self-presence. More... | |
NSArray * | automaticPresenceStates |
Returns array of all the supported automatic self-presence states. More... | |
NSArray * | manualPresenceStates |
Returns array of all the supported manual self-presence states. More... | |
CSPresenceAccessControlList * | presenceAccessControlList |
Property representing CSPresenceAccessControlList . More... | |
The class encapsulates all of presence related features available to the user.
The presence service encapsulates such features as publishing presence, subscribing for self-presence update events, and creating presence list subscriptions to watch presence of other users.
The service is configured with CSPresenceConfiguration object created by the client application as part of the CSUserConfiguration. In order to get the service object and leverage the available presence features CSUser::presenceService is used.
- (CSPresenceListSubscription *) createPresenceListSubscription |
Creates a new empty ad-hoc presence subscription object.
An ad-hoc presence subscription object is used to manipulate the list of users the client application wants to know presence of. A PresenceListSubscription object allows the application to subscribe for presence events of multiple users specified by their presence addresses. Note that the preferred way of getting presence of other users is CSContact::startPresenceWithAccessControlBehavior:completionHandler:.
- (void) publishPresence: | (CSPresence *) | presence |
Publishes presence state, location mode and optional note for the local user.
The result of the operation is delivered via CSPresenceServiceDelegate:
presence | Presence information to publish. |
- (void) removePresenceListSubscription: | (CSPresenceListSubscription *) | subscription |
Removes the specified presence list subscription.
This method is used to stop getting presence updates for all of the users specified by the addresses added to the object.
subscription | Subscription to be removed. |
|
readwritenonatomicassign |
Sets the timeout for the user inactivity timer at runtime.
Inactivity timer is used to automatically change the user's presence state to 'away' if the user is inactive, i.e. not using the device with the installed application. When the timer fires, the user's presence is set to the 'away' state. If zero value is specified, the inactivity timer is disabled.
|
readnonatomicassign |
Returns CSCapability object describing whether the Presence service supports automatic mode for self-presence.
|
readnonatomicassign |
Returns array of all the supported automatic self-presence states.
|
readwritenonatomicweak |
The delegate responsible for handling presence service related events.
|
readnonatomicassign |
Returns array of all the supported manual self-presence states.
The client application should check for the supported manual self-presence states before initializing the presence states for UI/UX update.
|
readnonatomicassign |
Property representing CSPresenceAccessControlList .
|
readnonatomicassign |
Returns CSCapability object describing whether the Presence service supports Presence Access Control List(ACL).
|
readnonatomicassign |
Get the maximum text length value (in characters) accepted for presence note.
|
readnonatomicassign |
Property to get current self-presence based on the last received presence data from the presence server.
Self-presence describes overall presence status of the local user calculated by the presence server based on presence data information collected from various presence sources. The sources are communication devices and applications running on behalf of the user.
|
readwritenonatomicassign |
Sets a link between "Do Not Disturb" presence state and "Send All Calls" call service feature at runtime.
If the link is enabled and "Send All Calls" feature is available, the following behavior applies.
|
readnonatomicassign |
Exposes the service availability status.
The service may become unavailable due to a number of reasons such as network issues, presence server issues, and configuration issues.
|
readnonatomicassign |
Exposes the service configuration status.
Reflects the fact that the service is not provided with a valid CSPresenceConfiguration object or couldn't automatically discover its configuration.