API de messagerie

Les API de messagerie vous permettent d'utiliser les fonctionnalités de messagerie dans vos applications, y compris les e-mails, les messages d'application, SMS, MMS et BlackBerry® Messenger.

E-mails

Les progiciels pour les e-mails sont net.rim.blackberry.api.mail et net.rim.blackberry.api.mail.event.

Pour configurer votre application en vue de créer et d'envoyer des e-mails, définissez l'objet Session par défaut, récupérez une instance Store, créez l'e-mail et stockez-le dans un dossier d'éléments envoyés récupéré. Pour finir, configurez et envoyez l'e-mail.

Chaque terminal BlackBerry dispose d'un code PIN unique et prend en charge la messagerie PIN à PIN depuis l'application Messages. Pour configurer votre application en vue de créer et d'envoyer des messages PIN, définissez l'objet Session par défaut, récupérez une instance Store, créez l'adresse PIN de destination et stockez le message PIN dans un dossier d'éléments envoyés récupéré. Pour finir, configurez et envoyez le message PIN.

Pour envoyer un e-mail avec pièce jointe, créez l'objet Multipart, créez et ajoutez le fichier à joindre à cet objet, composez et envoyez l'e-mail. Pour télécharger automatiquement les pièces jointes aux e-mails en 'arrière-plan lorsque les messages arrivent dans la liste des messages, utilisez l'interface DownloadProgressListener et la classe AttachmentDownloadManager.

Messages d'application

Un objet ApplicationMessage est un message personnalisé qui apparaît dans l'application Messages et appelle votre application lorsque l'utilisateur l'ouvre ou choisit un élément de menu que vous fournissez pour le message. Utilisez le progiciel messagelist pour créer des messages d'application.

Messages SMS et MMS

Vous pouvez créer des applications qui envoient et reçoivent des messages SMS ou MMS. La prise en charge SMS est fournie par JSR 120. La prise en charge MMS est fournie par JSR 205. Vous pouvez effectuer l'une des actions suivantes :

  • Envoyer et recevoir des messages SMS
  • Envoyer et recevoir des messages MMS
  • Configurer des écouteurs pour les messages sortants et envoyés

Vous pouvez envoyer des messages SMS avec l'API javax.wireless.messaging et l'API d'appel BlackBerry®. Vous ne pouvez pas envoyer de messages SMS directement depuis un smartphone BlackBerry fonctionnant sur un réseau CDMA.

Pour recevoir des messages SMS avec BlackBerry Java SDK 4.6.0 ou version ultérieure, utilisez l'interface MessageListener. Si vous utilisez une version précédente du SDK, utilisez l'interface MessageConnection.

Si vous souhaitez que certains SMS soient enregistrés dans un dossier de messages SMS, vous devez indiquer l'emplacement du dossier avec l'argument MessageArguments lors de la réception du SMS sur le smartphone BlackBerry. Les applications ne peuvent pas accéder aux SMS stockés sur le smartphone BlackBerry.

Pour écouter les messages SMS entrants apparaissant dans la liste des messages, définissez l'argument du numéro de port dans Connector.open() sur 0 - Connector.open("sms://:0").

Les MMS se composent d'un en-tête MMS et d'un corps. L'en-tête MMS comprend l'adresse, la priorité, l'objet et les informations de remise. Le corps du MMS contient la pièce jointe multimédia.

Pour recevoir des messages MMS avec BlackBerry Java SDK 4.6.0 ou version ultérieure, utilisez l'interface MessageListener. Si vous utilisez une version précédente de BlackBerry JDE, utilisez l'interface MessageConnection.

L'envoi de messages MMS est similaire à celui de messages SMS. Toutefois, vous devez transmettre la constante MULTIPART_MESSAGE lors de la création de l'objet MessageConnection. Pour écouter les messages MMS entrants apparaissant dans la liste des messages, définissez l'ID de l'application sélectionnée Connector.open() sur 0.

En plus de fournir des notifications aux applications lorsque des messages sont reçus (à l'aide de l'interface MessageListener), vous pouvez également configurer la notification d'applications pour les messages SMS et MMS sortants et envoyés. Dans le cas des messages SMS, vous pouvez configurer votre application pour qu'elle suive les messages SMS envoyés en transmettant une instance d'une classe déployant l'interface OutboundMessageListener en appelant MessageConnection.setMessageListener(). La notification par le biais de cette interface a lieu uniquement après que le message a été bien envoyé. Si l'envoi échoue, l'application n'est pas notifiée.

BlackBerry Messenger

BBM est un programme de messagerie instantanée qui permet aux utilisateurs de smartphones BlackBerry de communiquer sans connexion ni déconnexion. Il suffit aux smartphones d'être connectés à un réseau sans fil pour que BBM maintienne les utilisateurs connectés à leurs contacts et groupes BBM.

BlackBerry Messenger SDK est un téléchargement distinct de BlackBerry Java SDK. BBM SDK, utilisé conjointement avec BlackBerry Java SDK, vous permet de développer des applications qui incorporent des fonctions sociales, de type connexions poste à poste entre les smartphones BlackBerry, avec chat intégré. Par exemple, dans une application de jeu d'échecs, un utilisateur de smartphone BlackBerry peut inviter un contact BBM à jouer aux échecs et les déplacements peuvent être communiqués à double sens sur la plate-forme BBM. Vous n'avez plus besoin de développer ces fonctions sociales et aucun développement côté serveur n'est requis pour les prendre en charge.

Pour plus d'informations à propos de BBM, reportez-vous aux documents BlackBerry Messenger Social Platform SDK developer guides (BlackBerry Messenger Social Platform SDK - Guides développeur).


Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.