Guia do desenvolvedor

Local Navigation

Enviar um convite de ingresso a um contato

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 no exemplo de código a seguir fornece uma referência ao objeto BBMPlatformContext associado do aplicativo.
  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. 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)
        {
        }
    }
  3. No construtor MyBBMInviteScreen, 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();
        }
    }
  4. Definir um ouvinte de canal. O exemplo de código na etapa 5 supõe que você nomeou a classe de ouvinte, MyChannelListener.
  5. Invoque MessagingService.createChannel() para criar um novo BBMPlatformChannel, fornecendo a classe de ouvinte de canal.
    public class MyBBMInviteScreen extends MainScreen
    {
        public MyBBMInviteScreen(BBMPlatformContext platformContext)
        {
            MessagingService messagingService = platformContext.getMessagingService();
            BBMPlatformChannel channel = messagingService.createChannel(new MyChannelListener());
        }
    }
  6. Em uma instrução if que verifica se você criou o BBMPlatformChannel com êxito, invoque BBMPlatformChannel.sendInvitation() para convidar um contato para o seu aplicativo. Nos parâmetros para sendInvitation(), você pode especificar uma mensagem a ser exibida quando o contato receber o convite, um parâmetro que será fornecido ao método principal do aplicativo como args[1], e uma hora de expiração. 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 contato é aberto para o usuário escolher um contato a ser convidado.
    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);
            }
        }
    }
Quando terminar:

Você pode interagir com o contato que você convidou para o seu canal quando ele aceita seu convite.


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