Guida allo sviluppo

Local Navigation

Avvio di una sessione pubblica

Prima di iniziare: Assicurarsi di aver completato l'attività Registrazione dell'applicazione con la piattaforma BlackBerry Messenger e che la classe che visualizza i passaggi della schermata passi un riferimento all'oggetto BBMPlatformContext associato all'applicazione nel costruttore della schermata.
  1. Importare le classi e le interfacce richieste.
    import net.rim.blackberry.api.bbm.platform.*;
    import net.rim.blackberry.api.bbm.platform.service.*;
    import net.rim.device.api.ui.component.*;
    import net.rim.device.api.ui.container.MainScreen;
  2. Definizione del listener di una sessione. L'esempio di codice nel passaggio 5 presuppone che sia stato assegnato un nome alla classe del listener MySessionListener.
  3. Creare una classe che estenda MainScreen. Nel costruttore di questa classe Screen, passare l'oggetto BBMPlatformContext associato all'applicazione.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
        }
    }
  4. Nel costruttore, recuperare un riferimento al servizio di messaggistica per quest'applicazione.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
        }
    }
  5. Richiamare MessagingService.createSession() per creare una nuova istanza di BBMPlatformSession. Passare un'istanza del listener definita nel passaggio 2 come parametro.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformSession mySession = messagingService.createSession(new 
                 MySessionListener());
        }
    }
  6. Richiamare BBMPlatformSession.setPublic() per impostare la sessione come pubblica in modo che possano parteciparvi anche i contatti non presenti nell'elenco contatti di BlackBerry Messenger. Quando viene richiamato questo metodo, viene visualizzata una finestra di dialogo all'utente.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformSession mySession = messagingService.createSession(new 
             MySessionListener());
            boolean isHosting = mySession.setPublic();
             if (isHosting)
                 {
                    // add code to send PIN and PPID to your web service
                 }
        }
    }
    Una volta confermata l'intenzione di ospitare la sessione, è necessario inviare al servizio Web il proprio PIN e PPID. È ora possibile ricevere le richieste di partecipazione dagli utenti che desiderano unirsi alla sessione anche se non sono presenti nei contatti di BlackBerry Messenger. Il metodo joinRequestReceived() nell'implementazione di BBMPlatformSessionListener viene richiamato quando si riceve un oggetto BBMPlatformIncomingJoinRequest dall'applicazione. È possibile accettare o rifiutare questa richiesta richiamando BBMPlatformIncomingJoinRequest.accept() o BBMPlatformIncomingJoinRequest.decline(), rispettivamente.

Le informazioni sono state utili? Inviateci i vostri commenti.