Guia do desenvolvedor
Local Navigation
- Visão geral do BlackBerry Messenger SDK
- Dependências de versão do BlackBerry Messenger
- Principais classes da plataforma do BlackBerry Messenger
- Registrando o aplicativo na plataforma do BlackBerry Messenger
- Interagindo com contatos
- Iniciar um bate-papo do BlackBerry Messenger
- Enviar um convite de download a um contato
- Enviar um convite de ingresso a um contato
- Enviar uma mensagem para um contato
- Enviar um arquivo para um contato
- Exibir uma lista de contatos que instalaram seu aplicativo
- Responder a alterações de um contato em sua lista de contatos
- Enviar um convite de sessão a um contato
- Host de uma sessão pública
- Ingressar em uma sessão pública do BlackBerry Messenger
- Enviar uma mensagem a todos os participantes em uma sessão
- Compartilhamento de conteúdo com contatos do BlackBerry Messenger
- Trabalhando com a caixa de perfis e com o perfil do usuário
- Definindo ouvintes de serviço
- Gerenciar as definições do BlackBerry Messenger do aplicativo
- Solução de problemas
- Enviar comentários
- Aviso legal
Documentação do produto
>
Documentação do desenvolvedor
>
BlackBerry Messenger Social Platform SDK
>
Guia do desenvolvedor
BlackBerry Messenger SDK - 1.3
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.
- 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;
- 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.
- 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) { } } - 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(); } } - 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()); } } - 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.
Próximo tópico: Exemplo de código: Host de uma sessão pública
Estas informações foram úteis? Gostaríamos de receber seus comentários.