Classi principali della piattaforma BlackBerry Messenger

Classe

Descrizione

BBMPlatformContext

L'interfaccia BBMPlatformContext controlla lo stato di accesso dell'applicazione e consente di recuperare riferimenti ai servizi associati all'applicazione (ad esempio, il servizio di messaggistica, il servizio di elenco contatti e il servizio Interfaccia utente).

La piattaforma BlackBerry Messenger restituisce un'istanza di BBMPlatformContext quando l'applicazione viene registrata sulla piattaforma BlackBerry Messenger.

È possibile ricevere delle notifiche delle modifiche allo stato di accesso o di registrazione della propria applicazione definendo una classe che estende la classe BBMPlatformContextListener e i suoi metodi.

MessagingService

La classe MessagingService consente di creare un'istanza di BBMPlatformChannel o BBMPlatformSession, invitare i contatti a scaricare la propria applicazione o inviare un file a un contatto di BlackBerry Messenger.

Per ricevere delle notifiche di eventi relativi al servizio di messaggistica, è necessario estendere la classe astratta, MessagingServiceListener, sovrascrivere i metodi di richiamata e richiamare il metodo MessagingService.setServiceListener().

Per recuperare un riferimento a MessagingService associato alla propria applicazione, richiamare BBMPlatformContext.getMessagingService().

BBMPlatformChannel

L'interfaccia BBMPlatformChannel rappresenta una connessione privata tra l'applicazione e uno o più contatti. Se l'applicazione comunica con più contatti, questi non sono a conoscenza gli uni degli altri. Di conseguenza, i contatti possono comunicare solo con l'applicazione, non l'un l'altro.

È possibile richiamare BBMPlatformConnection.setPublic() per impostare il canale in modo che consenta le connessioni dai contatti non presenti nell'elenco contatti di BlackBerry Messenger.

Per ricevere notifiche degli eventi e delle modifiche al canale, è necessario estendere la classe BBMPlatformChannelListener e sovrascrivere i metodi di richiamata ereditati dalla classe BBMPlatformConnectionListener.

Per creare un'istanza di BBMPlatformChannel, richiamare MessagingService.createChannel(), passando un riferimento a un'istanza di BBMPlatformChannelListener.

BBMPlatformSession

L'interfaccia BBMPlatformSession rappresenta la connessione tra i contatti di BlackBerry Messenger. Quando si crea una connessione alla sessione, qualunque contatto nella sessione può invitare uno o più contatti a unirsi alla sessione. Ogni contatto nella sessione è disponibile per la condivisione dei dati.

È possibile richiamare BBMPlatformConnection.setPublic() per impostare la sessione in modo che consenta di stabilire le connessioni dai contatti non presenti nell'elenco contatti di BlackBerry Messenger.

Per ricevere notifiche degli eventi e delle modifiche alla sessione, è necessario estendere la classe BBMPlatformSessionListener e sovrascrivere i suoi metodi di richiamata e quelli ereditati dalla classe BBMPlatformConnectionListener.

Per creare un'istanza di BBMPlatformSession, richiamare MessagingService.createSession(), passando un riferimento a un oggetto BBMPlatformSessionListener per assegnare il listener.

ContactListService

La classe ContactListService fornisce l'accesso ai contatti presenti nell'elenco contatti di BlackBerry Messenger che hanno installato l'applicazione.

Per ricevere notifiche delle modifiche ai contatti dell'elenco contatti, è necessario implementare l'interfaccia, PresenceListener. PresenceListener contiene un metodo di richiamata, presenceUpdated(), che viene richiamato quando uno dei contatti presenti nell'elenco contatti aggiorna la propria immagine, il nome visualizzato, il messaggio personale o lo stato.

Per recuperare un riferimento a ContactListService per la propria applicazione, richiamare BBMPlatformContext.getContactListService().

Per assegnare un PresenceListener al proprio elenco contatti, richiamare ContactListService.setListener(PresenceListener).

UIService

La classe UIService fornisce metodi per aggiungere una voce di menu specifica dell'applicazione a BlackBerry Messenger, accedere a un selettore di contatti che consente di scegliere un contatto in base a una serie di parametri che è possibile definire, consentire a un utente di invitare contatti che non sono presenti nell'elenco dei contatti BlackBerry Messenger di un utente a BBM oppure avviare una chat BlackBerry Messenger.

Per recuperare un riferimento a UIService per la propria applicazione, richiamare BBMPlatformContext.getUIService().

MenuItemManager

La classe MenuItemManager fornisce dei metodi per creare, aggiungere, rimuovere e verificare una voce di menu sulla schermata dell'elenco contatti di BlackBerry Messenger. La voce di menu invita il contatto selezionato a interagire con l'utente tramite l'applicazione connessa a BlackBerry Messenger.

La voce di menu viene visualizzata solo se il contatto selezionato ha installato l'applicazione.

Se esiste già una voce di menu per la propria applicazione, quando si aggiunge una nuova voce di menu, quella esistente viene sovrascritta.


Le informazioni sono state utili? Inviateci i vostri commenti.