match

Match the stream party in contacts and fill all missing fields.

The stream party is matched in contacts and this match is then used for normalizing all these fields and filling all empty ones.

The fields are filled this way:

genericUri

If not filled, a unique identifier is generated. The identified has format “prefix:value”. Available prefixes and sources for their values are unspecified.

currentTransportUri

This field is required. It is normalized, i.e. “any phone number” and “any.phone.number@domain.of.my.account” is rewritten to canonical phone number.

displayName

If not filled, user name or pretty-formatted phone number is used. When matched in contacts, the name specified in the contact is used.

contactLabel

When matched in contacts, the label set for the specified currentTransportUri is used. Otherwise left as provided.

contactId

When filled, no contact matching is done, even for contactLabel or displayName. Otherwise, filled with CONTACT_ID.

externalId

Not filled?

quickDialRecordId

When matched in Quick Dial, the record ID for the matched item is filled. Not matched if not zero.

buddyUri

When matched in presence (roster for XMPP), filled with URI of the buddy. Not matched if not empty or if presence is not available.

This method may only be called if init the instance has been initialized}.

Parameters