Guide de développement

Local Navigation

Envoyer une invitation d'adhésion à un contact

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.


Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.