Avant de commencer : Assurez-vous que vous avez terminé la tâche Enregistrez votre application sur la plate-forme BlackBerry Messenger et que la classe qui affiche l'écran dans l'échantillon de code suivant passe une référence à l'objet BBMPlatformContext associé à l'application.

1. Importez les classes et les interfaces requises.

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

2. Créez une classe développant MainScreen. Dans le constructeur pour cette classe d'écran, transmettez l'objet BBMPlatformContext associé à l'application.

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

3. Dans le constructeur MyBBMInviteScreen, récupérez une référence au service de messagerie associé au contexte de plate-forme de cette application.

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

4. Définir un écouteur de canal. L'échantillon de code à l'étape 5 suppose que vous avez nommé la classe d'écouteur, MyChannelListener.
5. Appelez MessagingService.createChannel() pour créer un nouveau BBMPlatformChannel, passant votre classe d'écouteur de canal.

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

6. Dans une instruction if qui vérifie si vous avez correctement créé BBMPlatformChannel, appelez BBMPlatformChannel.sendInvitation() pour inviter un contact à rejoindre votre application. Dans les paramètres pour sendInvitation(), vous pouvez spécifier un message à afficher lorsque le contact reçoit l'invitation, un paramètre qui sera transmis à la méthode principale de l'application comme args[1], et un délai d'expiration. L'échantillon de code suivant passe la valeur 0 comme délai d'expiration (c'est-à-dire que l'invitation n'expire jamais). Un composant de l'interface utilisateur du sélecteur de contact s'ouvre pour que l'utilisateur choisisse un contact à inviter.

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

Après avoir terminé :

Vous pouvez interagir avec le contact que vous avez invité à votre canal lorsqu'il accepte votre invitation.

• Échantillon de code : envoi d'une invitation d'adhésion à un contact