RtccPresenceDelegate Protocol Reference

Conforms to NSObject
Declared in RtccProtocols.h

Overview

This protocol presents the callbacks related to the presence part of the SDK.

This notifies the app of registration status changes and roster&single contact presence udpate.

– rtccPresenceRegistrationUpdate: required method

Called when the user registration changes.

Usually arrives on connection establishment or after a disconnection from another device.

- (void)rtccPresenceRegistrationUpdate:(registrationUpdate_t)registrationUpdate
Parameters
registrationUpdate

The new user’s registration udpate status.

Availability

5.4

Declared In

RtccProtocols.h

– rtccPresenceContact:changedPresence: required method

A Contact changed its presence.

- (void)rtccPresenceContact:(NSString *)contact changedPresence:(NSNumber *)presence
Parameters
contact

The contactUID whose presence changed.

presence

The new value of the presence.

Availability

5.4

Declared In

RtccProtocols.h

– rtccRosterSize:update: required method

The roster changed: either contact were added, or they were removed.

In case of “add one and remove one”, this callback will be fired twice, once with a positive variation and the second with a negative one.

- (void)rtccRosterSize:(NSNumber *)currentSize update:(NSNumber *)variation
Parameters
currentSize

The size of the updated roster.

variation

The delta between the previous roster size and the current roster size.

Availability

5.4

Declared In

RtccProtocols.h

– rtccPresenceForContacts: required method

The content of a part of the roster.

This is usually an answer to [Rtcc getPresenceForContacts:]] with @[ContactUID@, ContactUID2, ...] as parameter.

- (void)rtccPresenceForContacts:(NSDictionary *)contactsPresence
Parameters
contactsPresence

A dictionary of <NSString *ContactUID: NSNumber *Presence>, Presence an unsigned char.

Availability

5.4

Declared In

RtccProtocols.h

– rtccRosterUpdate: required method

The content of the whole roster.

This is an answer to [Rtcc getPresenceForContacts:] using nil as parameter.

- (void)rtccRosterUpdate:(NSDictionary *)updatedRoster
Parameters
updatedRoster

A dictionary , with Presence an unsigned char.

Availability

5.4

Declared In

RtccProtocols.h