Antes de começar: Verifique se você executou a tarefa, Registre seu aplicativo na plataforma do BlackBerry Messenger e se a classe que exibe a tela no exemplo de código a seguir fornece uma referência ao objeto BBMPlatformContext associado do aplicativo.

1. Importe as classes e interfaces necessárias.

   import net.rim.blackberry.api.bbm.platform.*;
   import net.rim.blackberry.api.bbm.platform.service.*;
   import net.rim.device.api.ui.component.*;

2. Crie uma classe que estenda MainScreen. No construtor para esta classe de tela, forneça o objeto BBMPlatformContext associado do aplicativo.

   public class MyBBMInviteScreen extends MainScreen
   {
       public MyBBMInviteScreen(BBMPlatformContext platformContext)
       {
       }
   }

3. No construtor MyBBMInviteScreen, recupere uma referência ao serviço de mensagens associado ao contexto da plataforma deste aplicativo.

   public class MyBBMInviteScreen extends MainScreen
   {
       public MyBBMInviteScreen(BBMPlatformContext platformContext)
       {
           MessagingService messagingService = platformContext.getMessagingService();
       }
   }

4. Definir um ouvinte de canal. O exemplo de código na etapa 5 supõe que você nomeou a classe de ouvinte, MyChannelListener.
5. Invoque MessagingService.createChannel() para criar um novo BBMPlatformChannel, fornecendo a classe de ouvinte de canal.

   public class MyBBMInviteScreen extends MainScreen
   {
       public MyBBMInviteScreen(BBMPlatformContext platformContext)
       {
           MessagingService messagingService = platformContext.getMessagingService();
           BBMPlatformChannel channel = messagingService.createChannel(new MyChannelListener());
       }
   }

6. Em uma instrução if que verifica se você criou o BBMPlatformChannel com êxito, invoque BBMPlatformChannel.sendInvitation() para convidar um contato para o seu aplicativo. Nos parâmetros para sendInvitation(), você pode especificar uma mensagem a ser exibida quando o contato receber o convite, um parâmetro que será fornecido ao método principal do aplicativo como args[1], e uma hora de expiração. O exemplo de código a seguir fornece o valor 0 para hora de expiração (ou seja, o convite nunca expira). Um componente de UI do seletor de contato é aberto para o usuário escolher um contato a ser convidado.

   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);
           }
       }
   }

Quando terminar:

Você pode interagir com o contato que você convidou para o seu canal quando ele aceita seu convite.

• Exemplo de código: Enviando um convite de ingresso a um contato