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:
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 |
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.
Estas informações foram úteis? Gostaríamos de receber seus comentários.