Entwicklungshandbuch

Local Navigation

Senden einer Sitzungseinladung an einen Kontakt

Vor Beginn erforderliche Aktion: Stellen Sie sicher, dass Sie die Aufgabe Registrieren Ihrer Anwendung bei der BlackBerry Messenger-Plattform abgeschlossen haben und die Klasse, die den Bildschirm anzeigt, einen Verweis auf das mit der Anwendung verknüpfte BBMPlatformContext-Objekt an den Konstruktor des Bildschirms übergibt.
  1. Importieren Sie die erforderlichen Klassen und Schnittstellen.
    import net.rim.blackberry.api.bbm.platform.*;
    import net.rim.blackberry.api.bbm.platform.service.*;
    import net.rim.device.api.ui.component.*;
  2. Definieren eines Sitzungslisteners. Im Codebeispiel in Schritt 5 wird davon ausgegangen, dass Sie die Listener-Klasse MySessionListener genannt haben.
  3. Erstellen Sie eine Klasse, die MainScreen erweitert. Geben Sie im Konstruktor für diese Screen-Klasse das mit der Anwendung verknüpfte BBMPlatformContext-Objekt ein.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
        }
    }
  4. Rufen Sie im Konstruktor eine Referenz auf den Nachrichtendienst ab, der mit dem Plattformkontext dieser Anwendung verknüpft ist.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
        }
    }
  5. Rufen Sie MessagingService.createSession() auf, um eine neue BBMPlatformSession-Instanz zu erstellen. Geben Sie eine Instanz des Listeners ein, den Sie in Schritt 2 als Parameter definiert haben.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformSession mySession = messagingService.createSession(new MySessionListener());
        }
    }
  6. Rufen Sie BBMPlatformSession.sendInvitation() auf, um einen Kontakt zu Ihrer Sitzung einzuladen. Die sendInvitation()-Methode kann drei Parameter annehmen. Der erste Parameter gibt eine Nachricht an, die angezeigt werden soll, wenn der Kontakt die Einladung empfängt. Der zweite Parameter ist ein Argument, das als args[1] an die Hauptmethode der Anwendung übergeben wird. Der dritte Parameter ist die Ablaufzeit der Einladung. Im folgenden Codebeispiel wird als Ablaufzeit der Wert "0" übergeben (d. h. die Einladung läuft nie ab). Eine Benutzeroberflächenkomponente für die Kontaktauswahl wird automatisch geöffnet, aus welcher der Benutzer einen Kontakt für die Einladung auswählen kann.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatforSession mySession = messagingService.createSession(new MySessionListener());
            if (mySession != null) 
            {
                mySession.sendInvitation(“Let's play a game”, "Poker App", 0);
            }
        }
    }

Waren diese Informationen hilfreich? Senden Sie uns Ihren Kommentar.