API d'intégration d'applications

Les API d'intégration d'applications contiennent des progiciels que vous pouvez utiliser pour intégrer vos applications aux applications de base, telles que l'application Contacts, l'application Téléphone et l'application Multimédia.

API d'appel

Vous pouvez utiliser l'API d'appel pour appeler des applications de base et, éventuellement, pour transmettre des données. Pour utiliser cette API, appelez invokeApplication et transmettez le type d'application et tout argument pertinent. Vous pouvez utiliser l'API d'appel pour appeler les applications de base suivantes :

  • contacts
  • calculatrice
  • calendrier
  • appareil photo
  • BlackBerry Maps
  • mémos
  • messages
  • téléphone
  • recherche
  • tâches

L'API d' appel contient des champs APP_TYPE qui énumèrent les applications.

Pour chaque application de base pouvant être appelée avec l'API d'appel, il existe une sous-classe correspondante de la classe ApplicationArguments. Par exemple, pour appeler l'application Téléphone, appelez invokeApplication et transmettez le type d'application Téléphone, ainsi qu'un argument PhoneArguments. Pour appeler une application sans argument, transmettez null et non un objet ApplicationArguments.

API de gestionnaire de contenu

Vous pouvez utiliser l'API de gestionnaire de contenu (CHAPI) pour appeler des applications principales et des applications tierces. JSR 211 définit CHAPI comme une API Java® ME facultative. Pour plus d'informations à propos de CHAPI, consultez la présentation du progiciel javax.microedition.content.

Pour utiliser CHAPI afin d'appeler des applications, indiquez une URL, un type de contenu ou un ID de contenu avec l'un des constructeurs de la classe javax.microedition.content.Invocation. Lorsque vous utilisez CHAPI avec des ID de contenu fournis par RIM pour appeler des gestionnaires de contenu RIM®, CHAPI peut constituer une bonne méthode de définition des paramètres d'appel pour les applications de base, y compris l'application Multimédia. Vous pouvez également utiliser CHAPI pour appeler des applications tierces enregistrées en tant que gestionnaires de contenu.

BlackBerry Browser

Vous pouvez appeler BlackBerry Browser et ouvrir une page Web avec les méthodes de la classe Browser et de la classe BrowserSession.

Pour plus d'informations à propos de l'appel d'un navigateur, y compris la méthode d'appel d'un navigateur différent du navigateur par défaut, consultez l'article de la base de connaissances Invoke the browser (Appeler le navigateur).

Vous pouvez également intégrer du contenu Web dans votre application avec la classe BrowserField.

Gestionnaire d'applications

Vous pouvez démarrer une application de base avec la classe ApplicationManager, en indiquant le module de code de l'application. Utilisez cette technique uniquement si l'application ne peut pas être appelée avec l'une des techniques évoquées précédemment. Vous ne pouvez pas transmettre d'argument d'application à une application de base avec cette technique. Vous pouvez utiliser ApplicationManager pour appeler les applications de base suivantes :

Application Nom du module
horloge net_rim_bb_clock
sons net_rim_bb_profiles_app
BlackBerry Messenger net_rim_bb+_qm_peer
options net_rim_bb_options_app
Remarque : Les noms de module des applications de base sont susceptibles d'être modifiés. Appeler les modules directement peut avoir des effets secondaires indésirables.

Activation des applications de base pour appeler votre application

Vous pouvez ajouter des éléments de menu à une application de base avec le progiciel menuitem. Par exemple, vous pouvez ajouter un élément de menu appelé Voir les commandes à l'application Contacts. Lorsque l'utilisateur clique sur Voir les commandes, votre application s'ouvre et affiche la liste des commandes de ce contact.

La classe ApplicationMenuItemRepository fournit les constantes déterminant l'application de base dans laquelle votre élément de menu apparaît. Par exemple, la constante MENUITEM_MESSAGE_LIST indique que l'élément de menu doit apparaître dans l'application Messages. La constante MENUITEM_SYSTEM indique que votre élément de menu s'affiche dans la plupart des applications de base.

Les applications qui utilisent le champ ActiveAutoTextEditField ou ActiveRichTextField (par exemple, les applications Calendrier et Messages) peuvent reconnaître des modèles de chaîne et fournir des éléments spécifiques pour ces modèles de chaîne dans le menu sur le smartphone. Par exemple, si un message contient un numéro de téléphone, ce numéro est mis en surbrillance. Si l'utilisateur de smartphone sélectionne le numéro et appuie sur la touche Menu, l'élément de menu spécial Appeler ce numéro s'affiche.

Vous pouvez définir vos propres modèles de chaîne et associer ces modèles à des éléments de menu personnalisés. Les éléments de menu personnalisés s'affichent lorsqu'un utilisateur sélectionne une chaîne correspondante dans un champ ActiveAutoTextEditField ou ActiveRichTextField et ouvre le menu. Les éléments de menu personnalisés peuvent exécuter tout type d'action, par exemple démarrer votre application.

Vous pouvez utiliser la classe PatternRepository pour enregistrer une expression régulière de type Perl ou une chaîne spécifique avec le référentiel de modèles sur le smartphone. Vous pouvez utiliser la classe ApplicationMenuItem pour définir un élément de menu associé au modèle de chaîne.

Pour plus d'informations à propos de la classe PatternRepository et des champs de texte actifs, consultez la rubrique Exemple d'application avec champs textuels actifs.

Vous pouvez enregistrer les gestionnaires de contenu qui appellent votre application avec la classe Registry fournie dans l'API de gestionnaire de contenu. Lorsque vous enregistrez un gestionnaire de contenu, vous pouvez fournir un tableau afin d'indiquer les actions appelant le gestionnaire.Des gestionnaires de contenu ContentHandler.ACTION_OPEN pour les types MIME non pris en charge par le smartphone sont utilisés dans BlackBerry Browser, dans l'explorateur de fichiers et dans l'option de menu Ouvrir la pièce jointe de l'application Messages.Des gestionnaires de contenu ContentHandler.ACTION_SEND pour les types MIME image et vidéo sont utilisés dans l'explorateur de fichiers (y compris dans l'application Multimédia) et dans l'élément de menu Envoyer en tant que de l'application Appareil photo.

Intégration de contenu dans des applications BlackBerry

Vous pouvez intégrer du contenu dans des applications de plusieurs façons, notamment :

  • Ajoutez des applications à l'application Messages à l'aide du progiciel messagelist.
  • Liez des contacts de votre application avec des contacts de l'application Contacts à l'aide du progiciel contactlinking.
  • Ajoutez du contenu à l'écran du téléphone à l'aide du progiciel phonequi.
  • Ajoutez des options à votre application à l'aide du progiciel options.
  • Enregistrez votre application en tant que source de notifications à l'aide du progiciel notification.

Intégration de composants de l'interface utilisateur dans votre application

Vous pouvez inclure dans vos applications de nombreux composants spécifiques de l'interface utilisateur. Par exemple, vous pouvez déployer les éléments suivants :

  • Des champs à remplissage automatique à l'aide du progiciel component.
  • Des sélecteurs de position (qui permettent aux utilisateurs de sélectionner une position à l'aide par exemple des contacts, positions récentes, du GPS et des suggestions de votre application) à l'aide du progiciel picker de l'API de services géodépendants.
  • Des sélecteurs de fichier (qui permettent aux utilisateurs de sélectionner un fichier dans un dossier) à l'aide du progiciel picker dans l'API d'interface utilisateur.
  • Des cartes intégrées à l'aide de la classe MapField.
  • Du contenu Web intégré à l'aide de la classe BrowserField.
  • Des lecteurs multimédias et des enregistreurs multimédias intégrés à l'aide de l'API Média mobile (JSR 135), comme déployés dans les progiciels javax.microedition.media et javax.microedition.media.control.

Recherche unifiée

Le service de recherche unifiée est un moteur de recherche inclus dans BlackBerry Device Software 6 et versions ultérieures. Vous pouvez utiliser l'API de recherche unifiée (net.rim.device.unifiedsearc) pour inclure vos données d'application dans le référentiel de contenu du service de recherche unifiée et chercher l'index de contenu depuis votre application.

Sujet précédent: API d'interface utilisateur

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