Le chemin le plus rapide pour ajouter des capacités d'impression à votre application Android. En utilisant le mécanisme standard Share Intent d'Android, votre application peut offrir une fonctionnalité d'impression sans écrire une seule ligne de code spécifique à PrintHand. Lorsque les utilisateurs partagent du contenu imprimable depuis votre application, PrintHand apparaît automatiquement comme l'une des options de partage, tout comme les applications de messagerie ou de réseaux sociaux.

Cette approche est idéale pour les applications souhaitant fournir l'impression avec un effort de développement minimal. De nombreuses applications bien établies sans connexion directe avec PrintHand utilisent cette méthode pour permettre à leurs utilisateurs d'imprimer des documents, images et autres contenus. La beauté de cette intégration réside dans sa simplicité : si votre application implémente déjà la fonctionnalité de partage d'Android à d'autres fins, l'impression est gratuite.

Comment ça Fonctionne

Lorsqu'un utilisateur sélectionne "Partager" dans votre application et choisit PrintHand dans la liste des applications disponibles, Android transmet le contenu à PrintHand. PrintHand gère ensuite tout le flux de travail d'impression : rendu du contenu, affichage d'un aperçu, permettant à l'utilisateur de configurer les paramètres de l'imprimante et enfin envoi du travail à l'imprimante sélectionnée. Votre application initie simplement l'action de partage et PrintHand s'occupe de tout le reste.

Types de Contenu Supportés

• Images : JPEG, PNG, GIF et autres formats d'image standard
• Documents : Fichiers PDF et texte brut
• Contenu Web : URLs et contenu HTML
• Données Personnalisées : Tout contenu que votre application peut partager via les intents standard d'Android

Prérequis

Les utilisateurs doivent avoir l'application PrintHand installée sur leur appareil avec une licence valide pour imprimer. Votre application ne nécessite aucune permission spéciale ni dépendance, juste l'implémentation standard du Share Intent d'Android que la plupart des applications utilisent déjà.

Implémentation

Si votre application implémente déjà la fonctionnalité de partage d'Android, aucun code supplémentaire n'est nécessaire. Si ce n'est pas le cas, implémenter une action de partage de base est simple en utilisant les APIs standard ShareCompat ou Intent.ACTION_SEND d'Android. La documentation de PrintHand et le code d'exemple fournissent des exemples d'implémentation appropriée.

L'Intent API fournit un juste milieu puissant entre le partage sans code et l'intégration complète du SDK. Elle permet à votre application de découvrir les imprimantes de manière programmatique, configurer les options d'impression et initier les travaux d'impression, tout en conservant le contrôle de l'interface utilisateur et du flux de travail de votre application. C'est la méthode d'intégration la plus couramment utilisée pour les développeurs souhaitant un contrôle significatif sans la complexité des opérations d'impression de bas niveau.

Avec l'Intent API, vous pouvez créer des dialogues personnalisés de sélection d'imprimante, créer des préréglages de configuration d'impression et intégrer l'impression de manière transparente dans les flux de travail existants de votre application. Votre application communique avec PrintHand via une série d'intents bien définis qui gèrent la découverte d'imprimantes, la configuration d'options, le rendu de contenu et l'envoi de travaux. PrintHand traite ces demandes et renvoie les résultats à votre application, vous permettant de maintenir un contrôle complet sur l'expérience utilisateur.

Capacités Clés

• Découverte d'Imprimantes : Découvrez les imprimantes disponibles de manière programmatique via WiFi, Bluetooth et USB
• Configuration de Paramètres : Contrôlez le format papier, l'orientation, la qualité, le mode couleur et autres options spécifiques à l'imprimante
• Rendu de Contenu : Laissez PrintHand gérer le rendu complexe de documents ou envoyez du contenu pré-rendu
• Gestion des Travaux d'Impression : Initiez l'impression, surveillez l'état et gérez les résultats

Flux de Travail d'Intégration

Votre application envoie des intents au service Intent API de PrintHand pour effectuer des opérations spécifiques. Par exemple, pour imprimer un document, votre application : découvrirait les imprimantes disponibles et les présenterait dans votre interface utilisateur, permettrait à l'utilisateur de sélectionner une imprimante et configurer les options, enverrait un intent d'impression avec le contenu et les paramètres sélectionnés, et recevrait une confirmation une fois le travail d'impression terminé. Chaque étape utilise la communication Intent standard d'Android, rendant l'intégration simple pour les développeurs Android.

Cas d'Usage

L'Intent API est parfaite pour les applications avec du contenu complexe comme des documents de bureau, des cartes, des formulaires personnalisés ou des rapports nécessitant un rendu spécifique à l'application. Elle est également idéale lorsque vous souhaitez prérégler les options d'impression en fonction du type de document ou des préférences utilisateur, ou lorsque vous devez intégrer l'impression dans des flux de travail multi-étapes où les utilisateurs ne devraient pas quitter votre application.

Prérequis

Les utilisateurs ont besoin de l'application PrintHand installée avec une licence valide. Votre application doit inclure les déclarations du service Intent API de PrintHand dans son manifeste et implémenter le protocole de communication intent tel que documenté dans notre référence API et code d'exemple.

Le SDK de PrintHand fournit un accès direct de bas niveau à notre moteur d'impression, offrant flexibilité et contrôle maximums pour les applications sophistiquées. Contrairement à l'Intent API qui dépend des composants d'interface utilisateur de PrintHand, le SDK vous donne une liberté complète pour concevoir chaque aspect de l'expérience d'impression. Cette approche est idéale pour les applications d'entreprise, les solutions en marque blanche ou toute application nécessitant que l'impression se déroule de manière invisible en arrière-plan sans interaction utilisateur.

Avec le SDK, vous obtenez un contrôle granulaire sur chaque aspect du processus d'impression : détection et filtrage d'imprimantes, gestion et installation de pilotes, mise en file d'attente et priorisation des travaux d'impression, gestion personnalisée des erreurs et récupération. Votre application devient entièrement responsable de tout le flux de travail d'impression, de la présentation des options d'imprimante à l'utilisateur à la gestion de l'achèvement des travaux et des erreurs.

Capacités Avancées

• Contrôle Complet de l'Interface : Créez des interfaces personnalisées de découverte d'imprimantes, configuration et aperçu correspondant au design de votre application
• Impression en Arrière-Plan : Exécutez des travaux d'impression sans aucune interaction utilisateur ni composant d'interface
• Gestion de Pilotes : Téléchargez et gérez les pilotes d'imprimante de manière programmatique pour les appareils supportés
• Rendu Personnalisé : Contrôle complet sur la préparation du contenu et le pipeline de rendu
• Fonctionnalités Entreprise : Mise en file d'attente de travaux, impression par lots, sélection automatisée d'imprimantes et gestion personnalisée des erreurs

Complexité d'Implémentation

Le SDK nécessite une compréhension plus approfondie des concepts d'impression mobile et significativement plus d'efforts de développement que l'Intent API. Votre application doit fournir une interface utilisateur complète pour la découverte d'imprimantes, afficher les capacités et options de l'imprimante, gérer les téléchargements et l'installation de pilotes, gérer le cycle de vie des travaux d'impression, et implémenter la gestion des erreurs et la récupération. Cependant, cet effort est récompensé par une flexibilité et un contrôle inégalés.

Structure du SDK

Le SDK de PrintHand est fourni comme une bibliothèque Java qui s'intègre directement dans votre application Android. Il expose une API complète pour toutes les opérations d'impression, avec une documentation détaillée couvrant la gestion d'imprimantes, l'envoi de travaux, la surveillance de l'état et la gestion de configuration. Le SDK est conçu pour être thread-safe et efficace, adapté aux scénarios d'impression à haut volume.

Cas d'Usage

Parfait pour les applications d'entreprise nécessitant des flux de travail d'impression automatisés, les systèmes de point de vente nécessitant l'impression de reçus sans interaction utilisateur, les applications de logistique et livraison avec impression d'étiquettes à haut volume, et les solutions en marque blanche où la marque PrintHand ne devrait pas apparaître.

Prérequis

Les utilisateurs ont besoin soit de l'application PrintHand soit du service d'impression autonome PrintHand installé sur leur appareil avec une licence valide. Votre application doit inclure la bibliothèque SDK dans votre projet et nécessite une compréhension des protocoles de communication d'imprimantes et de l'architecture d'impression Android pour une implémentation optimale.

Code d'Exemple et Ressources

Pour vous aider à démarrer avec l'intégration de PrintHand, nous avons créé une application d'exemple complète démontrant les trois méthodes d'intégration. Le code d'exemple montre les meilleures pratiques pour implémenter chaque approche, gérer les cas limites et fournir une excellente expérience utilisateur.

Dépôt GitHub

Notre dépôt PrintingSample contient des exemples fonctionnels de Share Intent, Intent API et intégration avec SDK. Le code est bien documenté et démontre des modèles d'utilisation du monde réel. Visitez notre dépôt GitHub à :

github.com/DynamixSoftware/PrintingSample

Documentation

Une documentation détaillée de l'API, des guides d'intégration et des ressources de dépannage sont disponibles sur le wiki du dépôt. Nous mettons régulièrement à jour la documentation en fonction des retours des développeurs et des nouvelles versions d'Android.

Support

Pour des questions techniques, une assistance d'intégration ou pour signaler des problèmes, contactez notre équipe de support développeurs à support@printhand.com. Nous sommes là pour vous aider à intégrer PrintHand avec succès dans votre application.