[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.
Merge pull request #34 from chriadam/fixavatars

[libcontacts] Allow selection of best avatar