[libcontacts] Allow selection of best avatar

A contact may have multiple avatars.  This commit adds a function
which allows client to select the best avatar based on the metadata
associated with that avatar.