Den snabbaste vägen till utskrift i din Android-app. Genom Androids vanliga Share Intent-mekanism kan din app erbjuda utskrift utan en enda rad PrintHand-specifik kod. När användaren delar innehåll som går att skriva ut från din app visas PrintHand automatiskt som ett av delningsalternativen, precis som e-post- eller sociala medie-appar.

Det här passar appar som vill erbjuda utskrift med minimal utvecklingsinsats. Många etablerade appar utan någon direkt koppling till PrintHand använder den här metoden för att låta sina användare skriva ut dokument, bilder och annat innehåll. Det fina med integrationen är enkelheten – om din app redan använder Androids delningsfunktion för andra ändamål får du utskrift på köpet.

Så fungerar det

När användaren väljer "Dela" i din app och sedan PrintHand i listan över tillgängliga appar skickar Android innehållet till PrintHand. PrintHand tar sedan över hela utskriftsflödet: renderar innehållet, visar en förhandsgranskning, låter användaren ställa in skrivaren och skickar slutligen jobbet till den valda skrivaren. Din app startar bara delningen, PrintHand sköter resten.

Innehållstyper som stöds

• Bilder: JPEG, PNG, GIF och andra vanliga bildformat
• Dokument: PDF-filer och oformaterad text
• Webbinnehåll: URL:er och HTML-innehåll
• Egna data: Allt innehåll din app kan dela via vanliga Android-intents

Krav

Användaren måste ha PrintHand-appen installerad på sin enhet med en giltig licens för att skriva ut. Din app behöver inga särskilda behörigheter eller beroenden – bara den vanliga Android Share Intent-implementationen som de flesta appar redan har.

Implementation

Om din app redan använder Androids delningsfunktion behövs ingen ytterligare kod. Om inte är det enkelt att implementera en grundläggande delning med Androids standard-API:er ShareCompat eller Intent.ACTION_SEND. PrintHands dokumentation och exempelkod visar hur det görs på rätt sätt.

Intent API är en kraftfull mellanväg mellan kodfri delning och fullständig SDK-integration. Det låter din app programmatiskt hitta skrivare, ställa in utskriftsalternativ och starta utskriftsjobb – samtidigt som du behåller kontrollen över appens gränssnitt och arbetsflöde. Det är den vanligaste integrationsmetoden för utvecklare som vill ha verklig kontroll utan komplexiteten i utskriftsoperationer på låg nivå.

Med Intent API kan du bygga egna dialoger för skrivarval, skapa förinställda utskriftskonfigurationer och väva in utskrift sömlöst i appens befintliga flöden. Appen kommunicerar med PrintHand genom en uppsättning väldefinierade intents som hanterar skrivarsökning, inställningar, rendering av innehåll och inskickning av jobb. PrintHand behandlar begäran och skickar resultatet tillbaka till din app, så att du har full kontroll över användarupplevelsen.

Viktigaste funktionerna

• Skrivarsökning: Hitta tillgängliga skrivare programmatiskt via WiFi, Bluetooth och USB
• Inställningar: Styr pappersstorlek, orientering, kvalitet, färgläge och andra skrivarspecifika alternativ
• Rendering av innehåll: Låt PrintHand rendera komplexa dokument eller skicka färdigrenderat innehåll
• Hantering av utskriftsjobb: Starta utskrift, följ status och hantera resultat

Integrationsflöde

Din app skickar intents till PrintHands Intent API-tjänst för att utföra enskilda operationer. För att skriva ut ett dokument skulle appen till exempel: hitta tillgängliga skrivare och visa dem i sitt eget gränssnitt, låta användaren välja skrivare och ställa in alternativ, skicka en utskrifts-intent med innehållet och de valda inställningarna, och få en bekräftelse när jobbet är klart. Varje steg använder vanlig Android Intent-kommunikation, vilket gör integrationen rak för Android-utvecklare.

Användningsområden

Intent API passar perfekt för appar med komplext innehåll som kontorsdokument, kartor, egna formulär eller rapporter som kräver app-specifik rendering. Det är också idealiskt när du vill förinställa utskriftsalternativ utifrån dokumenttyp eller användarens preferenser, eller när utskriften ska ingå i flerstegsflöden där användaren inte ska behöva lämna din app.

Krav

Användaren behöver PrintHand-appen installerad med en giltig licens. Din app måste innehålla deklarationerna för PrintHands Intent API-tjänst i manifestet och implementera intent-protokollet enligt vår API-referens och exempelkod.

PrintHand SDK ger direkt åtkomst på låg nivå till vår utskriftsmotor, med maximal flexibilitet och kontroll för avancerade appar. Till skillnad från Intent API, som bygger på PrintHands gränssnittskomponenter, ger SDK:t dig full frihet att utforma varje del av utskriftsupplevelsen. Det passar företagsappar, white label-lösningar och alla appar där utskriften ska ske osynligt i bakgrunden utan användarens medverkan.

Med SDK:t får du detaljerad kontroll över varje del av utskriftsprocessen: identifiering och filtrering av skrivare, hantering och installation av drivrutiner, köhantering och prioritering av utskriftsjobb samt egen felhantering och återhämtning. Din app tar fullt ansvar för hela utskriftsflödet, från att visa skrivaralternativ för användaren till att hantera avslutade jobb och fel.

Avancerade funktioner

• Full kontroll över gränssnittet: Bygg egna gränssnitt för skrivarsökning, inställningar och förhandsgranskning som matchar appens design
• Utskrift i bakgrunden: Kör utskriftsjobb utan användarinteraktion eller gränssnittskomponenter
• Drivrutinshantering: Ladda ned och hantera skrivardrivrutiner programmatiskt för enheter som stöds
• Egen rendering: Full kontroll över förberedelse och rendering av innehållet
• Företagsfunktioner: Köhantering, batchutskrift, automatiskt skrivarval och egen felhantering

Implementationens komplexitet

SDK:t kräver djupare förståelse för mobil utskrift och betydligt mer utvecklingsarbete än Intent API. Din app måste tillhandahålla ett komplett gränssnitt för skrivarsökning, visa skrivarens funktioner och alternativ, hantera nedladdning och installation av drivrutiner, hantera utskriftsjobbens livscykel och implementera felhantering och återhämtning. I gengäld får du oöverträffad flexibilitet och kontroll.

SDK:ts uppbyggnad

PrintHand SDK levereras som ett Java-bibliotek som integreras direkt i din Android-app. Det exponerar ett heltäckande API för alla utskriftsoperationer, med utförlig dokumentation om skrivarhantering, inskickning av jobb, statusövervakning och konfiguration. SDK:t är trådsäkert och effektivt, lämpat för utskrift i stora volymer.

Användningsområden

Perfekt för företagsappar med automatiserade utskriftsflöden, kassasystem som behöver skriva ut kvitton utan användarinteraktion, logistik- och leveransappar med etikettutskrift i stora volymer samt white label-lösningar där PrintHands varumärke inte ska synas.

Krav

Användaren behöver antingen PrintHand-appen eller den fristående PrintHand-utskriftstjänsten installerad på sin enhet med en giltig licens. Din app måste inkludera SDK-biblioteket i projektet, och för bästa resultat krävs förståelse för skrivarkommunikationsprotokoll och Androids utskriftsarkitektur.

Exempelkod och resurser

För att hjälpa dig komma igång med PrintHand-integration har vi tagit fram en omfattande exempelapp som visar alla tre integrationsmetoderna. Exempelkoden visar bästa praxis för varje metod, hur specialfall hanteras och hur man ger en bra användarupplevelse.

GitHub-repo

Vårt PrintingSample-repo innehåller fungerande exempel på integration via Share Intent, Intent API och SDK. Koden är väldokumenterad och visar verkliga användningsmönster. Besök vårt GitHub-repo på:

github.com/DynamixSoftware/PrintingSample

Dokumentation

Utförlig API-dokumentation, integrationsguider och felsökningsresurser finns i repots wiki. Vi uppdaterar dokumentationen löpande utifrån återkoppling från utvecklare och nya Android-versioner.

Support

För tekniska frågor, hjälp med integrationen eller för att rapportera problem, kontakta vår utvecklarsupport på support@printhand.com. Vi hjälper dig gärna att integrera PrintHand i din app.