Cea mai rapidă cale pentru a adăuga capacități de imprimare la aplicația Android. Utilizând mecanismul standard Share Intent al Android, aplicația dumneavoastră poate oferi funcționalitate de imprimare fără a scrie o singură linie de cod specific PrintHand. Când utilizatorii partajează conținut potrivit pentru imprimare din aplicația dumneavoastră, PrintHand apare automat ca una dintre opțiunile de partajare, la fel ca aplicațiile de e-mail sau rețele sociale.

Această abordare este ideală pentru aplicații care doresc să ofere imprimare cu efort minim de dezvoltare. Multe aplicații bine stabilite fără conexiune directă cu PrintHand folosesc această metodă pentru a permite utilizatorilor să imprime documente, imagini și alte conținuturi. Frumusețea acestei integrări este simplitatea: dacă aplicația dumneavoastră implementează deja funcționalitatea de partajare Android pentru alte scopuri, imprimarea vine gratuit.

Cum Funcționează

Când un utilizator selectează "Partajare" în aplicația dumneavoastră și alege PrintHand din lista de aplicații disponibile, Android transmite conținutul către PrintHand. PrintHand se ocupă apoi de întregul workflow de imprimare: randarea conținutului, afișarea unei previzualizări, permiterea utilizatorului să configureze setările imprimantei și în final trimiterea lucrării la imprimanta selectată. Aplicația dumneavoastră pur și simplu inițiază acțiunea de partajare și PrintHand se ocupă de restul.

Tipuri de Conținut Suportate

• Imagini: JPEG, PNG, GIF și alte formate de imagine standard
• Documente: Fișiere PDF și text simplu
• Conținut Web: URL-uri și conținut HTML
• Date Personalizate: Orice conținut pe care aplicația dumneavoastră îl poate partaja prin intent-uri standard Android

Cerințe

Utilizatorii trebuie să aibă aplicația PrintHand instalată pe dispozitiv cu o licență validă pentru imprimare. Aplicația dumneavoastră nu necesită permisiuni speciale sau dependențe, doar implementarea standard Share Intent Android pe care majoritatea aplicațiilor o folosesc deja.

Implementare

Dacă aplicația dumneavoastră implementează deja funcționalitatea de partajare Android, nu este necesar cod suplimentar. Dacă nu, implementarea unei acțiuni de partajare de bază este simplă folosind API-urile standard ShareCompat sau Intent.ACTION_SEND Android. Documentația PrintHand și codul exemplu oferă exemple de implementare corectă.

Intent API oferă un punct de mijloc puternic între partajarea fără cod și integrarea completă SDK. Permite aplicației dumneavoastră să descopere imprimante programatic, să configureze opțiuni de imprimare și să inițieze lucrări de imprimare, toate în timp ce mențineți controlul asupra interfeței utilizator și workflow-ului aplicației. Aceasta este metoda de integrare cel mai frecvent folosită pentru dezvoltatori care doresc control semnificativ fără complexitatea operațiunilor de imprimare la nivel redus.

Cu Intent API, puteți crea dialoguri personalizate de selecție imprimantă, crea setări de imprimare presetate și integra imprimarea fără probleme în workflow-urile existente ale aplicației. Aplicația dumneavoastră comunică cu PrintHand printr-o serie de intent-uri bine definite care gestionează descoperirea imprimantelor, configurarea opțiunilor, randarea conținutului și trimiterea lucrărilor. PrintHand procesează aceste solicitări și returnează rezultate aplicației dumneavoastră, permițându-vă să mențineți controlul complet asupra experienței utilizatorului.

Capacități Cheie

• Descoperire Imprimante: Descoperiți imprimantele disponibile programatic prin WiFi, Bluetooth și USB
• Configurare Setări: Controlați dimensiunea hârtiei, orientarea, calitatea, modul de culoare și alte opțiuni specifice imprimantei
• Randare Conținut: Lăsați PrintHand să gestioneze randarea complexă a documentelor sau trimiteți conținut pre-randat
• Gestionare Lucrări de Imprimare: Inițiați imprimarea, monitorizați statusul și gestionați rezultatele

Workflow de Integrare

Aplicația dumneavoastră trimite intent-uri către serviciul Intent API PrintHand pentru a efectua operațiuni specifice. De exemplu, pentru a imprima un document, aplicația dumneavoastră: ar descoperi imprimantele disponibile și le-ar prezenta în UI-ul propriu, ar permite utilizatorului să selecteze o imprimantă și să configureze opțiuni, ar trimite un intent de imprimare cu conținutul și setările selectate și ar primi confirmare când lucrarea de imprimare este finalizată. Fiecare pas folosește comunicarea standard Intent Android, făcând integrarea directă pentru dezvoltatorii Android.

Cazuri de Utilizare

Intent API este perfect pentru aplicații cu conținut complex precum documente de birou, hărți, formulare personalizate sau rapoarte care necesită randare specifică aplicației. Este, de asemenea, ideal când doriți să presetați opțiuni de imprimare bazate pe tipul de document sau preferințele utilizatorului, sau când trebuie să integrați imprimarea în workflow-uri multi-pas unde utilizatorii nu ar trebui să părăsească aplicația dumneavoastră.

Cerințe

Utilizatorii necesită aplicația PrintHand instalată cu o licență validă. Aplicația dumneavoastră trebuie să includă declarațiile serviciului Intent API PrintHand în manifest și să implementeze protocolul de comunicare intent conform documentației noastre API și codului exemplu.

SDK-ul PrintHand oferă acces direct la nivel redus la motorul nostru de imprimare, oferind flexibilitate și control maxime pentru aplicații sofisticate. Spre deosebire de Intent API, care depinde de componentele UI PrintHand, SDK-ul vă oferă libertate completă să proiectați fiecare aspect al experienței de imprimare. Această abordare este ideală pentru aplicații enterprise, soluții white-label sau orice aplicație care necesită ca imprimarea să se desfășoare invizibil în fundal fără interacțiune utilizator.

Cu SDK-ul, obțineți control granular asupra fiecărui aspect al procesului de imprimare: detectare și filtrare imprimante, gestionare și instalare drivere, gestionare coadă și prioritizare lucrări de imprimare, gestionare personalizată erori și recuperare. Aplicația dumneavoastră devine complet responsabilă pentru întregul workflow de imprimare, de la prezentarea opțiunilor de imprimantă utilizatorului până la gestionarea finalizării lucrărilor și erorilor.

Capacități Avansate

• Control Complet UI: Construiți interfețe personalizate de descoperire imprimante, configurare și previzualizare care se potrivesc design-ului aplicației
• Imprimare în Fundal: Executați lucrări de imprimare fără nicio interacțiune utilizator sau componente UI
• Gestionare Drivere: Descărcați și gestionați drivere imprimantă programatic pentru dispozitive compatibile
• Randare Personalizată: Control complet asupra pregătirii conținutului și pipeline-ului de randare
• Funcții Enterprise: Gestionare coadă lucrări, imprimare batch, selecție automată imprimantă și gestionare personalizată erori

Complexitate Implementare

SDK-ul necesită o înțelegere mai profundă a conceptelor de imprimare mobilă și semnificativ mai mult efort de dezvoltare decât Intent API. Aplicația dumneavoastră trebuie să furnizeze UI complet pentru descoperirea imprimantelor, să afișeze capacitățile și opțiunile imprimantei, să gestioneze descărcările și instalarea driverelor, să gestioneze ciclul de viață al lucrărilor de imprimare și să implementeze gestionarea erorilor și recuperarea. Totuși, acest efort este răsplătit cu flexibilitate și control fără egal.

Structură SDK

SDK-ul PrintHand este furnizat ca bibliotecă Java care se integrează direct în aplicația Android. Expune un API cuprinzător pentru toate operațiunile de imprimare, cu documentație detaliată care acoperă gestionarea imprimantelor, trimiterea lucrărilor, monitorizarea statusului și gestionarea configurației. SDK-ul este proiectat să fie thread-safe și eficient, potrivit pentru scenarii de imprimare de volum mare.

Cazuri de Utilizare

Perfect pentru aplicații enterprise care necesită workflow-uri de imprimare automatizate, sisteme point-of-sale care necesită imprimare chitanțe fără interacțiune utilizator, aplicații logistică și livrare cu imprimare etichete de volum mare și soluții white-label unde brandul PrintHand nu ar trebui să apară.

Cerințe

Utilizatorii necesită fie aplicația PrintHand, fie serviciul de imprimare standalone PrintHand instalat pe dispozitiv cu o licență validă. Aplicația dumneavoastră trebuie să includă biblioteca SDK în proiect și necesită înțelegerea protocoalelor de comunicare imprimantă și arhitecturii de imprimare Android pentru implementare optimă.

Cod Exemplu și Resurse

Pentru a vă ajuta să începeți cu integrarea PrintHand, am creat o aplicație exemplu cuprinzătoare care demonstrează toate cele trei metode de integrare. Codul exemplu arată cele mai bune practici pentru implementarea fiecărei abordări, gestionarea cazurilor extreme și oferirea unei experiențe excelente pentru utilizator.

Depozit GitHub

Depozitul nostru PrintingSample conține exemple funcționale de Share Intent, Intent API și integrare SDK. Codul este bine documentat și demonstrează modele de utilizare din lumea reală. Vizitați depozitul nostru GitHub la:

github.com/DynamixSoftware/PrintingSample

Documentație

Documentație detaliată API, ghiduri de integrare și resurse de depanare sunt disponibile în wiki-ul depozitului. Actualizăm regulat documentația pe baza feedback-ului dezvoltatorilor și versiunilor noi Android.

Suport

Pentru întrebări tehnice, asistență de integrare sau raportarea problemelor, contactați echipa noastră de suport dezvoltatori la support@printhand.com. Suntem aici pentru a vă ajuta să integrați PrintHand cu succes în aplicația dumneavoastră.