Guida allo sviluppo
Local Navigation
- Panoramica di BlackBerry Messenger SDK
- Dipendenze tra le versioni di BlackBerry Messenger
- Classi principali della piattaforma BlackBerry Messenger
- Registrazione dell'applicazione con la piattaforma BlackBerry Messenger
- Interazione con i contatti
- Avvio di una chat BlackBerry Messenger
- Invio di un invito di download a un contatto
- Invio di un invito di partecipazione a un contatto
- Invio di un messaggio a un contatto
- Invio di un file a un contatto
- Visualizzazione di un elenco di contatti che hanno installato l'applicazione
- Risposta alle modifiche di un contatto nell'elenco contatti
- Invio di un invito di sessione a un contatto
- Avvio di una sessione pubblica
- Partecipazione a una sessione pubblica di BlackBerry Messenger
- Invio di un messaggio a tutti i partecipanti di una sessione
- Condivisione del contenuto con i contatti BlackBerry Messenger
- Utilizzo del profilo utente e della casella del profilo
- Definizione dei listener di un servizio
- Gestione delle impostazioni di BlackBerry Messenger delle applicazioni
- Risoluzione dei problemi
- Commenti e suggerimenti
- Note legali
Documentazione sui prodotti
>
Documentazione per gli sviluppatori
>
BlackBerry Messenger Social Platform SDK
>
Guida allo sviluppo
BlackBerry Messenger SDK - 1.3
Avvio di una sessione pubblica
Prima di iniziare: Assicurarsi di aver completato l'attività Registrazione dell'applicazione con la piattaforma BlackBerry Messenger e che la classe che visualizza i passaggi della schermata passi un riferimento all'oggetto BBMPlatformContext associato all'applicazione nel costruttore della schermata.
- Importare le classi e le interfacce richieste.
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;
- Definizione del listener di una sessione. L'esempio di codice nel passaggio 5 presuppone che sia stato assegnato un nome alla classe del listener MySessionListener.
- Creare una classe che estenda MainScreen. Nel costruttore di questa classe Screen, passare l'oggetto BBMPlatformContext associato all'applicazione.
public class MyBBMInviteScreen extends MainScreen { public MyBBMInviteScreen(BBMPlatformContext platformContext) { } } - Nel costruttore, recuperare un riferimento al servizio di messaggistica per quest'applicazione.
public class MyBBMInviteScreen extends MainScreen { public MyBBMInviteScreen(BBMPlatformContext platformContext) { MessagingService messagingService = platformContext.getMessagingService(); } } - Richiamare MessagingService.createSession() per creare una nuova istanza di BBMPlatformSession. Passare un'istanza del listener definita nel passaggio 2 come parametro.
public class MyBBMInviteScreen extends MainScreen { public MyBBMInviteScreen(BBMPlatformContext platformContext) { MessagingService messagingService = platformContext.getMessagingService(); BBMPlatformSession mySession = messagingService.createSession(new MySessionListener()); } } - Richiamare BBMPlatformSession.setPublic() per impostare la sessione come pubblica in modo che possano parteciparvi anche i contatti non presenti nell'elenco contatti di BlackBerry
Messenger. Quando viene richiamato questo metodo, viene visualizzata una finestra di dialogo all'utente.
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 } } }Una volta confermata l'intenzione di ospitare la sessione, è necessario inviare al servizio Web il proprio PIN e PPID. È ora possibile ricevere le richieste di partecipazione dagli utenti che desiderano unirsi alla sessione anche se non sono presenti nei contatti di BlackBerry Messenger. Il metodo joinRequestReceived() nell'implementazione di BBMPlatformSessionListener viene richiamato quando si riceve un oggetto BBMPlatformIncomingJoinRequest dall'applicazione. È possibile accettare o rifiutare questa richiesta richiamando BBMPlatformIncomingJoinRequest.accept() o BBMPlatformIncomingJoinRequest.decline(), rispettivamente.
Argomento successivo: Esempio di codice: Hosting di una sessione pubblica
Argomento precedente: Esempio di codice: Invio di un invito a unirsi a una sessione a un contatto
Le informazioni sono state utili? Inviateci i vostri commenti.