APIs de integração de aplicativos

As APIs de integração de aplicativos contêm pacotes que podem ser usados para integrar seus aplicativos a aplicativos centrais, como os aplicativos Contatos, Telefone e Mídia.

API de chamada

É possível usar a API de chamada para chamar aplicativos centrais e, opcionalmente, transmitir dados. Para usar esta API, chame invokeApplication e transmita o tipo de aplicativo e os argumentos relevantes. É possível usar a API de chamada para chamar os seguintes aplicativos centrais:

  • contatos
  • calculadora
  • calendário
  • câmera
  • BlackBerry Maps
  • memorandos
  • mensagens
  • phone
  • pesquisar
  • tarefas

Chamada contém campos APP_TYPE que enumeram os aplicativos.

Para cada aplicativo central que pode ser chamado com a API de chamada, há uma subclasse correspondente da classe ApplicationArguments. Por exemplo, para chamar o aplicativo Telefone, chame invokeApplication e transmita o tipo de aplicativo Telefone e um argumento PhoneArguments. Para chamar um aplicativo sem nenhum argumento, transmita nullem vez de um ApplicationArguments objeto.

Content Handler API

Você pode usar o Content Handler API (CHAPI) para chamar aplicativos centrais e aplicativos de terceiros. O JSR 211 define o CHAPI como uma API opcional de Java® ME. Para obter mais informações sobre o CHAPI, consulte a visão geral do pacote javax.microedition.content.

Para usar o CHAPI para chamar aplicativos, forneça uma URL, um tipo de conteúdo ou um ID de conteúdo com um dos construtores na classe javax.microedition.content.Invocation. Quando você usa o CHAPI com os IDs de conteúdo fornecidos pela RIM para chamar os manipuladores de conteúdo da RIM®, o CHAPI pode ser uma boa maneira de definir parâmetros de chamada para aplicativos centrais, incluindo o aplicativo Mídia. É possível também usar o CHAPI para chamar aplicativos de terceiros registrados como manipuladores de conteúdo.

BlackBerry Browser

É possível chamar o BlackBerry Browser e abrir uma página da Web com os métodos na classe Browser e na classe BrowserSession.

Para obter mais informações sobre como chamar um navegador, incluindo como chamar um navegador que não é especificado como o navegador padrão, consulte o artigo do Knowledge Base Chamar o navegador.

É possível também integrar conteúdo da Web ao seu aplicativo com a classe BrowserField.

Gerenciador de aplicativo

Você pode iniciar um aplicativo central com a classe ApplicationManager, especificando o módulo de código do aplicativo. Use esta técnica apenas se o aplicativo não puder ser chamado com nenhuma das técnicas descritas acima. Não é possível transmitir argumentos de aplicativo a um aplicativo central com esta técnica. Você pode usar ApplicationManager para chamar os seguintes aplicativos centrais:

Aplicativo Nome do módulo
clock net_rim_bb_clock
sons net_rim_bb_profiles_aplicativo
BlackBerry Messenger net_rim_bb+_qm_peer
opções net_rim_bb_options_aplicativo
Nota: Os nomes de módulos para aplicativos centrais estão sujeitos a alterações. Chamar módulos diretamente pode ter efeitos colaterais não desejados.

Como habilitar aplicativos centrais para chamar seu aplicativo

É possível adicionar itens de menu a um aplicativo central com o pacote menuitem. Por exemplo, você pode adicionar um item de menu chamado Visualizar pedido de vendas ao aplicativo Contatos. Quando o usuário clica em Visualizar pedido de vendas, o aplicativo é aberto e exibe uma lista de pedidos de vendas para esse contato.

A classe ApplicationMenuItemRepository fornece as constantes que especificam o aplicativo central no qual aparece o item de menu. Por exemplo, a constante MENUITEM_MESSAGE_LIST especifica que o item de menu é exibido no aplicativo Mensagens. A constante MENUITEM_SYSTEM especifica que o item de menu é exibido na maioria dos aplicativos centrais.

Os aplicativos que usam o ActiveAutoTextEditField ou o campo ActiveRichTextField (por exemplo, os aplicativos Calendário e Mensagens) podem reconhecer padrões de sequência e fornecer itens específicos para esses padrões no menu no smartphone. Por exemplo, se uma mensagem contiver um número de telefone, o número será destacado. Se o usuário do smartphone selecionar o número e pressionar a tecla do Menu, o item de menu especial Chamar número será exibido.

Você pode definir seus próprios padrões de sequência e associar os padrões aos itens de menu personalizados. Os itens de menu personalizados são exibidos quando um usuário seleciona uma sequência correspondente em um campo ActiveAutoTextEditField ou ActiveRichTextField e abre o menu. Os itens de menu personalizados podem executar qualquer ação, tal como iniciar o aplicativo.

É possível usar a classe PatternRepository para registrar uma expressão regular estilo Perl ou uma sequência específica com o repositório padrão no smartphone. É possível usar a classe ApplicationMenuItem para definir um item de menu associado ao padrão da sequência.

Para obter mais informações sobre o PatternRepository e campos de texto ativos, consulte Aplicativos de amostra de Campos de texto ativos.

É possível registrar os manipuladores de conteúdo que chamam seu aplicativo usando a classe Registry, que é fornecida no Content Handler API. Quando registra um manipulador de conteúdo, você pode fornecer uma matriz para especificar as ações que chamam o manipulador. ContentHandler.ACTION_OPEN Os manipuladores de conteúdo para os tipos MIME que não são suportados pelo smartphone são usados no BlackBerry Browser, no explorador de arquivos e no item de menu Abrir anexo no aplicativo Mensagens. ContentHandler.ACTION_SEND Os manipuladores de conteúdo para os tipos MIME de imagem ou vídeo são usados no explorador de arquivos (incluindo o aplicativo Mídia) e no menu Enviar como no aplicativo Câmera.

Como integrar conteúdo em aplicativos BlackBerry

Você pode integrar conteúdo em aplicativos de várias maneiras, incluindo o seguinte:

  • Adicione aplicativos ao aplicativo Mensagens usando o pacote messagelist
  • Vincule contatos em seu aplicativo a contatos no aplicativo Contatos usando o pacote contactlinking
  • Adicione conteúdo às telas do telefone usando o pacote phonequi
  • Adicione opções para seu aplicativo usando o pacote options
  • Registre seu aplicativo como uma fonte de notificação usando o pacote notification

Como integrar componentes de UI em seu aplicativo

É possível incluir em seus aplicativos muitos componentes especializados de UI. Por exemplo, você pode implementar:

  • Campos de preenchimento automático usando o pacote component
  • Seletores de localização (que permitem que os usuários selecionem uma localização usando meios como contatos, GPS, localizações recentes e sugestões de seu aplicativo) usando o pacote picker na API LBS
  • Seletores de arquivos (que permitem que os usuários selecionem um arquivo de uma pasta) usando o pacote picker na API da UI
  • Mapas integrados usando a classe MapField
  • Conteúdo da Web integrado usando a classe BrowserField
  • Media players e gravadores de mídia integrados usando a API de Mídia Móvel (JSR 135), como implementado em javax.microedition.media e javax.microedition.media.control

Pesquisa unificada

O serviço de pesquisa unificada é um mecanismo de busca incluído no BlackBerry Device Software 6 e posterior. Você pode usar a API de pesquisa unificada (net.rim.device.unifiedsearch) para incluir dados do seu aplicativo no repositório de conteúdo do serviço de pesquisa unificada e pesquisar o índice de conteúdo em seu aplicativo.

Próximo tópico: APIs de PIM
Tópico anterior: API de UI

Estas informações foram úteis? Gostaríamos de receber seus comentários.