Classes principales de la plate-forme BlackBerry Messenger

Classe

Description

BBMPlatformContext

L'interface BBMPlatformContext vérifie le statut d'accès de votre application et vous autorise à récupérer des références aux services associés à cette application (par exemple, le service de messagerie, le service de la liste de contacts et le service d'interface utilisateur).

La plate-forme BlackBerry Messenger renvoie une instance BBMPlatformContext lorsque votre application est enregistrée sur la plate-forme BlackBerry Messenger.

Vous pouvez recevoir des notifications de modifications apportées au statut d'accès ou d'enregistrement de votre application en définissant une classe qui développe la classe BBMPlatformContextListener et ses méthodes.

MessagingService

La classe MessagingService vous autorise à créer une instance BBMPlatformChannel ou BBMPlatformSession, à inviter des contacts à télécharger votre application ou à envoyer un fichier à un contact BlackBerry Messenger.

Pour recevoir des notifications d'événements concernant le service de messagerie, vous devez développer la classe abstraite MessagingServiceListener, ignorer ses méthodes de rappel et appeler la méthode MessagingService.setServiceListener().

Pour récupérer une référence au MessagingService qui est associé à votre application, appelez BBMPlatformContext.getMessagingService().

BBMPlatformChannel

L'interface BBMPlatformChannel représente une connexion privée entre votre application et un ou plusieurs contacts. Si votre application communique avec plusieurs contacts, les contacts n'ont pas connaissance les uns des autres. Par conséquent, ils peuvent uniquement communiquer avec votre application, et non entre eux.

Vous pouvez appeler BBMPlatformConnection.setPublic() pour configurer votre canal afin qu'il autorise des connexions de contacts qui ne figurent pas dans votre liste de contacts BlackBerry Messenger.

Pour recevoir des notifications d'événements et de modifications apportées du canal, vous devez développer la classe BBMPlatformChannelListener et ignorer les méthodes de rappel héritées de la classe BBMPlatformConnectionListener.

Pour créer une instance de BBMPlatformChannel, appelez MessagingService.createChannel() en passant une référence à une instance BBMPlatformChannelListener.

BBMPlatformSession

L'interface BBMPlatformSession représente la connexion entre les contacts BlackBerry Messenger. Lorsque vous créez une connexion de session, n'importe quel contact de la session peut inviter un ou plusieurs autres contacts à rejoindre cette session. Chaque contact de la session est disponible pour le partage de données.

Vous pouvez appeler BBMPlatformConnection.setPublic() pour configurer votre session afin qu'elle autorise des connexions de contacts qui ne figurent pas dans votre liste de contacts BlackBerry Messenger.

Pour recevoir des notifications d'événements et de modifications de la session, vous devez développer la classe BBMPlatformSessionListener et ignorer les méthodes de rappel héritées de la classe BBMPlatformConnectionListener.

Pour créer une instance de BBMPlatformSession, appelez MessagingService.createSession() en passant une référence à un objet BBMPlatformSessionListener pour attribuer l'écouteur.

ContactListService

La classe ContactListService fournit un accès aux contacts de la liste de contacts BlackBerry Messenger de l'utilisateur qui ont installé l'application.

Pour recevoir des notifications de modifications des contacts de la liste, vous devez mettre en œuvre l'interface PresenceListener. PresenceListener contient une méthode de rappel, presenceUpdated(), qui est appelée lorsque l'un des contacts de votre liste de contacts met à jour son image affichée, son nom affiché, son message personnel ou son statut.

Pour récupérer une référence à ContactListService pour votre application, appelez BBMPlatformContext.getContactListService().

Pour attribuer un PresenceListener à votre liste de contacts, appelez ContactListService.setListener(PresenceListener).

UIService

La classe UIService fournit des méthodes pour ajouter un élément de menu spécifique à l'application à BlackBerry Messenger, accéder à un sélecteur de contact qui permet à l'utilisateur de choisir un contact selon un ensemble que vous pouvez définir, permettre à l'utilisateur d'inviter des contacts qui ne sont pas dans sa liste de contacts BlackBerry Messenger à BBM ou de démarrer un chat BlackBerry Messenger.

Pour récupérer une référence à l'objet UIService pour votre application, appelez BBMPlatformContext.getUIService().

MenuItemManager

La classe MenuItemManager fournit des méthodes pour créer, ajouter, supprimer, et vérifier un élément de menu sur l’écran de la liste de contacts BlackBerry Messenger. L'élément de menu invite le contact sélectionné à interagir avec l'utilisateur qui utilise votre application connectée à BlackBerry Messenger.

L'élément de menu ne s'affiche que si le contact sélectionné a installé l'application.

Si un élément de menu pour votre application existe déjà, lorsque vous ajoutez un nouvel élément de menu, l'élément existant est écrasé.


Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.