Najrýchlejšia cesta k pridaniu tlačových možností do vašej Android aplikácie. Využitím štandardného Android mechanizmu Share Intent môže vaša aplikácia ponúkať tlačovú funkčnosť bez napísania jediného riadku špecifického kódu PrintHand. Keď používatelia zdieľajú obsah vhodný na tlač z vašej aplikácie, PrintHand sa automaticky zobrazí ako jedna z možností zdieľania, rovnako ako e-mailové alebo sociálne aplikácie.

Tento prístup je ideálny pre aplikácie, ktoré chcú poskytnúť tlač s minimálnym vývojovým úsilím. Mnohé zavedené aplikácie bez priameho spojenia s PrintHand používajú túto metódu na umožnenie svojim používateľom tlačiť dokumenty, obrázky a iný obsah. Krása tejto integrácie je v jej jednoduchosti: ak vaša aplikácia už implementuje Android funkčnosť zdieľania na iné účely, tlač prichádza zadarmo.

Ako to funguje

Keď používateľ vyberie "Zdieľať" vo vašej aplikácii a zvolí PrintHand zo zoznamu dostupných aplikácií, Android odovzdá obsah PrintHand. PrintHand potom zvládne celý tlačový pracovný postup: renderovanie obsahu, zobrazenie náhľadu, umožnenie používateľovi nakonfigurovať nastavenia tlačiarne a nakoniec odoslanie úlohy na vybranú tlačiareň. Vaša aplikácia jednoducho iniciuje akciu zdieľania a PrintHand sa postará o všetko ostatné.

Podporované typy obsahu

• Obrázky: JPEG, PNG, GIF a ďalšie štandardné obrazové formáty
• Dokumenty: PDF a textové súbory
• Webový obsah: URL adresy a HTML obsah
• Vlastný obsah: Akýkoľvek obsah, ktorý vaša aplikácia môže zdieľať prostredníctvom štandardných Android intentov

Požiadavky

Používatelia musia mať nainštalovanú aplikáciu PrintHand na svojom zariadení s platnou licenciou na tlač. Vaša aplikácia nevyžaduje žiadne špeciálne povolenia ani závislosti, len štandardnú implementáciu Share Intent Android, ktorú väčšina aplikácií už používa.

Implementácia

Ak vaša aplikácia už implementuje Android funkčnosť zdieľania, nie je potrebný žiadny dodatočný kód. Ak nie, implementácia základnej akcie zdieľania je jednoduchá pomocou štandardných Android API ShareCompat alebo Intent.ACTION_SEND. Dokumentácia PrintHand a ukážkový kód poskytujú príklady správnej implementácie.

Intent API poskytuje výkonný stredný bod medzi zdieľaním bez kódu a úplnou integráciou SDK. Umožňuje vašej aplikácii programovo objavovať tlačiarne, konfigurovať možnosti tlače a iniciovať tlačové úlohy, to všetko pri zachovaní kontroly nad používateľským rozhraním a pracovným postupom vašej aplikácie. Toto je najčastejšie používaná metóda integrácie pre vývojárov, ktorí chcú významnú kontrolu bez zložitosti nízkoúrovňových tlačových operácií.

S Intent API môžete vytvárať vlastné dialógy výberu tlačiarne, vytvárať predvolené konfigurácie tlače a bezproblémovo integrovať tlač do existujúcich pracovných postupov vašej aplikácie. Vaša aplikácia komunikuje s PrintHand prostredníctvom série dobre definovaných intentov, ktoré zvládajú objavovanie tlačiarní, konfiguráciu možností, renderovanie obsahu a odosielanie úloh. PrintHand spracuje tieto požiadavky a vráti výsledky vašej aplikácii, čo vám umožní udržať úplnú kontrolu nad užívateľskou skúsenosťou.

Kľúčové možnosti

• Objavovanie tlačiarní: Programovo objavujte dostupné tlačiarne cez WiFi, Bluetooth a USB
• Konfigurácia nastavení: Ovládajte veľkosť papiera, orientáciu, kvalitu, farebný režim a ďalšie možnosti špecifické pre tlačiareň
• Renderovanie obsahu: Nechajte PrintHand zvládnuť zložité renderovanie dokumentov alebo odošlite vopred renderovaný obsah
• Správa tlačových úloh: Iniciujte tlač, monitorujte stav a zvládajte výsledky

Integračný pracovný postup

Vaša aplikácia odošle intenty PrintHand Intent API službe na vykonanie konkrétnych operácií. Napríklad na tlač dokumentu vaša aplikácia: objaví dostupné tlačiarne a zobrazí ich vo vašom UI, umožní používateľovi vybrať tlačiareň a nakonfigurovať možnosti, odošle intent tlače s obsahom a vybranými nastaveniami a prijme potvrdenie po dokončení tlačovej úlohy. Každý krok používa štandardnú Intent komunikáciu Android, čo robí integráciu priamočiarou pre Android vývojárov.

Prípady použitia

Intent API je ideálne pre aplikácie so zložitým obsahom ako kancelárske dokumenty, mapy, vlastné formuláre alebo správy, ktoré vyžadujú špecifické renderovanie aplikácie. Tiež je ideálne, keď chcete prednastaviť možnosti tlače podľa typu dokumentu alebo preferencií používateľa, alebo keď potrebujete integrovať tlač do viacstupňových pracovných postupov, kde používatelia by nemali opustiť vašu aplikáciu.

Požiadavky

Používatelia potrebujú nainštalovanú aplikáciu PrintHand s platnou licenciou. Vaša aplikácia musí zahŕňať deklarácie PrintHand Intent API služby vo vašom manifeste a implementovať intent komunikačný protokol, ako je dokumentované v našej API referencii a ukážkovom kóde.

PrintHand SDK poskytuje priamy nízkoúrovňový prístup k nášmu tlačovému motoru, ponúkajúc maximálnu flexibilitu a kontrolu pre sofistikované aplikácie. Na rozdiel od Intent API, ktorá závisí od PrintHand UI komponentov, SDK vám dáva úplnú slobodu navrhnúť každý aspekt tlačovej skúsenosti. Tento prístup je ideálny pre podnikové aplikácie, white label riešenia alebo akúkoľvek aplikáciu, ktorá vyžaduje, aby tlač prebehla neviditeľne na pozadí bez interakcie používateľa.

S SDK získate detailnú kontrolu nad každým aspektom tlačového procesu: detekcia a filtrovanie tlačiarní, správa a inštalácia ovládačov, radenie a prioritizácia tlačových úloh, vlastné spracovanie chýb a obnova. Vaša aplikácia sa stáva úplne zodpovednou za celý tlačový pracovný postup, od prezentácie možností tlačiarne používateľovi až po spracovanie dokončenia úloh a chýb.

Pokročilé možnosti

• Úplná kontrola UI: Vytvorte vlastné rozhrania objavovania tlačiarní, konfigurácie a náhľadu, ktoré zodpovedajú dizajnu vašej aplikácie
• Tlač na pozadí: Spúšťajte tlačové úlohy bez akejkoľvek interakcie používateľa alebo UI komponentov
• Správa ovládačov: Programovo sťahujte a spravujte ovládače tlačiarní pre podporované zariadenia
• Vlastné renderovanie: Úplná kontrola nad prípravou obsahu a renderovacím pipeline
• Podnikové funkcie: Radenie úloh, dávková tlač, automatizovaný výber tlačiarne a vlastné spracovanie chýb

Zložitosť implementácie

SDK vyžaduje hlbšie pochopenie konceptov mobilnej tlače a výrazne viac vývojového úsilia ako Intent API. Vaša aplikácia musí poskytnúť kompletné UI pre objavovanie tlačiarní, zobrazenie možností a schopností tlačiarne, spracovanie sťahovania a inštalácie ovládačov, správu životného cyklu tlačových úloh a implementáciu spracovania chýb a obnovy. Toto úsilie je však odmenené bezkonkurenčnou flexibilitou a kontrolou.

Štruktúra SDK

PrintHand SDK je poskytované ako Java knižnica, ktorá sa integruje priamo do vašej Android aplikácie. Vystavuje komplexné API pre všetky tlačové operácie s podrobnou dokumentáciou pokrývajúcou správu tlačiarní, odosielanie úloh, monitorovanie stavu a správu konfigurácie. SDK je navrhnuté tak, aby bolo thread-safe a efektívne, vhodné pre vysokoobjem tlačových scenárov.

Prípady použitia

Ideálne pre podnikové aplikácie vyžadujúce automatizované tlačové pracovné postupy, point-of-sale systémy potrebujúce tlač účteniek bez interakcie používateľa, logistické a doručovacie aplikácie s vysokoobjem tlačou štítkov a white label riešenia, kde by sa značka PrintHand nemala objaviť.

Požiadavky

Používatelia potrebujú buď aplikáciu PrintHand alebo samostatnú tlačovú službu PrintHand nainštalovanú na svojom zariadení s platnou licenciou. Vaša aplikácia musí zahŕňať SDK knižnicu vo vašom projekte a vyžaduje pochopenie protokolov komunikácie tlačiarní a Android tlačovej architektúry pre optimálnu implementáciu.

Ukážkový kód a zdroje

Na pomoc pri začatí s integráciou PrintHand sme vytvorili komplexnú ukážkovú aplikáciu, ktorá demonštruje všetky tri integračné metódy. Ukážkový kód ukazuje najlepšie postupy pre implementáciu každého prístupu, spracovanie okrajových prípadov a poskytovanie skvelej užívateľskej skúsenosti.

GitHub repozitár

Náš repozitár PrintingSample obsahuje funkčné príklady Share Intent, Intent API a SDK integrácie. Kód je dobre dokumentovaný a demonštruje vzory použitia v reálnom svete. Navštívte náš GitHub repozitár na:

github.com/DynamixSoftware/PrintingSample

Dokumentácia

Podrobná API dokumentácia, integračné príručky a zdroje na riešenie problémov sú dostupné v wiki repozitára. Pravidelne aktualizujeme dokumentáciu na základe spätnej väzby vývojárov a nových verzií Android.

Podpora

Pre technické otázky, pomoc s integráciou alebo hlásenie problémov kontaktujte náš tím podpory pre vývojárov na support@printhand.com. Sme tu, aby sme vám pomohli úspešne integrovať PrintHand do vašej aplikácie.