Guia do desenvolvedor

Local Navigation

Enviar um convite de sessão a um contato

Antes de começar: Verifique se você executou a tarefa, Registrar o aplicativo na plataforma do BlackBerry Messenger e se a classe que exibe a tela fornece uma referência ao objeto BBMPlatformContext associado do 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.*;
  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 do aplicativo.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext) 
        {
        }
    }
  4. No construtor, recupere uma referência ao serviço de mensagens associado ao contexto da plataforma deste 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.sendInvitation() para convidar um contato para a sua sessão. O método sendInvitation() pode ter três parâmetros. O primeiro parâmetro especifica uma mensagem a ser exibida quando o contato receber o convite. O segundo parâmetro é um argumento que será fornecido ao método principal do aplicativo como args[1]. O terceiro parâmetro é a hora de expiração do convite. O exemplo de código a seguir fornece o valor 0 para hora de expiração (ou seja, o convite nunca expira). Um componente de UI do seletor de contatos será automaticamente aberto para que o usuário escolha um contato a ser convidado.
    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);
            }
        }
    }

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