API de mensajería

Las API de mensajería le permiten utilizar la funcionalidad de mensajería en sus aplicaciones, incluidos correos electrónicos, mensajes de aplicación, SMS, MMS y BlackBerry® Messenger.

Mensajes de correo electrónico

Los paquetes para los mensajes correo electrónico son net.rim.blackberry.api.mail y net.rim.blackberry.api.mail.event.

Para crear y enviar mensajes de correo electrónico, debe configurar el valor Sesión predeterminado, recuperar una instancia de Store, crear el mensaje de correo electrónico y almacenar el correo electrónico en una carpeta de elementos enviados recuperados. Por último, debe configurar y enviar el mensaje de correo electrónico.

Cada dispositivo BlackBerry tiene un PIN único y admite mensajería PIN a PIN enviada con la aplicación Mensajes. Para configurar su aplicación de forma que cree y envíe mensajes PIN, establezca la Sesión predeterminada, recupere una instancia de Store, establezca la dirección de PIN de destino, cree el mensaje PIN y almacene el mensaje en una carpeta enviada recuperada. Por último, debe configurar y enviar el mensaje de PIN.

Para enviar un mensaje de correo electrónico con un archivo adjunto, cree el objeto Multiparte, cree y añada el archivo adjunto a este objeto, y estructure y envíe el mensaje correo electrónico. Para descargar automáticamente archivos adjuntos en mensajes de correo electrónico en segundo plan cuando los mensajes lleguen a la lista de mensajes, utilice la interfaz DownloadProgressListener y la clase AttachmentDownloadManager.

Mensajes de la aplicación

Un ApplicationMessage es un mensaje personalizado que aparece en la aplicación Mensajes y que invoca su aplicación cuando el usuario la abre o elige un elemento del menú proporcionado para el mensaje. Puede utilizar un paquete messagelist para crear mensajes de la aplicación.

Mensajes SMS y MMS

Puede crear aplicaciones que envían y reciben mensajes SMS o mensajes MMS. La compatibilidad con los mensajes SMS se proporciona a través de JSR 120. La compatibilidad con los mensajes MMS se proporciona a través de JSR 205. Puede realizar las siguientes acciones:

  • Envío y recepción de mensajes SMS.
  • Enviar y recibir mensajes MMS.
  • Configurar servicios de escucha para mensajes salientes y enviados

Puede enviar mensajes SMS con la API javax.wireless.messaging y la API Invoke de BlackBerry®. No es posible enviar mensajes SMS directamente desde un smartphone BlackBerry que opera en una red CDMA.

Para recibir mensajes SMS a través de BlackBerry Java SDK 4.6.0 o posterior, utilice la interfaz MessageListener. Si utiliza una versión anterior del SDK, utilice la interfaz MessageConnection.

Si desea que mensajes SMS específicos se guarden en una carpeta de mensajes SMS, debe especificar la ubicación de la carpeta mediante MessageArguments cuando se reciba el mensaje SMS por parte del smartphone BlackBerry. Las aplicaciones no pueden acceder a los mensajes SMS almacenados en el smartphone BlackBerry.

Para escuchar los mensajes SMS entrantes que aparecen en la lista de mensajes, debe configurar el argumento del número de puerto de Connector.open() en 0 - Connector.open("sms://:0").

Los mensajes MMS cuentan con un encabezado MMS y un cuerpo MMS. El encabezado MMS consta de dirección, prioridad, asunto e información de entrega. El cuerpo MMS es la parte de archivo adjunto multimedia.

Para recibir mensajes MMS mediante BlackBerry Java SDK 4.6.0 o posterior, utilice la interfaz MessageListener. Si utiliza una versión anterior de BlackBerry JDE, debe utilizar la interfaz MessageConnection.

El envío de mensajes MMS es similar al envío de mensajes SMS, a excepción de que debe pasar la constante MULTIPART_MESSAGE al crear el objeto MessageConnection. Para escuchar los mensajes MMS entrantes que aparecen en la lista de mensajes, configure el ID de la aplicación Connector.open() seleccionada en 0.

Además de proporcionar notificaciones a las aplicaciones cuando se reciben mensajes (mediante la interfaz MessageListener), también puede configurar las notificaciones de las aplicaciones para los mensajes SMS y MMS salientes y enviados. Para los mensajes SMS, puede configurar su aplicación para efectuar un seguimiento de los mensajes SMS enviados pasando una instancia de una clase que implementa la interfaz OutboundMessageListener al invocar MessageConnection.setMessageListener(). La notificación mediante esta interfaz ocurre sólo una vez que el mensaje se ha enviado correctamente. Si la operación de envío genera un error, no se notificará a la aplicación.

BlackBerry Messenger

BBM es un programa de mensajería instantánea que permite a los usuarios de smartphones BlackBerry comunicarse sin iniciar sesión o salir de la aplicación. Siempre que los smartphones estén conectados a una red móvil, BBM mantiene conectados a los usuarios con sus contactos y grupos de BBM.

BlackBerry Messenger SDK es una descarga independiente de BlackBerry Java SDK. BBM SDK, utilizado en conjunto con BlackBerry Java SDK, le permite desarrollar aplicaciones que incorporan características sociales, por ejemplo, conexiones punto a punto entre smartphones BlackBerry y los chats integrados. Por ejemplo, en una aplicación de un juego de ajedrez, el usuario del smartphone BlackBerry podría invitar a un contacto de BBM a jugar una partida de ajedrez y los movimientos podrían enviarse y recibirse mediante la plataforma BBM. No es necesario que desarrolle estas características sociales por su cuenta, y tampoco es necesaria una herramienta de desarrollo de servidor para ofrecer compatibilidad con las mismas.

Para obtener más información acerca de BBM, consulte las guías para desarrolladores del SDK de la plataforma social BlackBerry Messenger.

Para obtener más información acerca de la mensajería

Tema siguiente: API de conexión de red

¿Le ha resultado útil esta información? Envíenos sus comentarios.