O caminho mais rápido para adicionar capacidades de impressão ao seu aplicativo Android. Ao utilizar o mecanismo padrão de Share Intent do Android, seu aplicativo pode oferecer funcionalidade de impressão sem escrever uma única linha de código específico do PrintHand. Quando os usuários compartilham conteúdo adequado para impressão do seu aplicativo, o PrintHand aparece automaticamente como uma das opções de compartilhamento, assim como aplicativos de e-mail ou redes sociais.

Esta abordagem é ideal para aplicativos que desejam fornecer impressão com um esforço mínimo de desenvolvimento. Muitos aplicativos bem estabelecidos sem conexão direta com o PrintHand usam este método para permitir que seus usuários imprimam documentos, imagens e outros conteúdos. A beleza desta integração é sua simplicidade: se seu aplicativo já implementa a funcionalidade de compartilhamento do Android para outros propósitos, a impressão vem de graça.

Como Funciona

Quando um usuário seleciona "Compartilhar" no seu aplicativo e escolhe o PrintHand da lista de aplicativos disponíveis, o Android passa o conteúdo para o PrintHand. O PrintHand então cuida de todo o fluxo de trabalho de impressão: renderizar o conteúdo, mostrar uma pré-visualização, permitir que o usuário configure as configurações da impressora e finalmente enviar o trabalho para a impressora selecionada. Seu aplicativo simplesmente inicia a ação de compartilhamento e o PrintHand cuida de todo o resto.

Tipos de Conteúdo Suportados

• Imagens: JPEG, PNG, GIF e outros formatos de imagem padrão
• Documentos: Arquivos PDF e texto simples
• Conteúdo Web: URLs e conteúdo HTML
• Dados Personalizados: Qualquer conteúdo que seu aplicativo possa compartilhar através de intents padrão do Android

Requisitos

Os usuários devem ter o aplicativo PrintHand instalado em seu dispositivo com uma licença válida para imprimir. Seu aplicativo não requer permissões especiais ou dependências, apenas a implementação padrão de Share Intent do Android que a maioria dos aplicativos já usa.

Implementação

Se seu aplicativo já implementa a funcionalidade de compartilhamento do Android, nenhum código adicional é necessário. Se não, implementar uma ação básica de compartilhamento é simples usando as APIs padrão ShareCompat ou Intent.ACTION_SEND do Android. A documentação do PrintHand e o código de exemplo fornecem exemplos de implementação adequada.

A Intent API fornece um ponto médio poderoso entre o compartilhamento sem código e a integração completa do SDK. Permite que seu aplicativo descubra impressoras programaticamente, configure opções de impressão e inicie trabalhos de impressão, tudo mantendo o controle sobre a interface de usuário e o fluxo de trabalho do seu aplicativo. Este é o método de integração mais comumente usado para desenvolvedores que desejam controle significativo sem a complexidade de operações de impressão de baixo nível.

Com a Intent API, você pode criar diálogos personalizados de seleção de impressoras, criar configurações de impressão predefinidas e integrar a impressão perfeitamente nos fluxos de trabalho existentes do seu aplicativo. Seu aplicativo se comunica com o PrintHand através de uma série de intents bem definidos que lidam com descoberta de impressoras, configuração de opções, renderização de conteúdo e envio de trabalhos. O PrintHand processa essas solicitações e retorna resultados ao seu aplicativo, permitindo que você mantenha controle completo sobre a experiência do usuário.

Capacidades Principais

• Descoberta de Impressoras: Descubra impressoras disponíveis programaticamente via WiFi, Bluetooth e USB
• Configuração de Ajustes: Controle o tamanho de papel, orientação, qualidade, modo de cor e outras opções específicas da impressora
• Renderização de Conteúdo: Deixe o PrintHand lidar com a renderização complexa de documentos ou envie conteúdo pré-renderizado
• Gestão de Trabalhos de Impressão: Inicie a impressão, monitore o status e lide com os resultados

Fluxo de Trabalho de Integração

Seu aplicativo envia intents ao serviço de Intent API do PrintHand para realizar operações específicas. Por exemplo, para imprimir um documento, seu aplicativo: descobriria as impressoras disponíveis e as apresentaria em sua UI, permitiria ao usuário selecionar uma impressora e configurar opções, enviaria um intent de impressão com o conteúdo e configurações selecionadas, e receberia confirmação quando o trabalho de impressão fosse concluído. Cada etapa utiliza comunicação padrão de Intent do Android, tornando a integração direta para desenvolvedores Android.

Casos de Uso

A Intent API é perfeita para aplicativos com conteúdo complexo como documentos de escritório, mapas, formulários personalizados ou relatórios que requerem renderização específica do aplicativo. Também é ideal quando você deseja predefinir opções de impressão com base no tipo de documento ou preferências do usuário, ou quando precisa integrar a impressão em fluxos de trabalho de múltiplas etapas onde os usuários não devem sair do seu aplicativo.

Requisitos

Os usuários precisam do aplicativo PrintHand instalado com uma licença válida. Seu aplicativo deve incluir as declarações do serviço Intent API do PrintHand em seu manifesto e implementar o protocolo de comunicação intent conforme documentado em nossa referência de API e código de exemplo.

O SDK do PrintHand fornece acesso direto de baixo nível ao nosso motor de impressão, oferecendo máxima flexibilidade e controle para aplicativos sofisticados. Diferentemente da Intent API, que depende dos componentes de UI do PrintHand, o SDK lhe dá liberdade completa para projetar cada aspecto da experiência de impressão. Esta abordagem é ideal para aplicativos empresariais, soluções de marca branca ou qualquer aplicativo que exija que a impressão ocorra de forma invisível em segundo plano sem interação do usuário.

Com o SDK, você obtém controle granular sobre cada aspecto do processo de impressão: detecção e filtragem de impressoras, gestão e instalação de drivers, enfileiramento e priorização de trabalhos de impressão, tratamento personalizado de erros e recuperação. Seu aplicativo se torna completamente responsável por todo o fluxo de trabalho de impressão, desde apresentar opções de impressora ao usuário até lidar com a conclusão de trabalhos e erros.

Capacidades Avançadas

• Controle Completo de UI: Construa interfaces personalizadas de descoberta de impressoras, configuração e pré-visualização que correspondam ao design do seu aplicativo
• Impressão em Segundo Plano: Execute trabalhos de impressão sem nenhuma interação do usuário ou componentes de UI
• Gestão de Drivers: Baixe e gerencie drivers de impressora programaticamente para dispositivos suportados
• Renderização Personalizada: Controle completo sobre a preparação de conteúdo e o pipeline de renderização
• Funções Empresariais: Enfileiramento de trabalhos, impressão em lote, seleção automatizada de impressoras e tratamento personalizado de erros

Complexidade de Implementação

O SDK requer uma compreensão mais profunda de conceitos de impressão móvel e significativamente mais esforço de desenvolvimento do que a Intent API. Seu aplicativo deve fornecer UI completa para descoberta de impressoras, mostrar capacidades e opções da impressora, lidar com downloads e instalação de drivers, gerenciar o ciclo de vida de trabalhos de impressão, e implementar tratamento de erros e recuperação. No entanto, este esforço é recompensado com flexibilidade e controle incomparáveis.

Estrutura do SDK

O SDK do PrintHand é fornecido como uma biblioteca Java que se integra diretamente ao seu aplicativo Android. Expõe uma API completa para todas as operações de impressão, com documentação detalhada cobrindo gestão de impressoras, envio de trabalhos, monitoramento de status e gestão de configuração. O SDK é projetado para ser thread-safe e eficiente, adequado para cenários de impressão de alto volume.

Casos de Uso

Perfeito para aplicativos empresariais que exigem fluxos de trabalho de impressão automatizados, sistemas de ponto de venda que precisam de impressão de recibos sem interação do usuário, aplicativos de logística e entrega com impressão de etiquetas de alto volume, e soluções de marca branca onde a marca PrintHand não deveria aparecer.

Requisitos

Os usuários precisam do aplicativo PrintHand ou do serviço de impressão independente PrintHand instalado em seu dispositivo com uma licença válida. Seu aplicativo deve incluir a biblioteca SDK em seu projeto e requer compreensão de protocolos de comunicação de impressoras e arquitetura de impressão do Android para implementação ideal.

Código de Exemplo e Recursos

Para ajudá-lo a começar com a integração do PrintHand, criamos um aplicativo de exemplo completo que demonstra os três métodos de integração. O código de exemplo mostra as melhores práticas para implementar cada abordagem, lidar com casos extremos e fornecer uma ótima experiência de usuário.

Repositório GitHub

Nosso repositório PrintingSample contém exemplos funcionais de Share Intent, Intent API e integração com SDK. O código está bem documentado e demonstra padrões de uso do mundo real. Visite nosso repositório GitHub em:

github.com/DynamixSoftware/PrintingSample

Documentação

Documentação detalhada da API, guias de integração e recursos de solução de problemas estão disponíveis na wiki do repositório. Atualizamos regularmente a documentação com base nos comentários dos desenvolvedores e novas versões do Android.

Suporte

Para perguntas técnicas, assistência de integração ou para relatar problemas, entre em contato com nossa equipe de suporte para desenvolvedores em support@printhand.com. Estamos aqui para ajudá-lo a integrar o PrintHand com sucesso em seu aplicativo.