Principais classes da plataforma do BlackBerry Messenger

Classe

Descrição

BBMPlatformContext

A interface BBMPlatformContext verifica o status de acesso de seu aplicativo e permite que você recupere referências aos serviços associados do aplicativo (por exemplo, serviço de mensagens, serviço de lista de contatos e serviço de UI).

A plataforma do BlackBerry Messenger retorna uma instância do BBMPlatformContext quando seu aplicativo se registra na plataforma do BlackBerry Messenger.

Você pode receber notificações de alterações no acesso ou status de registro do seu aplicativo definindo uma classe que estende a classe BBMPlatformContextListener e seus métodos.

MessagingService

A classe MessagingService permite que você crie uma instância do BBMPlatformChannel ou do BBMPlatformSession, convide contatos para fazer download de seu aplicativo ou envie um arquivo a um contato do BlackBerry Messenger.

Para receber notificações de eventos relacionados ao serviço de mensagens, você deve estender a classe abstrata, MessagingServiceListenersubstituir seus métodos de retorno de chamada e invocar o método MessagingService.setServiceListener().

Para recuperar uma referência ao MessagingService associado ao seu aplicativo, invoque BBMPlatformContext.getMessagingService().

BBMPlatformChannel

A interface BBMPlatformChannel representa uma conexão privada entre seu aplicativo e um ou mais contatos. Se o seu aplicativo estiver se comunicando com múltiplos contatos, os contatos não terão conhecimento um dos outros. Conseqüentemente, os contatos só podem se comunicar com o seu aplicativo, não entre si.

Você pode invocar BBMPlatformConnection.setPublic() para configurar seu canal para permitir conexões de contatos que não estejam em sua lista de contatos do BlackBerry Messenger.

Para receber notificações sobre eventos e alterações no canal, você deve estender a classe BBMPlatformChannelListener e substituir os métodos de retorno de chamada herdados da classe BBMPlatformConnectionListener.

Para criar uma instância de BBMPlatformChannel, invoque MessagingService.createChannel(), fornecendo uma referência a uma instância de BBMPlatformChannelListener.

BBMPlatformSession

A interface BBMPlatformSession representa a conexão entre os contatos do BlackBerry Messenger. Quando você cria uma conexão de sessão, qualquer contato na sessão pode convidar outro contato ou contatos para ingressar na sessão. Cada contato na sessão está disponível para compartilhamento de dados.

Você pode invocar BBMPlatformConnection.setPublic() para configurar sua sessão para permitir conexões de contatos que não estejam em sua lista de contatos do BlackBerry Messenger.

Para receber notificações sobre eventos e alterações na sessão, você deve estender a classe BBMPlatformSessionListener e substituir seus métodos de retorno de chamada e os métodos de retorno de chamada herdados da classe BBMPlatformConnectionListener.

Para criar uma instância de BBMPlatformSession, invoque MessagingService.createSession(), fornecendo uma referência a um objeto BBMPlatformSessionListener para atribuir o ouvinte.

ContactListService

A classe ContactListService fornece acesso a esses contatos na lista de contatos do BlackBerry Messenger do usuário que tem o aplicativo instalado.

Para receber notificações sobre alterações nos contatos na lista de contatos, você deve implementar a interface, PresenceListener. PresenceListener contém um método de retorno de chamada, presenceUpdated(), que é chamado quando um dos contatos em sua lista de contatos atualiza sua imagem de exibição, nome de exibição, mensagem pessoal ou status.

Para recuperar uma referência ao ContactListService do seu aplicativo, invoque BBMPlatformContext.getContactListService().

Para atribuir um PresenceListener à sua lista de contatos, invoque ContactListService.setListener(PresenceListener).

UIService

A UIService classe fornece métodos para adicionar um item de menu específico do aplicativo para o BlackBerry Messenger, acessar um seletor de contato que permite ao usuário optar por um contato com base em um conjunto que você pode definir, permitir a um usuário convidar contatos que não estão na lista de contatos BlackBerry Messenger do usuário a BBM™, ou iniciar um bate-papo BlackBerry Messenger.

Para recuperar uma referência ao UIService do seu aplicativo, invoque BBMPlatformContext.getUIService().

MenuItemManager

A classe MenuItemManager fornece métodos para criar, adicionar, remover e verificar um item de menu na tela de lista de contatos do BlackBerry Messenger. O item de menu convida o contato selecionado para interagir com o usuário usando seu aplicativo habilitado para BlackBerry Messenger.

O item de menu será exibido apenas se o contato selecionado tiver o aplicativo instalado.

Se já existir um item de menu para seu aplicativo, quando você adicionar um novo item de menu, o existente será substituído.


Estas informações foram úteis? Gostaríamos de receber seus comentários.