API de integración de aplicaciones

Las API de integración de aplicaciones contienen paquetes que puede utilizar para integrar sus aplicaciones con aplicaciones principales como la aplicación Contactos, Teléfono y Multimedia.

API Invoke

Puede utilizar la API Invoke para invocar aplicaciones principales y pasar opcionalmente los datos. Para utilizar esta API, llame a invokeApplication y pase el tipo de aplicación y el argumento correspondiente. Puede utilizar la API Invoke para invocar las siguientes aplicaciones principales:

  • contactos
  • calculadora
  • calendario
  • cámara
  • BlackBerry Maps
  • notas
  • mensajes
  • teléfono
  • búsqueda
  • tareas

Invoke contiene campos APP_TYPE que enumeran las aplicaciones.

Para cada aplicación principal que pueda ser invocada con la API Invoke, hay una subclase correspondiente de la clase ApplicationArguments. Por ejemplo, para invocar la aplicación Teléfono, llame a invokeApplication y pase el tipo de aplicación Teléfono y un argumento PhoneArguments. Para invocar una aplicación sin argumentos, pase null en lugar de un objeto ApplicationArguments.

API Content Handler

Puede utilizar la API Content Handler (CHAPI) para invocar tanto aplicaciones principales como de terceros. JSR 211 define CHAPI como una API opcional de Java® ME. Para obtener más información acerca de CHAPI, consulte la descripción general del paquete javax.microedition.content.

Para utilizar CHAPI para invocar aplicaciones, proporcione una URL, un tipo de contenido, o un ID de contenido con uno de los constructores en la clase javax.microedition.content.Invocation. Cuando se utiliza CHAPI con los ID de contenido proporcionados por RIM para invocar controladores de contenido de RIM®, CHAPI puede suponer una buena forma de configuración de parámetros de invocación para aplicaciones principales, incluida la aplicación Multimedia. También puede utilizar CHAPI para invocar aplicaciones de terceros que se registren como controladores de contenido.

BlackBerry Browser

Puede invocar BlackBerry Browser y abrir una página Web con los métodos en la clase Browser y la clase BrowserSession.

Para obtener más información acerca de cómo invocar la clase Browser, además de cómo invocar una clase Browser no especificada navegador predeterminado, consulte el artículo de la Base de conocimientos Invocar Browser.

También puede incrustar contenido Web en su aplicación con la clase BrowserField.

Administrador de aplicaciones

Puede iniciar una aplicación principal con la clase ApplicationManager, especificando el módulo de código de la aplicación. Utilice esta técnica sólo si la aplicación no se puede invocar con cualquiera de las técnicas descritas anteriormente. No puede pasar los argumentos de la aplicación a una aplicación principal con esta técnica. Puede utilizar ApplicationManager para invocar las siguientes aplicaciones principales:

Aplicación Nombre del módulo
reloj net_rim_bb_clock
sonidos net_rim_bb_profiles_app
BlackBerry Messenger net_rim_bb+_qm_peer
opciones net_rim_bb_options_app
Nota: Los nombres de los módulos de las aplicaciones principales están sujetos a cambios. La invocación directa de módulos pueden tener efectos secundarios involuntarios.

Activar aplicaciones principales para invocar su aplicación

Puede agregar elementos de menú a una aplicación principal con el paquete menuitem. Por ejemplo, puede añadir un elemento de menú denominado "Ver pedido de ventas" a la aplicación Contactos. Cuando el usuario haga clic en Ver pedido de ventas, la aplicación se abre y muestra una lista de pedidos de ventas para ese contacto.

La clase ApplicationMenuItemRepository proporciona las constantes que especifican la aplicación principal en la que aparece su elemento de menú. Por ejemplo, la constante MENUITEM_MESSAGE_LIST especifica que el elemento de menú debe aparecer en la aplicación Mensajes. La constante MENUITEM_SYSTEM especifica que su elemento de menú aparece en la mayoría de las aplicaciones principales.

Las aplicaciones que utilizan ActiveAutoTextEditField o el campo ActiveRichTextField (por ejemplo, las aplicaciones Calendario y Mensajes) pueden reconocer que los patrones de cadena y proporcionar elementos específicos para esos patrones de cadena en el menú del smartphone. Por ejemplo, si un mensaje contiene un número de teléfono, el número se selecciona. Si el usuario del smartphone selecciona el número y pulsa la tecla Menú, se muestra el elemento especial del menú Llamar a número.

Puede definir sus propios patrones de cadena y asociar los patrones con elementos de menú personalizados. Los elementos de menú personalizados se muestran cuando un usuario selecciona una cadena coincidente en un campo ActiveAutoTextEditField o ActiveRichTextField y abre el menú. Los elementos de menú personalizados pueden llevar a cabo cualquier acción, por ejemplo, iniciar su aplicación.

Puede utilizar la clase PatternRepository para registrar una expresión regular Perl-style o una cadena específica con el repositorio de patrones en el smartphone. Puede utilizar la clase ApplicationMenuItem para definir un elemento de menú que esté asociado al patrón de cadena.

Para obtener más información acerca del repositorio de patrones y los campos de texto activos, consulte la aplicación de ejemplo Campos de texto activos.

Puede registrar los controladores de contenido que invocan su aplicación mediante la clase Registry, proporcionada en la API Content Handler. Al registrar el controlador de contenido, puede proporcionar una matriz para especificar las acciones que invocan al controlador. ContentHandler.ACTION_OPENLos controladores de contenido para los tipos MIME que no son compatibles con el smartphone se utilizan en BlackBerry Browser, el navegador de archivos y el elemento de menú Abrir archivo adjunto en la aplicación Mensajes. ContentHandler.ACTION_SENDLos controladores de contenido para los tipos MIME de imagen o vídeo se utilizan en el navegador de archivos (incluida la aplicación Multimedia) y en el menú Enviar como en la aplicación Cámara.

Incrustar contenido en aplicaciones BlackBerry

Puede incrustar contenido en aplicaciones de varias formas, incluidas las siguientes:

  • Agregar aplicaciones a la aplicación Mensajes mediante el paquete messagelist
  • Vincular contactos en su aplicación con los contactos de la aplicación Contactos mediante el paquete contactlinking
  • Agregar contenido a las pantallas del teléfono mediante el paquete phonequi
  • Agregar opciones para su aplicación mediante el paquete options
  • Registrar su aplicación como una fuente de notificación mediante el paquete notification

Incrustar componentes de la interfaz de usuario en su aplicación

Puede incluir en sus aplicaciones numerosos componentes especializados de la interfaz de usuario. Por ejemplo, puede implementar:

  • Campos con la función Autocompletar mediante el paquete component
  • Colectores de ubicación (que permite a los usuarios seleccionar una ubicación a través de los contactos, GPS, ubicaciones recientes y sugerencias de la aplicación) que utilizan el paquete picker en la API LBS
  • Colectores de archivos (que permiten a los usuarios seleccionar un archivo en una carpeta) a través del paquete picker en la API de la interfaz de usuario (IU)
  • Mapas incrustados que utilizan la clase MapField
  • Contenido Web incrustado que utiliza la clase BrowserField
  • Reproductores multimedia incrustados y grabadoras multimedia que utilizan la API Mobile Media (JSR 135), tal como implementan javax.microedition.media y javax.microedition.media.control

Búsqueda unificada

El Servicio de búsqueda unificada es un motor de búsqueda que se incluye con BlackBerry Device Software 6 o posterior. Puede utilizar la API de búsqueda unificada (net.rim.device.unifiedsearch) para incluir sus datos de aplicaciones en el repositorio del servicio de búsqueda unificada y buscar en el índice de contenidos desde su aplicación.

Tema siguiente: API de la gestión PIM

¿Le ha resultado útil esta información? Envíenos sus comentarios.