API di messaggistica

Le API di messaggistica consentono di utilizzare la funzionalità di messaggistica nelle applicazioni, inclusi messaggi e-mail, messaggi dell'applicazione, SMS, MMS e BlackBerry® Messenger.

Messaggi e-mail

I pacchetti per i messaggi e-mail sono net.rim.blackberry.api.mail e net.rim.blackberry.api.mail.event.

Per configurare l'applicazione per creare e inviare messaggi e-mail, impostare la Sessione predefinita, recuperare un'istanza Store, creare il messaggio e-mail e memorizzarlo in una cartella di posta inviata recuperata. Infine, preparare e inviare il messaggio e-mail.

A ogni dispositivo BlackBerry è associato un PIN univoco che supporta la messaggistica PIN-TO-PIN inviata con l'applicazione Messaggi. Per configurare l'applicazione per creare e inviare messaggi PIN, impostare la Sessione predefinita, recuperare un'istanza Store, impostare l'indirizzo PIN di destinazione, creare il messaggio PIN e memorizzarlo in una cartella di posta inviata recuperata. Infine, preparare e inviare il messaggio PIN.

Per inviare un messaggio e-mail con un allegato, creare l'oggetto Multipart, creare e aggiungere il file dell'allegato a questo oggetto. Infine preparare e inviare il messaggio. Per scaricare automaticamente gli allegati nei messaggi e-mail in background all'arrivo dei messaggi nel relativo elenco, utilizzare l'interfaccia DownloadProgressListener e la classe AttachmentDownloadManager.

Messaggi dell'applicazione

Un ApplicationMessage è un messaggio personalizzato che viene visualizzato nei messaggi dell'applicazione e richiama l'applicazione una volta aperta o selezionata una voce di menu fornita per il messaggio. Utilizzare il pacchetto messagelist per creare messaggi dell'applicazione.

Messaggi SMS e MMS

È possibile creare applicazioni che inviano e ricevono messaggi SMS o MMS. Il supporto SMS viene fornito tramite JSR 120. Il supporto MMS viene fornito tramite JSR 205. È possibile eseguire le seguenti azioni:

  • Invio e ricezione di messaggi SMS
  • Invio e ricezione di messaggi MMS
  • Configurazione di listener per i messaggi in uscita e inviati

È possibile inviare messaggi SMS tramite javax.wireless.messaging e BlackBerry® Invoke API. Non è possibile inviare messaggi SMS direttamente da uno smartphone BlackBerry che opera su una rete CDMA.

Per ricevere messaggi SMS che utilizzano BlackBerry Java SDK 4.6.0 o versioni successive, utilizzare l'interfaccia MessageListener. Se si utilizza una versione precedente di SDK, utilizzare l'interfaccia MessageConnection.

Se si desidera salvare messaggi SMS specifici in una cartella di messaggi SMS, è necessario specificare la posizione della cartella tramite MessageArguments quando il messaggio SMS viene ricevuto dallo smartphone BlackBerry. Le applicazioni non possono accedere ai messaggi SMS memorizzati sullo smartphone BlackBerry.

Per ascoltare i messaggi SMS in arrivo visualizzati nell'elenco messaggi, impostare l'argomento del numero porta Connector.open() su 0 - Connector.open("sms://:0").

I messaggi MMS sono costituiti da un'intestazione e dal corpo MMS. L'intestazione MMS è costituita dalle informazioni su indirizzo, priorità, oggetto e recapito. Il corpo MMS contiene la parte dell'allegato multimediale.

Per ricevere messaggi MMS durante l'utilizzo di BlackBerry Java SDK 4.6.0 o versioni successive, utilizzare l'interfaccia MessageListener. Se si utilizza una versione precedente di BlackBerry JDE, utilizzare l'interfaccia MessageConnection.

L'invio di messaggi MMS è simile all'invio di messaggi SMS, ma è necessario passare la costante MULTIPART_MESSAGE quando viene creato l'oggetto MessageConnection. Per ascoltare i messaggi MMS in arrivo visualizzati nell'elenco messaggi, impostare l'ID applicazione Connector.open( selezionato) su 0.

Oltre a fornire notifiche di ricezione dei messaggi alle applicazioni (tramite l'interfaccia MessageListener), è possibile configurare la notifica alle applicazioni per i messaggi SMS e MMS in uscita e inviati. Per i messaggi SMS, è possibile configurare l'applicazione per il rilevamento dei messaggi SMS inviati passando un'istanza di una classe che implementa l'interfaccia OutboundMessageListener quando si richiama MessageConnection.setMessageListener(). La notifica che utilizza questa interfaccia viene ricevuta dall'applicazione solo una volta inviato correttamente il messaggio. Se l'operazione di invio non viene eseguita correttamente, l'applicazione non riceve una notifica.

BlackBerry Messenger

BBM è un programma di messaggistica istantanea che consente agli utenti BlackBerry di comunicare tra loro senza accedere o uscire dall'applicazione. Se gli smartphone sono connessi a una rete wireless, BBM può mantenere gli utenti connessi ai rispettivi contatti e gruppi BBM.

BlackBerry Messenger SDK è un download separato da BlackBerry Java SDK. BBM SDK, utilizzato unitamente a BlackBerry Java SDK, consente di sviluppare applicazioni che incorporano funzionalità sociali, come le connessioni peer-to-peer tra gli smartphone BlackBerry e le chat integrate. Ad esempio, in un'applicazione del gioco degli scacchi, un utente BlackBerry potrebbe invitare un contatto BBM a giocare al gioco degli scacchi e le mosse potrebbero venire comunicate tramite la piattaforma BBM. L'utente non deve sviluppare queste funzionalità sociali da solo e non è necessario uno sviluppo sul lato server per supportarle.

Per ulteriori informazioni su BBM, vedere le Guide a BlackBerry Messenger Social Platform SDK per sviluppatori.

Ulteriori informazioni sulla messaggistica

Argomento successivo: API di connessione di rete
Argomento precedente: API PIM

Le informazioni sono state utili? Inviateci i vostri commenti.