Η ταχύτερη διαδρομή για να προσθέσετε δυνατότητες εκτύπωσης στην εφαρμογή σας Android. Χρησιμοποιώντας τον τυπικό μηχανισμό Share Intent του Android, η εφαρμογή σας μπορεί να προσφέρει λειτουργικότητα εκτύπωσης χωρίς να γράψετε μία μόνο γραμμή κώδικα ειδικά για το PrintHand. Όταν οι χρήστες μοιράζονται περιεχόμενο κατάλληλο για εκτύπωση από την εφαρμογή σας, το PrintHand εμφανίζεται αυτόματα ως μία από τις επιλογές κοινής χρήσης, όπως ακριβώς οι εφαρμογές email ή κοινωνικών δικτύων.

Αυτή η προσέγγιση είναι ιδανική για εφαρμογές που επιθυμούν να παρέχουν εκτύπωση με ελάχιστη προσπάθεια ανάπτυξης. Πολλές καλά εδραιωμένες εφαρμογές χωρίς άμεση σύνδεση με το PrintHand χρησιμοποιούν αυτή τη μέθοδο για να επιτρέψουν στους χρήστες τους να εκτυπώνουν έγγραφα, εικόνες και άλλο περιεχόμενο. Η ομορφιά αυτής της ενσωμάτωσης είναι η απλότητά της: εάν η εφαρμογή σας ήδη υλοποιεί τη λειτουργικότητα κοινής χρήσης του Android για άλλους σκοπούς, η εκτύπωση έρχεται δωρεάν.

Πώς Λειτουργεί

Όταν ένας χρήστης επιλέγει "Κοινή χρήση" στην εφαρμογή σας και επιλέγει το PrintHand από τη λίστα των διαθέσιμων εφαρμογών, το Android μεταβιβάζει το περιεχόμενο στο PrintHand. Το PrintHand στη συνέχεια αναλαμβάνει όλη τη ροή εργασίας εκτύπωσης: απόδοση του περιεχομένου, εμφάνιση προεπισκόπησης, επιτρέποντας στον χρήστη να διαμορφώσει τις ρυθμίσεις του εκτυπωτή και τελικά αποστολή της εργασίας στον επιλεγμένο εκτυπωτή. Η εφαρμογή σας απλώς ξεκινά την ενέργεια κοινής χρήσης και το PrintHand φροντίζει για όλα τα υπόλοιπα.

Υποστηριζόμενοι Τύποι Περιεχομένου

• Εικόνες: JPEG, PNG, GIF και άλλες τυπικές μορφές εικόνας
• Έγγραφα: Αρχεία PDF και απλού κειμένου
• Περιεχόμενο Ιστού: URL και περιεχόμενο HTML
• Προσαρμοσμένα Δεδομένα: Οποιοδήποτε περιεχόμενο που μπορεί να μοιραστεί η εφαρμογή σας μέσω τυπικών intent του Android

Απαιτήσεις

Οι χρήστες πρέπει να έχουν εγκατεστημένη την εφαρμογή PrintHand στη συσκευή τους με έγκυρη άδεια για εκτύπωση. Η εφαρμογή σας δεν απαιτεί ειδικά δικαιώματα ή εξαρτήσεις, μόνο την τυπική υλοποίηση Share Intent του Android που χρησιμοποιούν ήδη οι περισσότερες εφαρμογές.

Υλοποίηση

Εάν η εφαρμογή σας ήδη υλοποιεί τη λειτουργικότητα κοινής χρήσης του Android, δεν χρειάζεται επιπλέον κώδικας. Εάν όχι, η υλοποίηση μιας βασικής ενέργειας κοινής χρήσης είναι απλή χρησιμοποιώντας τα τυπικά ShareCompat ή Intent.ACTION_SEND API του Android. Η τεκμηρίωση του PrintHand και ο δείγμα κώδικας παρέχουν παραδείγματα σωστής υλοποίησης.

Το Intent API παρέχει ένα ισχυρό μέσο όρο μεταξύ της κοινής χρήσης χωρίς κώδικα και της πλήρους ενσωμάτωσης SDK. Επιτρέπει στην εφαρμογή σας να ανακαλύπτει εκτυπωτές προγραμματιστικά, να ρυθμίζει επιλογές εκτύπωσης και να ξεκινά εργασίες εκτύπωσης, όλα ενώ διατηρεί τον έλεγχο της διεπαφής χρήστη και της ροής εργασίας της εφαρμογής σας. Αυτή είναι η πιο συχνά χρησιμοποιούμενη μέθοδος ενσωμάτωσης για προγραμματιστές που επιθυμούν σημαντικό έλεγχο χωρίς την πολυπλοκότητα των λειτουργιών εκτύπωσης χαμηλού επιπέδου.

Με το Intent API, μπορείτε να δημιουργήσετε προσαρμοσμένους διαλόγους επιλογής εκτυπωτή, να δημιουργήσετε προκαθορισμένες ρυθμίσεις εκτύπωσης και να ενσωματώσετε απρόσκοπτα την εκτύπωση στις υπάρχουσες ροές εργασίας της εφαρμογής σας. Η εφαρμογή σας επικοινωνεί με το PrintHand μέσω μιας σειράς καλά ορισμένων intent που χειρίζονται την ανακάλυψη εκτυπωτών, τη ρύθμιση επιλογών, την απόδοση περιεχομένου και την υποβολή εργασιών. Το PrintHand επεξεργάζεται αυτά τα αιτήματα και επιστρέφει αποτελέσματα στην εφαρμογή σας, επιτρέποντάς σας να διατηρείτε τον πλήρη έλεγχο της εμπειρίας χρήστη.

Βασικές Δυνατότητες

• Ανακάλυψη Εκτυπωτών: Ανακαλύψτε προγραμματιστικά διαθέσιμους εκτυπωτές μέσω WiFi, Bluetooth και USB
• Διαμόρφωση Ρυθμίσεων: Ελέγξτε το μέγεθος χαρτιού, τον προσανατολισμό, την ποιότητα, τη λειτουργία χρώματος και άλλες επιλογές ειδικές για τον εκτυπωτή
• Απόδοση Περιεχομένου: Αφήστε το PrintHand να χειριστεί την πολύπλοκη απόδοση εγγράφων ή στείλτε προαποδοθέν περιεχόμενο
• Διαχείριση Εργασιών Εκτύπωσης: Ξεκινήστε την εκτύπωση, παρακολουθήστε την κατάσταση και χειριστείτε τα αποτελέσματα

Ροή Εργασίας Ενσωμάτωσης

Η εφαρμογή σας στέλνει intent στην υπηρεσία Intent API του PrintHand για να εκτελέσει συγκεκριμένες λειτουργίες. Για παράδειγμα, για να εκτυπώσετε ένα έγγραφο, η εφαρμογή σας: ανακαλύπτει τους διαθέσιμους εκτυπωτές και τους παρουσιάζει στο UI σας, επιτρέπει στον χρήστη να επιλέξει έναν εκτυπωτή και να ρυθμίσει τις επιλογές, στέλνει ένα intent εκτύπωσης με το περιεχόμενο και τις επιλεγμένες ρυθμίσεις, και λαμβάνει επιβεβαίωση όταν ολοκληρωθεί η εργασία εκτύπωσης. Κάθε βήμα χρησιμοποιεί τυπική επικοινωνία Intent του Android, καθιστώντας την ενσωμάτωση απλή για τους προγραμματιστές Android.

Περιπτώσεις Χρήσης

Το Intent API είναι ιδανικό για εφαρμογές με πολύπλοκο περιεχόμενο όπως έγγραφα γραφείου, χάρτες, προσαρμοσμένες φόρμες ή αναφορές που απαιτούν ειδική απόδοση από την εφαρμογή. Είναι επίσης ιδανικό όταν θέλετε να προκαθορίσετε επιλογές εκτύπωσης βάσει του τύπου εγγράφου ή των προτιμήσεων χρήστη, ή όταν χρειάζεστε να ενσωματώσετε την εκτύπωση σε ροές εργασίας πολλαπλών βημάτων όπου οι χρήστες δεν θα πρέπει να εγκαταλείψουν την εφαρμογή σας.

Απαιτήσεις

Οι χρήστες χρειάζονται την εφαρμογή PrintHand εγκατεστημένη με έγκυρη άδεια. Η εφαρμογή σας πρέπει να περιλαμβάνει τις δηλώσεις υπηρεσίας Intent API του PrintHand στο manifest της και να υλοποιεί το πρωτόκολλο επικοινωνίας intent όπως τεκμηριώνεται στην αναφορά API και στον δείγμα κώδικα μας.

Το SDK του PrintHand παρέχει άμεση πρόσβαση χαμηλού επιπέδου στη μηχανή εκτύπωσής μας, προσφέροντας μέγιστη ευελιξία και έλεγχο για εξελιγμένες εφαρμογές. Σε αντίθεση με το Intent API που βασίζεται στα στοιχεία UI του PrintHand, το SDK σας δίνει πλήρη ελευθερία να σχεδιάσετε κάθε πτυχή της εμπειρίας εκτύπωσης. Αυτή η προσέγγιση είναι ιδανική για επιχειρησιακές εφαρμογές, λύσεις λευκής ετικέτας ή οποιαδήποτε εφαρμογή που απαιτεί να γίνεται η εκτύπωση αόρατα στο παρασκήνιο χωρίς αλληλεπίδραση χρήστη.

Με το SDK, λαμβάνετε λεπτομερή έλεγχο κάθε πτυχής της διαδικασίας εκτύπωσης: ανίχνευση και φιλτράρισμα εκτυπωτών, διαχείριση και εγκατάσταση προγραμμάτων οδήγησης, παραμετροποίηση και ιεράρχηση εργασιών εκτύπωσης, προσαρμοσμένος χειρισμός σφαλμάτων και ανάκαμψη. Η εφαρμογή σας γίνεται πλήρως υπεύθυνη για ολόκληρη τη ροή εργασίας εκτύπωσης, από την παρουσίαση επιλογών εκτυπωτή στον χρήστη μέχρι τον χειρισμό της ολοκλήρωσης εργασιών και σφαλμάτων.

Προηγμένες Δυνατότητες

• Πλήρης Έλεγχος UI: Κατασκευάστε προσαρμοσμένες διεπαφές ανακάλυψης εκτυπωτών, διαμόρφωσης και προεπισκόπησης που ταιριάζουν με το σχεδιασμό της εφαρμογής σας
• Εκτύπωση Παρασκηνίου: Εκτελέστε εργασίες εκτύπωσης χωρίς καμία αλληλεπίδραση χρήστη ή στοιχεία UI
• Διαχείριση Προγραμμάτων Οδήγησης: Κατεβάστε και διαχειριστείτε προγραμματιστικά προγράμματα οδήγησης εκτυπωτών για υποστηριζόμενες συσκευές
• Προσαρμοσμένη Απόδοση: Πλήρης έλεγχος της προετοιμασίας περιεχομένου και του pipeline απόδοσης
• Επιχειρησιακές Λειτουργίες: Παραμετροποίηση εργασιών, εκτύπωση παρτίδας, αυτοματοποιημένη επιλογή εκτυπωτή και προσαρμοσμένος χειρισμός σφαλμάτων

Πολυπλοκότητα Υλοποίησης

Το SDK απαιτεί βαθύτερη κατανόηση των εννοιών κινητής εκτύπωσης και σημαντικά περισσότερη προσπάθεια ανάπτυξης από το Intent API. Η εφαρμογή σας πρέπει να παρέχει πλήρες UI για την ανακάλυψη εκτυπωτών, να εμφανίζει τις δυνατότητες και επιλογές του εκτυπωτή, να χειρίζεται λήψεις και εγκατάσταση προγραμμάτων οδήγησης, να διαχειρίζεται τον κύκλο ζωής εργασιών εκτύπωσης και να υλοποιεί χειρισμό σφαλμάτων και ανάκαμψη. Ωστόσο, αυτή η προσπάθεια ανταμείβεται με απαράμιλλη ευελιξία και έλεγχο.

Δομή SDK

Το SDK του PrintHand παρέχεται ως βιβλιοθήκη Java που ενσωματώνεται απευθείας στην εφαρμογή σας Android. Εκθέτει ένα ολοκληρωμένο API για όλες τις λειτουργίες εκτύπωσης, με λεπτομερή τεκμηρίωση που καλύπτει τη διαχείριση εκτυπωτών, την υποβολή εργασιών, την παρακολούθηση κατάστασης και τη διαχείριση διαμόρφωσης. Το SDK έχει σχεδιαστεί να είναι ασφαλές σε νήματα και αποδοτικό, κατάλληλο για σενάρια εκτύπωσης υψηλού όγκου.

Περιπτώσεις Χρήσης

Ιδανικό για επιχειρησιακές εφαρμογές που απαιτούν αυτοματοποιημένες ροές εργασίας εκτύπωσης, συστήματα σημείου πώλησης που χρειάζονται εκτύπωση αποδείξεων χωρίς αλληλεπίδραση χρήστη, εφαρμογές logistics και παράδοσης με εκτύπωση ετικετών υψηλού όγκου και λύσεις λευκής ετικέτας όπου η επωνυμία PrintHand δεν θα πρέπει να εμφανίζεται.

Απαιτήσεις

Οι χρήστες χρειάζονται είτε την εφαρμογή PrintHand είτε την αυτόνομη υπηρεσία εκτύπωσης PrintHand εγκατεστημένη στη συσκευή τους με έγκυρη άδεια. Η εφαρμογή σας πρέπει να περιλαμβάνει τη βιβλιοθήκη SDK στο έργο σας και απαιτεί κατανόηση των πρωτοκόλλων επικοινωνίας εκτυπωτών και της αρχιτεκτονικής εκτύπωσης Android για βέλτιστη υλοποίηση.

Δείγμα Κώδικα και Πόροι

Για να σας βοηθήσουμε να ξεκινήσετε με την ενσωμάτωση του PrintHand, δημιουργήσαμε μια ολοκληρωμένη εφαρμογή δείγματος που επιδεικνύει και τις τρεις μεθόδους ενσωμάτωσης. Ο δείγμα κώδικας δείχνει βέλτιστες πρακτικές για την υλοποίηση κάθε προσέγγισης, τον χειρισμό περιπτώσεων ακραίων και την παροχή εξαιρετικής εμπειρίας χρήστη.

Αποθετήριο GitHub

Το αποθετήριο PrintingSample μας περιέχει λειτουργικά παραδείγματα Share Intent, Intent API και ενσωμάτωσης SDK. Ο κώδικας είναι καλά τεκμηριωμένος και επιδεικνύει πραγματικά μοτίβα χρήσης. Επισκεφτείτε το αποθετήριο GitHub μας στο:

github.com/DynamixSoftware/PrintingSample

Τεκμηρίωση

Λεπτομερής τεκμηρίωση API, οδηγοί ενσωμάτωσης και πόροι αντιμετώπισης προβλημάτων είναι διαθέσιμοι στο wiki του αποθετηρίου. Ενημερώνουμε τακτικά την τεκμηρίωση βάσει σχολίων προγραμματιστών και νέων εκδόσεων Android.

Υποστήριξη

Για τεχνικές ερωτήσεις, βοήθεια ενσωμάτωσης ή για αναφορά προβλημάτων, επικοινωνήστε με την ομάδα υποστήριξης προγραμματιστών μας στο support@printhand.com. Είμαστε εδώ για να σας βοηθήσουμε να ενσωματώσετε επιτυχώς το PrintHand στην εφαρμογή σας.