Virtual Method

PurpleConnectionset_presence

unstable since: 3.0

Declaration [src]

void
set_presence (
  PurpleConnection* connection,
  PurpleSavedPresence* presence
)

Description [src]

Tells the connection to adjust its presence using the given saved presence.

It is expected that a protocol may need to ignore some of the saved presence’s properties or need to map between primitives.

For example, IRC only has offline, available, and away, so invisible would be mapped to offline, where idle, do not disturb, etc would be mapped to away.

The implementation should update the PurplePresence of the PurpleAccount:contact-info to reflect the actual presence of the connection.

The default implementation will adjust the presence on the account’s contact info to match the saved presence meaning if you don’t need to report a presence change, you can skip implementing this.

Available since: 3.0

Parameters

presence

Type: PurpleSavedPresence

The saved presence to use.

The data is owned by the caller of the method.