Guia do desenvolvedor

Local Navigation

Host de uma sessão pública

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 fornece uma referência ao objeto BBMPlatformContext associado ao seu aplicativo para o construtor da tela.
  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.*;
    import net.rim.device.api.ui.container.MainScreen;
  2. Definir um ouvinte de sessão. O exemplo de código na etapa 5 supõe que você tenha nomeado a classe de ouvinte, MySessionListener.
  3. Crie uma classe que estenda MainScreen. No construtor para esta classe de tela, forneça o objeto BBMPlatformContext associado ao seu aplicativo.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
        }
    }
  4. No construtor, recupere uma referência ao serviço de mensagens para este aplicativo.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
        }
    }
  5. Invoque MessagingService.createSession() para criar uma nova instância BBMPlatformSession. Forneça uma instância de ouvinte que você definiu na etapa 2 como um parâmetro.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformSession mySession = messagingService.createSession(new 
                 MySessionListener());
        }
    }
  6. Invoque BBMPlatformSession.setPublic() para definir esta sessão como pública, para que contatos que não estiverem na sua lista de contatos do BlackBerry Messenger possam ingressar. Uma caixa de diálogo de confirmação é apresentada ao usuário quando este método é invocado.
    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
                 }
        }
    }
    Depois de confirmar que você deseja host a sessão, você deve enviar seu PIN e PPID para seu serviço Web. Agora você pode receber solicitações de ingresso de usuários querendo ingressar na sua sessão, mesmo que eles não sejam um dos seus contatos do BlackBerry Messenger. O método joinRequestReceived() em sua implementação BBMPlatformSessionListener é invocado quando um objeto BBMPlatformIncomingJoinRequest é recebido por seu aplicativo. Você pode aceitar ou recusar esta solicitação invocando BBMPlatformIncomingJoinRequest.accept() ou BBMPlatformIncomingJoinRequest.decline(), respectivamente.

Estas informações foram úteis? Gostaríamos de receber seus comentários.