Guide de développement

Local Navigation

Héberger une session publique

Avant de commencer : Assurez-vous que vous avez terminé la tâche Enregistrer votre application sur la plate-forme BlackBerry Messenger et que la classe qui affiche l'écran transmet une référence à l'objet BBMPlatformContext associé à votre application dans le constructeur de l'écran.
  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.*;
    import net.rim.device.api.ui.container.MainScreen;
  2. Définir un écouteur de session. L'échantillon de code à l'étape 5 suppose que vous avez nommé la classe d'écouteur, MySessionListener.
  3. Créez une classe développant MainScreen. Dans le constructeur pour cette classe d'écran, transmettez l'objet BBMPlatformContext associé à votre application.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
        }
    }
  4. Dans le constructeur, récupérez une référence aux données des services de messagerie pour cette application.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
        }
    }
  5. Appelez MessagingService.createSession() pour créer une nouvelle instance BBMPlatformSession. Passez une instance de l'écouteur que vous avez définie à l'étape 2 comme un paramètre.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformSession mySession = messagingService.createSession(new 
                 MySessionListener());
        }
    }
  6. Appelez BBMPlatformSession.setPublic() pour définir cette session comme publique, afin que les contacts qui ne figurent pas dans votre liste de contacts BlackBerry Messenger puissent la rejoindre. Une boîte de dialogue de confirmation se présente à l'utilisateur lorsque cette méthode est appelée.
    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
                 }
        }
    }
    Après avoir confirmé que vous voulez héberger la session, vous devez envoyer votre code PIN et PPID à votre service Web. Vous pouvez désormais recevoir les demandes d'utilisateurs qui souhaitent rejoindre votre session, même s'ils ne font pas partie de vos contacts BlackBerry Messenger. La méthode joinRequestReceived() dans votre mise en œuvre BBMPlatformSessionListener est appelée lorsqu'un objet BBMPlatformIncomingJoinRequest est reçu par votre application. Vous pouvez accepter ou refuser cette demande en appelant BBMPlatformIncomingJoinRequest.accept() ou BBMPlatformIncomingJoinRequest.decline(), respectivement.

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