Clases clave de la plataforma BlackBerry Messenger

Clase

Descripción

BBMPlatformContext

La interfaz BBMPlatformContext comprueba el estado de acceso de su aplicación y le permite recuperar referencias a los servicios asociados a la aplicación (por ejemplo, el servicio de mensajería, el servicio de la lista de contactos y el servicio de interfaz de usuario).

La plataforma BlackBerry Messenger devuelve una instancia BBMPlatformContext cuando su aplicación se registra con la plataforma BlackBerry Messenger.

Puede recibir notificaciones de cambios en el estado de acceso o de registro de su aplicación definiendo una clase que amplíe la clase BBMPlatformContextListener y sus métodos.

MessagingService

La clase MessagingService le permite crear una instancia BBMPlatformChannel o una instancia BBMPlatformSession, invitar a los contactos a descargar su aplicación o enviar un archivo a un contacto de BlackBerry Messenger.

Para recibir notificaciones de eventos relacionados con el servicio de mensajería, debe ampliar la clase abstracta MessagingServiceListener, omitir sus métodos de devolución de llamada e invocar el método MessagingService.setServiceListener().

Para recuperar una referencia al MessagingService asociado a su aplicación, invoque BBMPlatformContext.getMessagingService().

BBMPlatformChannel

La interfaz BBMPlatformChannel representa una conexión privada entre su aplicación y uno o más contactos. Si su aplicación se comunica con varios contactos, los contactos no conocerán dicha circunstancia. Por consiguiente, los contactos sólo se podrán comunicar con su aplicación y no entre ellos.

Puede invocar BBMPlatformConnection.setPublic() para configurar su canal de forma que permita las conexiones de contactos que no estén en su lista de contactos de BlackBerry Messenger.

Para recibir notificaciones de los eventos y cambios del canal, debe ampliar la clase BBMPlatformChannelListener y omitir los métodos de devolución de llamada heredados de la clase BBMPlatformConnectionListener.

Para crear una instancia de BBMPlatformChannel, invoque MessagingService.createChannel() pasando una referencia a una instancia BBMPlatformChannelListener.

BBMPlatformSession

La interfaz BBMPlatformSession representa la conexión entre los contactos de BlackBerry Messenger. Al crear una conexión de sesión, cualquier contacto de la sesión puede invitar a otro contacto o contactos a unirse a la sesión. Cada uno de los contactos de la sesión está disponible para el uso compartido de datos.

Puede invocar BBMPlatformConnection.setPublic() para configurar su sesión de forma que permita las conexiones de contactos que no estén en su lista de contactos de BlackBerry Messenger.

Para recibir notificaciones de los eventos y cambios de la sesión, debe ampliar la clase BBMPlatformSessionListener y omitir sus métodos de devolución de llamada y los métodos de devolución de llamada heredados de la clase BBMPlatformConnectionListener.

Para crear una instancia de BBMPlatformSession, invoque MessagingService.createSession() pasando una referencia a un objeto BBMPlatformSessionListener para asignar el servicio de escucha.

ContactListService

La clase ContactListService proporciona acceso a dichos contactos de la lista de contactos de BlackBerry Messenger del usuario que tienen la aplicación instalada.

Para recibir notificaciones de los cambios realizados a los contactos en la lista de contactos, debe implementar la interfaz PresenceListener. PresenceListener contiene un método de devolución de llamada, presenceUpdated(), al cual se llama cuando uno de los contactos de su lista actualiza su imagen de visualización, nombre para mostrar, mensaje personal o estado.

Para recuperar una referencia al ContactListService para su aplicación, invoque BBMPlatformContext.getContactListService().

Para asignar un PresenceListener a su lista de contactos, invoque ContactListService.setListener(PresenceListener).

UIService

La clase UIService ofrece los métodos para agregar un elemento de menú específico de la aplicación a BlackBerry Messenger, acceder a un colector de contactos que permita al usuario elegir un contacto según un conjunto que puede definir, permitir a un usuario invitar a los contactos que no están en su lista de contactos de BlackBerry Messenger a BBM o iniciar una sesión de chat de BlackBerry Messenger.

Para recuperar una referencia al UIService para su aplicación, invoque BBMPlatformContext.getUIService().

MenuItemManager

La clase MenuItemManager proporciona métodos para crear, agregar, eliminar y buscar un elemento de menú en la pantalla de la lista de contactos de BlackBerry Messenger. El elemento de menú invita al contacto seleccionado a interactuar con el usuario mediante su aplicación conectada a BlackBerry Messenger.

El elemento de menú se muestra sólo si el contacto seleccionado tiene la aplicación instalada.

Si ya existe un elemento de menú para su aplicación, cuando agregue un nuevo elemento de menú, el existente se sobrescribe.


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