APIs de mensagens

As APIs de mensagens permitem usar a funcionalidade de mensagens em seus aplicativos, incluindo e-mails, mensagens de aplicativos, SMS, MMS e BlackBerry® Messenger.

Mensagens de e-mail

Os pacotes para mensagens de e-mail são net.rim.blackberry.api.mail e net.rim.blackberry.api.mail.event.

Para configurar seu aplicativo para criar e enviar mensagens de e-mail, configure a Sessão padrão, recupere uma instância de Armazenamento, crie a mensagem de e-mail e armazene o e-mail em uma pasta de itens enviados recuperada. Por último, configure e envie a mensagem de e-mail.

Cada aparelho BlackBerry tem um PIN exclusivo e suporta mensagens entre PINs enviadas com o aplicativo Mensagens. Para configurar seu aplicativo para criar e enviar mensagens PIN, configure a Sessão padrão, recupere uma instância de Armazenamento, defina o endereço PIN de destino, crie a mensagem PIN e armazene a mensagem em uma pasta de itens enviados recuperada. Por último, configure e envie a mensagem PIN.

Para enviar uma mensagem de e-mail com um anexo, crie o objeto Multiparte, crie e adicione o arquivo anexo a este objeto e estruture e envie a mensagem de e-mail. Para fazer download automaticamente de anexos em mensagens de e-mail em segundo plano quando as mensagens chegam na lista de mensagens, use a interface DownloadProgressListener e a classe AttachmentDownloadManager.

Mensagens de aplicativo

Um ApplicationMessage é uma mensagem personalizada exibida no aplicativo Mensagens e chama o aplicativo quando o usuário o abre e escolhe um item de menu fornecido para a mensagem. Use o pacote messagelist para criar mensagens de aplicativo.

Mensagens SMS e MMS

Você pode criar aplicativos que enviam e recebem mensagens SMS ou MMS. O suporte SMS é fornecido por meio do JSR 120. O suporte MMS é fornecido por meio do JSR 205. Você pode executar as seguintes ações:

  • Enviar e receber mensagens SMS
  • Enviar e receber mensagens MMS
  • Configurar os listeners para mensagens de saída e enviadas

Você pode enviar mensagens SMS com a API javax.wireless.messaging e a API BlackBerry® Invoke. Não é possível enviar mensagens SMS diretamente de um smartphone BlackBerry que opera em uma rede CDMA.

Para receber mensagens SMS usando o BlackBerry Java SDK 4.6.0 ou posterior, use a interface MessageListener. Se estiver usando uma versão anterior do SDK, use a interface MessageConnection.

Se quiser que mensagens SMS específicas sejam salvas em uma pasta de mensagens SMS, você deverá especificar a localização da pasta usando MessageArguments quando a mensagem SMS for recebida pelo smartphone BlackBerry. Os aplicativos não podem acessar mensagens SMS armazenadas no smartphone BlackBerry.

Para ouvir mensagens SMS recebidas exibidas na lista de mensagens, configure o argumento de número da porta em Connector.open() como 0 - Connector.open("sms://:0").

As mensagens MMS consistem em um cabeçalho e um corpo MMS. O cabeçalho MMS consiste em endereço, prioridade, assunto e informações de entrega. O corpo MMS contém a parte de anexo multimídia.

Para receber mensagens MMS ao usar o BlackBerry Java SDK 4.6.0 ou posterior, use a interface MessageListener. Se estiver usando uma versão anterior do BlackBerry JDE, use a interface MessageConnection.

Enviar mensagens MMS é semelhante a enviar mensagens SMS, exceto que você deve transmitir a constante MULTIPART_MESSAGE ao criar o objeto MessageConnection. Para ouvir as mensagens MMS recebidas exibidas na lista de mensagens, configure o ID de aplicativo Connector.open() selecionado como 0.

Além de fornecer notificação aos aplicativos quando as mensagens são recebidas (usando a interface MessageListener), você também pode configurar a notificação de aplicativo para mensagens de saída e SMS enviadas e mensagens MMS. Para mensagens SMS, você pode configurar seu aplicativo para controlar mensagens SMS enviadas transmitindo uma instância de uma classe que implementa a interface OutboundMessageListener ao chamar MessageConnection.setMessageListener(). A notificação usando esta interface ocorre apenas depois que a mensagem é enviada com êxito. Se a operação de envio falhar, o aplicativo não será notificado.

BlackBerry Messenger

BBM é um programa de mensagens instantâneas que permite que os usuários do smartphone BlackBerry se comuniquem uns com os outros sem precisarem se conectar ou desconectar do aplicativo. Desde que os smartphones estejam conectados a uma rede sem fio, o BBM pode manter os usuários conectados a seus contatos e grupos BBM.

O BlackBerry Messenger SDK é um download separado do BlackBerry Java SDK. O BBM SDK, usado juntamente com o BlackBerry Java SDK, permite desenvolver aplicativos que incorporam recursos sociais, como conexões ponto a ponto entre smartphones BlackBerry e chats integrados. Por exemplo, em um aplicativo de jogo de xadrez, um usuário do smartphone BlackBerry poderia convidar um contato do BBM para um jogo de xadrez e os movimentos poderiam ser comunicados de um lado a outro usando a plataforma do BBM. Não há nenhuma necessidade desenvolver estes recursos sociais você mesmo e nenhum desenvolvimento do servidor é requerido para suportá-los.

Para obter mais informações sobre o BBM, consulte os Guias de desenvolvimento - BlackBerry Messenger Social Platform SDK.

Próximo tópico: APIs de conexão de rede
Tópico anterior: APIs de PIM

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