Vincular um contato
Você pode vincular um contato em seu aplicativo com um contato no aplicativo de contatos do aparelho
BlackBerry. Você pode decidir como interagir com o usuário do aparelho
BlackBerry ao vincular um contato. As etapas que seguem descrevem uma possível abordagem.
Antes de começar: - Crie os contatos em seu aplicativo criando e instanciando uma classe que implemente a interface LinkableContact.
- Defina uma classe que estenda LinkedContactInfoProvider e registre a classe com seu aplicativo. Para obter mais informações, consulte Criar um provedor de informações para um contato vinculado.
- Importe as classes e interfaces necessárias.
import net.rim.blackberry.api.pdap.*;
import net.rim.blackberry.api.pdap.contactlinking.*;
import javax.microedition.pim.*;
- Verifique se há um contato no aplicativo de contatos (um objeto BlackBerryContact) que seja um candidato à vinculação com seu contato. O método LinkedContactUtilities.getContactLinkCandidate() retorna um BlackBerryContact se encontrar um contato no aplicativo de contatos que tenha o mesmo endereço de e-mail ou número de telefone que o LinkableContact que é passado a ele. Se não houver nenhum contato correspondente, o método retorna null.
BlackBerryContact bbContact =
LinkedContactUtilities.getContactLinkCandidate(linkableContact);
- Se uma correspondência for encontrada, vincule seu contato com o BlackBerryContact.
bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
- Se nenhuma correspondência for encontrada, solicite ao usuário que selecione um contato no aplicativo de contatos para vincular ao contato selecionado.
BlackBerryContactList contacts = null;
try
{
contacts = (BlackBerryContactList) PIM.getInstance().
openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
}
catch(PIMException e)
{
ContactLinkingDemo.errorDialog("Couldn't open contacts list.");
return;
}
Object choice = contacts.choose();
if(choice instanceof BlackBerryContact)
{
bbContact = (BlackBerryContact)choice;
}
- Verifique se o contato selecionado no aplicativo de contatos já está vinculado a um contato em seu aplicativo.
LinkedContactUtilities.isContactLinked(bbContact,
linkableContact.getApplicationID())
- Se o contato selecionado no aplicativo de contatos ainda não estiver vinculado, vincule-o ao contato em seu aplicativo.
bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
Exemplo de código: Vincular um contato
Para consultar um exemplo dessa abordagem para vincular um contato, consulte linkContact() no aplicativo de exemplo Contact Linking Demo incluído no BlackBerry Java SDK.
Estas informações foram úteis? Gostaríamos de receber seus comentários.
