El camino más rápido para agregar capacidades de impresión a su aplicación Android. Al utilizar el mecanismo estándar de Share Intent de Android, su aplicación puede ofrecer funcionalidad de impresión sin escribir una sola línea de código específico de PrintHand. Cuando los usuarios comparten contenido adecuado para imprimir desde su aplicación, PrintHand aparece automáticamente como una de las opciones de compartir, al igual que las aplicaciones de correo electrónico o redes sociales.

Este enfoque es ideal para aplicaciones que desean proporcionar impresión con un esfuerzo de desarrollo mínimo. Muchas aplicaciones bien establecidas sin conexión directa con PrintHand utilizan este método para permitir a sus usuarios imprimir documentos, imágenes y otro contenido. La belleza de esta integración es su simplicidad: si su aplicación ya implementa la funcionalidad de compartir de Android para otros propósitos, la impresión viene gratis.

Cómo Funciona

Cuando un usuario selecciona "Compartir" en su aplicación y elige PrintHand de la lista de aplicaciones disponibles, Android pasa el contenido a PrintHand. PrintHand luego se encarga de todo el flujo de trabajo de impresión: renderizar el contenido, mostrar una vista previa, permitir al usuario configurar los ajustes de la impresora y finalmente enviar el trabajo a la impresora seleccionada. Su aplicación simplemente inicia la acción de compartir y PrintHand se encarga de todo lo demás.

Tipos de Contenido Compatibles

• Imágenes: JPEG, PNG, GIF y otros formatos de imagen estándar
• Documentos: Archivos PDF y texto plano
• Contenido Web: URLs y contenido HTML
• Datos Personalizados: Cualquier contenido que su aplicación pueda compartir a través de intents estándar de Android

Requisitos

Los usuarios deben tener la aplicación PrintHand instalada en su dispositivo con una licencia válida para imprimir. Su aplicación no requiere permisos especiales ni dependencias, solo la implementación estándar de Share Intent de Android que la mayoría de las aplicaciones ya usan.

Implementación

Si su aplicación ya implementa la funcionalidad de compartir de Android, no se necesita código adicional. Si no, implementar una acción básica de compartir es sencillo usando las APIs estándar ShareCompat o Intent.ACTION_SEND de Android. La documentación de PrintHand y el código de ejemplo proporcionan ejemplos de implementación adecuada.

La Intent API proporciona un punto medio poderoso entre el compartir sin código y la integración completa del SDK. Permite que su aplicación descubra impresoras de forma programática, configure opciones de impresión e inicie trabajos de impresión, todo mientras mantiene el control sobre la interfaz de usuario y el flujo de trabajo de su aplicación. Este es el método de integración más comúnmente usado para desarrolladores que desean un control significativo sin la complejidad de operaciones de impresión de bajo nivel.

Con la Intent API, puede crear diálogos personalizados de selección de impresoras, crear configuraciones de impresión preestablecidas e integrar la impresión sin problemas en los flujos de trabajo existentes de su aplicación. Su aplicación se comunica con PrintHand a través de una serie de intents bien definidos que manejan el descubrimiento de impresoras, configuración de opciones, renderizado de contenido y envío de trabajos. PrintHand procesa estas solicitudes y devuelve resultados a su aplicación, permitiéndole mantener el control completo sobre la experiencia del usuario.

Capacidades Clave

• Descubrimiento de Impresoras: Descubra impresoras disponibles de forma programática vía WiFi, Bluetooth y USB
• Configuración de Ajustes: Controle el tamaño de papel, orientación, calidad, modo de color y otras opciones específicas de la impresora
• Renderizado de Contenido: Deje que PrintHand maneje el renderizado complejo de documentos o envíe contenido pre-renderizado
• Gestión de Trabajos de Impresión: Inicie la impresión, monitoree el estado y maneje los resultados

Flujo de Trabajo de Integración

Su aplicación envía intents al servicio de Intent API de PrintHand para realizar operaciones específicas. Por ejemplo, para imprimir un documento, su aplicación: descubriría las impresoras disponibles y las presentaría en su UI, permitiría al usuario seleccionar una impresora y configurar opciones, enviaría un intent de impresión con el contenido y configuraciones seleccionadas, y recibiría confirmación cuando se complete el trabajo de impresión. Cada paso utiliza comunicación estándar de Intent de Android, haciendo que la integración sea directa para los desarrolladores de Android.

Casos de Uso

La Intent API es perfecta para aplicaciones con contenido complejo como documentos de oficina, mapas, formularios personalizados o informes que requieren renderizado específico de la aplicación. También es ideal cuando desea preestablecer opciones de impresión según el tipo de documento o preferencias del usuario, o cuando necesita integrar la impresión en flujos de trabajo de múltiples pasos donde los usuarios no deberían salir de su aplicación.

Requisitos

Los usuarios necesitan la aplicación PrintHand instalada con una licencia válida. Su aplicación debe incluir las declaraciones del servicio Intent API de PrintHand en su manifiesto e implementar el protocolo de comunicación intent como se documenta en nuestra referencia de API y código de ejemplo.

El SDK de PrintHand proporciona acceso directo de bajo nivel a nuestro motor de impresión, ofreciendo máxima flexibilidad y control para aplicaciones sofisticadas. A diferencia de la Intent API, que depende de los componentes de UI de PrintHand, el SDK le da libertad completa para diseñar cada aspecto de la experiencia de impresión. Este enfoque es ideal para aplicaciones empresariales, soluciones de marca blanca o cualquier aplicación que requiera que la impresión ocurra de forma invisible en segundo plano sin interacción del usuario.

Con el SDK, obtiene control granular sobre cada aspecto del proceso de impresión: detección y filtrado de impresoras, gestión e instalación de controladores, encolado y priorización de trabajos de impresión, manejo personalizado de errores y recuperación. Su aplicación se vuelve completamente responsable de todo el flujo de trabajo de impresión, desde presentar opciones de impresora al usuario hasta manejar la finalización de trabajos y errores.

Capacidades Avanzadas

• Control Completo de UI: Construya interfaces personalizadas de descubrimiento de impresoras, configuración y vista previa que coincidan con el diseño de su aplicación
• Impresión en Segundo Plano: Ejecute trabajos de impresión sin ninguna interacción del usuario o componentes de UI
• Gestión de Controladores: Descargue y gestione controladores de impresora de forma programática para dispositivos compatibles
• Renderizado Personalizado: Control completo sobre la preparación de contenido y el pipeline de renderizado
• Funciones Empresariales: Encolado de trabajos, impresión por lotes, selección automatizada de impresoras y manejo personalizado de errores

Complejidad de Implementación

El SDK requiere una comprensión más profunda de los conceptos de impresión móvil y significativamente más esfuerzo de desarrollo que la Intent API. Su aplicación debe proporcionar UI completa para el descubrimiento de impresoras, mostrar capacidades y opciones de la impresora, manejar descargas e instalación de controladores, gestionar el ciclo de vida de trabajos de impresión, e implementar manejo de errores y recuperación. Sin embargo, este esfuerzo se ve recompensado con flexibilidad y control sin igual.

Estructura del SDK

El SDK de PrintHand se proporciona como una biblioteca Java que se integra directamente en su aplicación Android. Expone una API completa para todas las operaciones de impresión, con documentación detallada que cubre gestión de impresoras, envío de trabajos, monitoreo de estado y gestión de configuración. El SDK está diseñado para ser thread-safe y eficiente, adecuado para escenarios de impresión de alto volumen.

Casos de Uso

Perfecto para aplicaciones empresariales que requieren flujos de trabajo de impresión automatizados, sistemas de punto de venta que necesitan impresión de recibos sin interacción del usuario, aplicaciones de logística y entrega con impresión de etiquetas de alto volumen, y soluciones de marca blanca donde la marca PrintHand no debería aparecer.

Requisitos

Los usuarios necesitan ya sea la aplicación PrintHand o el servicio de impresión independiente PrintHand instalado en su dispositivo con una licencia válida. Su aplicación debe incluir la biblioteca SDK en su proyecto y requiere comprensión de protocolos de comunicación de impresoras y arquitectura de impresión de Android para una implementación óptima.

Código de Ejemplo y Recursos

Para ayudarlo a comenzar con la integración de PrintHand, hemos creado una aplicación de ejemplo completa que demuestra los tres métodos de integración. El código de ejemplo muestra las mejores prácticas para implementar cada enfoque, manejar casos extremos y proporcionar una gran experiencia de usuario.

Repositorio GitHub

Nuestro repositorio PrintingSample contiene ejemplos funcionales de Share Intent, Intent API e integración con SDK. El código está bien documentado y demuestra patrones de uso del mundo real. Visite nuestro repositorio GitHub en:

github.com/DynamixSoftware/PrintingSample

Documentación

Documentación detallada de la API, guías de integración y recursos de solución de problemas están disponibles en la wiki del repositorio. Actualizamos regularmente la documentación basándonos en los comentarios de los desarrolladores y nuevas versiones de Android.

Soporte

Para preguntas técnicas, asistencia de integración o para informar problemas, contacte a nuestro equipo de soporte para desarrolladores en support@printhand.com. Estamos aquí para ayudarlo a integrar PrintHand con éxito en su aplicación.