Nejrychlejší cesta k přidání tiskových schopností do vaší Android aplikace. Využitím standardního Android mechanismu Share Intent může vaše aplikace nabídnout tiskovou funkčnost bez napsání jediného řádku kódu specifického pro PrintHand. Když uživatelé sdílejí obsah vhodný pro tisk z vaší aplikace, PrintHand se automaticky objeví jako jedna z možností sdílení, stejně jako e-mailové aplikace nebo sociální sítě.

Tento přístup je ideální pro aplikace, které chtějí poskytovat tisk s minimálním vývojovým úsilím. Mnoho zavedených aplikací bez přímého spojení s PrintHand používá tuto metodu k umožnění uživatelům tisknout dokumenty, obrázky a další obsah. Krása této integrace spočívá v její jednoduchosti: pokud vaše aplikace již implementuje funkčnost sdílení Android pro jiné účely, tisk je zdarma.

Jak to funguje

Když uživatel vybere "Sdílet" ve vaší aplikaci a zvolí PrintHand ze seznamu dostupných aplikací, Android předá obsah PrintHand. PrintHand se pak postará o celý tiskový workflow: vykreslení obsahu, zobrazení náhledu, umožnění uživateli konfigurovat nastavení tiskárny a nakonec odeslání úlohy na vybranou tiskárnu. Vaše aplikace jednoduše iniciuje akci sdílení a PrintHand se postará o vše ostatní.

Podporované typy obsahu

• Obrázky: JPEG, PNG, GIF a další standardní formáty obrázků
• Dokumenty: PDF soubory a prostý text
• Webový obsah: URL a HTML obsah
• Vlastní data: Jakýkoli obsah, který vaše aplikace může sdílet prostřednictvím standardních Android intentů

Požadavky

Uživatelé musí mít aplikaci PrintHand nainstalovanou na svém zařízení s platnou licencí pro tisk. Vaše aplikace nevyžaduje žádná speciální oprávnění ani závislosti, pouze standardní implementaci Share Intent Android, kterou většina aplikací již používá.

Implementace

Pokud vaše aplikace již implementuje funkčnost sdílení Android, není potřeba žádný další kód. Pokud ne, implementace základní akce sdílení je jednoduchá pomocí standardních Android API ShareCompat nebo Intent.ACTION_SEND. Dokumentace PrintHand a ukázkový kód poskytují příklady správné implementace.

Intent API poskytuje výkonný střední bod mezi sdílením bez kódu a plnou integrací SDK. Umožňuje vaší aplikaci programově objevovat tiskárny, konfigurovat možnosti tisku a iniciovat tiskové úlohy, vše při zachování kontroly nad uživatelským rozhraním a workflow vaší aplikace. To je nejčastěji používaná metoda integrace pro vývojáře, kteří chtějí významnou kontrolu bez složitosti nízkoúrovňových tiskových operací.

S Intent API můžete vytvářet vlastní dialogy pro výběr tiskáren, vytvářet přednastavení tiskových konfigurací a integrovat tisk bezproblémově do stávajících workflow vaší aplikace. Vaše aplikace komunikuje s PrintHand prostřednictvím série dobře definovaných intentů, které zvládají objevování tiskáren, konfiguraci možností, vykreslování obsahu a odesílání úloh. PrintHand zpracovává tyto požadavky a vrací výsledky vaší aplikaci, což vám umožňuje zachovat plnou kontrolu nad uživatelskou zkušeností.

Klíčové schopnosti

• Objevování tiskáren: Programově objevujte dostupné tiskárny přes WiFi, Bluetooth a USB
• Konfigurace nastavení: Ovládejte velikost papíru, orientaci, kvalitu, barevný režim a další možnosti specifické pro tiskárnu
• Vykreslování obsahu: Nechte PrintHand zvládnout složité vykreslování dokumentů nebo odesílejte předvykreslený obsah
• Správa tiskových úloh: Iniciujte tisk, sledujte stav a zpracovávejte výsledky

Integrační workflow

Vaše aplikace odesílá intenty službě Intent API PrintHand pro provádění konkrétních operací. Například pro tisk dokumentu vaše aplikace: objeví dostupné tiskárny a prezentuje je ve vašem UI, umožní uživateli vybrat tiskárnu a konfigurovat možnosti, odešle intent tisku s obsahem a vybranými nastaveními, a přijme potvrzení po dokončení tiskové úlohy. Každý krok používá standardní Android Intent komunikaci, což činí integraci přímočarou pro Android vývojáře.

Případy použití

Intent API je perfektní pro aplikace se složitým obsahem jako kancelářské dokumenty, mapy, vlastní formuláře nebo zprávy vyžadující specifické vykreslování aplikace. Je také ideální, když chcete přednastavit možnosti tisku podle typu dokumentu nebo preferencí uživatele, nebo když potřebujete integrovat tisk do vícekrokových workflow, kde by uživatelé neměli opouštět vaši aplikaci.

Požadavky

Uživatelé potřebují aplikaci PrintHand nainstalovanou s platnou licencí. Vaše aplikace musí zahrnovat deklarace služby Intent API PrintHand ve svém manifestu a implementovat protokol intent komunikace, jak je zdokumentováno v naší referenci API a ukázkovém kódu.

PrintHand SDK poskytuje přímý nízkoúrovňový přístup k našemu tiskovému enginu, nabízející maximální flexibilitu a kontrolu pro sofistikované aplikace. Na rozdíl od Intent API, které závisí na PrintHand UI komponentách, SDK vám dává plnou svobodu navrhnout každý aspekt tiskové zkušenosti. Tento přístup je ideální pro podnikové aplikace, white-label řešení nebo jakoukoli aplikaci vyžadující, aby tisk probíhal neviditelně na pozadí bez interakce uživatele.

S SDK získáváte granulární kontrolu nad každým aspektem tiskového procesu: detekce a filtrování tiskáren, správa a instalace ovladačů, fronty a prioritizace tiskových úloh, vlastní zpracování chyb a obnova. Vaše aplikace se stává plně zodpovědnou za celý tiskový workflow, od prezentace možností tiskáren uživateli po zpracování dokončení úloh a chyb.

Pokročilé schopnosti

• Plná kontrola UI: Vytvářejte vlastní rozhraní pro objevování tiskáren, konfiguraci a náhled, která odpovídají designu vaší aplikace
• Tisk na pozadí: Spouštějte tiskové úlohy bez jakékoli interakce uživatele nebo UI komponent
• Správa ovladačů: Programově stahujte a spravujte ovladače tiskáren pro podporovaná zařízení
• Vlastní vykreslování: Plná kontrola nad přípravou obsahu a pipeline vykreslování
• Podnikové funkce: Fronty úloh, dávkový tisk, automatizovaný výběr tiskáren a vlastní zpracování chyb

Složitost implementace

SDK vyžaduje hlubší porozumění konceptům mobilního tisku a výrazně více vývojového úsilí než Intent API. Vaše aplikace musí poskytovat kompletní UI pro objevování tiskáren, zobrazovat schopnosti a možnosti tiskárny, zpracovávat stahování a instalaci ovladačů, spravovat životní cyklus tiskových úloh a implementovat zpracování chyb a obnovu. Toto úsilí je však odměněno bezkonkurenční flexibilitou a kontrolou.

Struktura SDK

PrintHand SDK je poskytováno jako Java knihovna, která se integruje přímo do vaší Android aplikace. Vystavuje komplexní API pro všechny tiskové operace, s podrobnou dokumentací pokrývající správu tiskáren, odesílání úloh, monitorování stavu a správu konfigurace. SDK je navrženo jako thread-safe a efektivní, vhodné pro scénáře tisku s velkým objemem.

Případy použití

Perfektní pro podnikové aplikace vyžadující automatizované tiskové workflow, pokladní systémy vyžadující tisk účtenek bez interakce uživatele, aplikace pro logistiku a dodávky s vysokoobsahovým tiskem štítků a white-label řešení, kde by se značka PrintHand neměla objevit.

Požadavky

Uživatelé potřebují buď aplikaci PrintHand nebo samostatnou tiskovou službu PrintHand nainstalovanou na svém zařízení s platnou licencí. Vaše aplikace musí zahrnovat SDK knihovnu ve svém projektu a vyžaduje porozumění protokolům tiskové komunikace a architektuře tisku Android pro optimální implementaci.

Ukázkový kód a zdroje

Abychom vám pomohli začít s integrací PrintHand, vytvořili jsme kompletní ukázkovou aplikaci, která demonstruje všechny tři metody integrace. Ukázkový kód ukazuje osvědčené postupy pro implementaci každého přístupu, zpracování okrajových případů a poskytování skvělé uživatelské zkušenosti.

GitHub repozitář

Náš repozitář PrintingSample obsahuje funkční příklady Share Intent, Intent API a integrace SDK. Kód je dobře zdokumentován a demonstruje vzory použití ze skutečného světa. Navštivte náš GitHub repozitář na:

github.com/DynamixSoftware/PrintingSample

Dokumentace

Podrobná dokumentace API, integrační průvodce a zdroje pro řešení problémů jsou k dispozici na wiki repozitáře. Pravidelně aktualizujeme dokumentaci na základě zpětné vazby vývojářů a nových vydání Android.

Podpora

Pro technické otázky, pomoc s integrací nebo hlášení problémů kontaktujte náš tým podpory vývojářů na support@printhand.com. Jsme zde, abychom vám pomohli úspěšně integrovat PrintHand do vaší aplikace.