Guida allo sviluppo

Local Navigation

Invio di un invito di partecipazione a un contatto

Prima di iniziare: Assicurarsi di aver completato l'attività Registrazione dell'applicazione con la piattaforma BlackBerry Messenger e che la classe visualizzata nella schermata nell'esempio di codice riportato di seguito passi un riferimento all'oggetto BBMPlatformContext associato all'applicazione.
  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.*;
  2. 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)
        {
        }
    }
  3. Nel costruttore MyBBMInviteScreen, recuperare un riferimento al servizio di messaggistica associato a questo contesto della piattaforma dell'applicazione.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext)
        {
            MessagingService messagingService = platformContext.getMessagingService();
        }
    }
  4. Definizione di un listener del canale. L'esempio di codice nel passaggio 5 presuppone che sia stato assegnato un nome alla classe del listener MyChannelListener.
  5. Richiamare MessagingService.createChannel() per creare un nuovo BBMPlatformChannel, passando la classe listener del canale.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext)
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformChannel channel = messagingService.createChannel(new MyChannelListener());
        }
    }
  6. In un'istruzione if che controlla la corretta creazione di BBMPlatformChannel, richiamare BBMPlatformChannel.sendInvitation() per invitare un contatto all'applicazione. Nei parametri per sendInvitation(), è possibile specificare che venga visualizzato un messaggio quando il contatto riceve l'invito, un parametro che verrà passato al metodo principale dell'applicazione come args[1] e un'ora di scadenza. Nell'esempio di codice seguente viene passato il valore 0 come ora di scadenza (ovvero, l'invito non scade mai). Un componente selettore dei contatti dell'interfaccia utente si apre per consentire all'utente di scegliere un contatto da invitare.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext)
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformChannel channel = messagingService.createChannel(new MyChannelListener());
            if (channel != null) 
            {
                channel.sendInvitation(“Let's play a game”, "Chess App", 0);
            }
        }
    }
Al termine:

Una volta accettato l'invito, è possibile interagire con il contatto invitato nel canale.


Le informazioni sono state utili? Inviateci i vostri commenti.