A leggyorsabb út nyomtatási képességek hozzáadásához Android alkalmazásához. Az Android szabványos Share Intent mechanizmusának használatával alkalmazása nyomtatási funkcionalitást kínálhat anélkül, hogy egyetlen sor PrintHand-specifikus kódot kellene írnia. Amikor a felhasználók megosztanak nyomtatható tartalmat az alkalmazásából, a PrintHand automatikusan megjelenik a megosztási lehetőségek egyikeként, akárcsak az e-mail vagy közösségi média alkalmazások.

Ez a megközelítés ideális olyan alkalmazások számára, amelyek minimális fejlesztési erőfeszítéssel szeretnének nyomtatást biztosítani. Számos jól bevált alkalmazás, amelynek nincs közvetlen kapcsolata a PrintHand-del, ezt a módszert használja, hogy lehetővé tegye felhasználóiknak dokumentumok, képek és egyéb tartalom nyomtatását. Ennek az integrációnak a szépsége az egyszerűségében rejlik: ha alkalmazása már megvalósítja az Android megosztási funkcionalitást más célokra, a nyomtatás ingyen jön.

Hogyan Működik

Amikor egy felhasználó kiválasztja a "Megosztás" opciót az alkalmazásában és a PrintHand-et választja az elérhető alkalmazások listájából, az Android átadja a tartalmat a PrintHand-nek. A PrintHand ezután kezeli a teljes nyomtatási munkafolyamatot: a tartalom renderelését, előnézet megjelenítését, lehetővé téve a felhasználó számára a nyomtató beállítások konfigurálását és végül a feladat küldését a kiválasztott nyomtatóra. Az alkalmazás egyszerűen elindítja a megosztási műveletet, és a PrintHand mindent más megold.

Támogatott Tartalomtípusok

• Képek: JPEG, PNG, GIF és egyéb szabványos képformátumok
• Dokumentumok: PDF fájlok és egyszerű szöveg
• Webes Tartalom: URL-ek és HTML tartalom
• Egyéni Adatok: Bármilyen tartalom, amelyet alkalmazása megoszthat szabványos Android intent-eken keresztül

Követelmények

A felhasználóknak telepítve kell lenniük a PrintHand alkalmazásnak eszközükön érvényes licenccel a nyomtatáshoz. Az alkalmazás nem igényel különleges engedélyeket vagy függőségeket, csak az Android szabványos Share Intent megvalósítását, amelyet a legtöbb alkalmazás már használ.

Implementáció

Ha alkalmazása már megvalósítja az Android megosztási funkcionalitást, nincs szükség további kódra. Ha nem, egy alapvető megosztási művelet implementálása egyszerű az Android szabványos ShareCompat vagy Intent.ACTION_SEND API-k használatával. A PrintHand dokumentáció és mintakód megfelelő implementációs példákat nyújt.

Az Intent API hatékony középutat biztosít a kód nélküli megosztás és a teljes SDK integráció között. Lehetővé teszi alkalmazása számára a nyomtatók programozott felfedezését, nyomtatási beállítások konfigurálását és nyomtatási feladatok kezdeményezését, mindezt miközben megőrzi a kontrollt alkalmazása felhasználói felülete és munkafolyamata felett. Ez a leggyakrabban használt integrációs módszer fejlesztők számára, akik jelentős kontrollt szeretnének a kis szintű nyomtatási műveletek összetettsége nélkül.

Az Intent API-val egyéni nyomtatóválasztó párbeszédablakokat hozhat létre, nyomtatási beállítási előzményeket készíthet és a nyomtatást zökkenőmentesen integrálhatja alkalmazása meglévő munkafolyamataiba. Az alkalmazás jól meghatározott intent-ek sorozatán keresztül kommunikál a PrintHand-del, amelyek kezelik a nyomtatók felfedezését, beállítások konfigurálását, tartalom renderelését és feladatok küldését. A PrintHand feldolgozza ezeket a kéréseket és eredményeket küld vissza az alkalmazásának, lehetővé téve a teljes kontroll megőrzését a felhasználói élmény felett.

Kulcsfontosságú Képességek

• Nyomtatók Felfedezése: Rendelkezésre álló nyomtatók programozott felfedezése WiFi, Bluetooth és USB kapcsolaton keresztül
• Beállítások Konfigurálása: Papírméret, tájolás, minőség, színmód és egyéb nyomtató-specifikus beállítások vezérlése
• Tartalom Renderelés: Hagyja, hogy a PrintHand kezelje az összetett dokumentum renderelést, vagy küldjön előre renderelt tartalmat
• Nyomtatási Feladatok Kezelése: Nyomtatás kezdeményezése, állapot figyelése és eredmények kezelése

Integrációs Munkafolyamat

Az alkalmazás intent-eket küld a PrintHand Intent API szolgáltatásának meghatározott műveletek végrehajtásához. Például egy dokumentum nyomtatásához az alkalmazás: felfedezné a rendelkezésre álló nyomtatókat és bemutatná őket saját UI-jában, lehetővé tenné a felhasználó számára a nyomtató kiválasztását és beállítások konfigurálását, küldene egy nyomtatási intent-et a tartalommal és kiválasztott beállításokkal, és fogadná a megerősítést a nyomtatási feladat befejezésekor. Minden lépés szabványos Android Intent kommunikációt használ, egyszerűvé téve az integrációt Android fejlesztők számára.

Használati Esetek

Az Intent API tökéletes olyan alkalmazásokhoz, amelyek összetett tartalommal rendelkeznek, mint irodai dokumentumok, térképek, egyéni űrlapok vagy jelentések, amelyek alkalmazás-specifikus renderelést igényelnek. Ideális akkor is, amikor nyomtatási beállításokat szeretne előre beállítani a dokumentum típusa vagy felhasználói preferenciák alapján, vagy amikor a nyomtatást többlépéses munkafolyamatokba kell integrálni, ahol a felhasználók nem léphetnek ki az alkalmazásból.

Követelmények

A felhasználóknak telepítve kell lenniük a PrintHand alkalmazásnak érvényes licenccel. Az alkalmazásnak tartalmaznia kell a PrintHand Intent API szolgáltatás deklarációit a manifest-ben és implementálnia kell az intent kommunikációs protokollt, ahogy azt API referenciánk és mintakódunk dokumentálja.

A PrintHand SDK közvetlen alacsony szintű hozzáférést biztosít nyomtatómotorunkhoz, maximális rugalmasságot és kontrollt kínálva kifinomult alkalmazásokhoz. Az Intent API-val ellentétben, amely a PrintHand UI komponenseire támaszkodik, az SDK teljes szabadságot ad minden nyomtatási élmény aspektusának megtervezéséhez. Ez a megközelítés ideális vállalati alkalmazásokhoz, white-label megoldásokhoz vagy bármely alkalmazáshoz, amely megköveteli, hogy a nyomtatás láthatatlanul történjen a háttérben felhasználói interakció nélkül.

Az SDK-val részletes kontrollt kap a nyomtatási folyamat minden aspektusa felett: nyomtató észlelés és szűrés, driver kezelés és telepítés, feladatok sorba állítása és prioritizálása, egyéni hibakezelés és helyreállítás. Az alkalmazás teljes felelősséggel bír a teljes nyomtatási munkafolyamatért, a nyomtató opciók felhasználónak való bemutatásától a feladatok befejezésének és hibák kezelésének kezeléséig.

Fejlett Képességek

• Teljes UI Kontroll: Egyéni nyomtatófelfedezési, konfigurációs és előnézeti felületek építése, amelyek illeszkednek alkalmazása dizájnjához
• Háttér Nyomtatás: Nyomtatási feladatok futtatása bármilyen felhasználói interakció vagy UI komponens nélkül
• Driver Kezelés: Nyomtató driver-ek programozott letöltése és kezelése támogatott eszközökhöz
• Egyéni Renderelés: Teljes kontroll a tartalom előkészítése és renderelési folyamat felett
• Vállalati Funkciók: Feladatok sorba állítása, batch nyomtatás, automatizált nyomtatóválasztás és egyéni hibakezelés

Implementációs Összetettség

Az SDK mélyebb megértést igényel a mobil nyomtatási koncepciókról és jelentősen több fejlesztési erőfeszítést, mint az Intent API. Az alkalmazásnak biztosítania kell a teljes UI-t a nyomtató felfedezéshez, nyomtató képességek és opciók megjelenítéséhez, driver letöltések és telepítés kezeléséhez, nyomtatási feladatok életciklusának kezeléséhez, valamint hibakezelés és helyreállítás implementálásához. Azonban ez az erőfeszítés páratlan rugalmassággal és kontrollal van megjutalmazva.

SDK Struktúra

A PrintHand SDK Java könyvtárként kerül biztosításra, amely közvetlenül integrálódik az Android alkalmazásába. Teljes API-t tesz közzé minden nyomtatási művelethez, részletes dokumentációval, amely lefedi a nyomtatókezelést, feladatok küldését, állapot figyelését és konfigurációkezelést. Az SDK thread-safe és hatékony, alkalmas nagy volumenű nyomtatási forgatókönyvekhez.

Használati Esetek

Tökéletes vállalati alkalmazásokhoz, amelyek automatizált nyomtatási munkafolyamatokat igényelnek, pénztárgép rendszerekhez, amelyeknek nyugta nyomtatásra van szükségük felhasználói interakció nélkül, logisztikai és kiszállítási alkalmazásokhoz nagy volumenű címke nyomtatással, és white-label megoldásokhoz, ahol a PrintHand márka nem jelenhet meg.

Követelmények

A felhasználóknak telepítve kell lenniük a PrintHand alkalmazásnak vagy az önálló PrintHand nyomtatási szolgáltatásnak eszközükön érvényes licenccel. Az alkalmazásnak tartalmaznia kell az SDK könyvtárat a projektben és megértést igényel a nyomtató kommunikációs protokollokról és Android nyomtatási architektúráról az optimális implementációhoz.

Mintakód és Források

A PrintHand integráció megkezdésének segítéséhez létrehoztunk egy átfogó minta alkalmazást, amely bemutatja mindhárom integrációs módszert. A mintakód szemlélteti a legjobb gyakorlatokat minden megközelítés implementálásához, szélsőséges esetek kezeléséhez és remek felhasználói élmény biztosításához.

GitHub Tároló

PrintingSample tárolónk működő példákat tartalmaz a Share Intent, Intent API és SDK integrációhoz. A kód jól dokumentált és valós használati mintákat mutat be. Látogassa meg GitHub tárolónkat:

github.com/DynamixSoftware/PrintingSample

Dokumentáció

Részletes API dokumentáció, integrációs útmutatók és hibaelhárítási források elérhetők a tároló wiki-jében. Rendszeresen frissítjük a dokumentációt a fejlesztői visszajelzések és új Android verziók alapján.

Támogatás

Technikai kérdésekhez, integrációs segítséghez vagy problémák jelentéséhez forduljon fejlesztői támogató csapatunkhoz a support@printhand.com címen. Azért vagyunk itt, hogy segítsünk sikeresen integrálni a PrintHand-et alkalmazásába.