De kortste weg om printfunctionaliteit aan uw Android-app toe te voegen. Door het standaard Share Intent-mechanisme van Android te gebruiken, kan uw app printen aanbieden zonder dat u één regel PrintHand-specifieke code schrijft. Wanneer gebruikers inhoud die geschikt is om te printen vanuit uw app delen, verschijnt PrintHand automatisch als een van de deelopties, net als e-mail- of socialemedia-apps.

Deze aanpak is ideaal voor apps die printen willen aanbieden met minimale ontwikkelinspanning. Veel gevestigde applicaties zonder directe band met PrintHand gebruiken deze methode om hun gebruikers documenten, afbeeldingen en andere inhoud te laten printen. Het mooie van deze integratie is de eenvoud: als uw app de deelfunctie van Android al voor andere doeleinden implementeert, krijgt u printen er gratis bij.

Hoe het werkt

Wanneer een gebruiker in uw applicatie "Delen" kiest en PrintHand selecteert in de lijst met beschikbare apps, geeft Android de inhoud door aan PrintHand. PrintHand neemt vervolgens de volledige printworkflow over: de inhoud opmaken, een voorbeeld tonen, de gebruiker de printerinstellingen laten kiezen en ten slotte de opdracht naar de gekozen printer sturen. Uw app start alleen de deelactie; PrintHand regelt de rest.

Ondersteunde inhoudstypen

• Afbeeldingen: JPEG, PNG, GIF en andere gangbare afbeeldingsformaten
• Documenten: PDF-bestanden en platte tekst
• Webinhoud: URL's en HTML-inhoud
• Eigen gegevens: alle inhoud die uw app via standaard Android-intents kan delen

Vereisten

Gebruikers moeten de PrintHand-app met een geldige licentie op hun apparaat hebben geïnstalleerd om te kunnen printen. Uw app heeft geen speciale machtigingen of afhankelijkheden nodig, alleen de standaard Share Intent-implementatie van Android die de meeste apps al gebruiken.

Implementatie

Als uw app de deelfunctie van Android al implementeert, is er geen extra code nodig. Zo niet, dan is een eenvoudige deelactie snel gemaakt met de standaard ShareCompat- of Intent.ACTION_SEND-API's van Android. De PrintHand-documentatie en de voorbeeldcode laten zien hoe u dit correct implementeert.

De Intent API is een krachtige middenweg tussen delen zonder code en volledige SDK-integratie. Hiermee kan uw applicatie programmatisch printers vinden, printopties instellen en printopdrachten starten, terwijl u de controle houdt over de gebruikersinterface en workflow van uw app. Dit is de meest gebruikte integratiemethode voor ontwikkelaars die echte controle willen zonder de complexiteit van low-level printbewerkingen.

Met de Intent API kunt u eigen dialoogvensters voor printerkeuze bouwen, vooraf ingestelde printconfiguraties maken en printen naadloos in de bestaande workflows van uw app opnemen. Uw app communiceert met PrintHand via een reeks duidelijk gedefinieerde intents voor het vinden van printers, het instellen van opties, het opmaken van inhoud en het indienen van opdrachten. PrintHand verwerkt deze verzoeken en geeft de resultaten terug aan uw app, zodat u de volledige controle over de gebruikerservaring behoudt.

Belangrijkste mogelijkheden

• Printers vinden: vind programmatisch beschikbare printers via WiFi, Bluetooth en USB
• Instellingen configureren: bepaal papierformaat, afdrukstand, kwaliteit, kleurmodus en andere printerspecifieke opties
• Inhoud opmaken: laat PrintHand complexe documenten opmaken of lever vooraf opgemaakte inhoud aan
• Printopdrachten beheren: start het printen, volg de status en verwerk de resultaten

Integratieworkflow

Uw app stuurt intents naar de Intent API-service van PrintHand om specifieke bewerkingen uit te voeren. Om bijvoorbeeld een document te printen, zou uw app: de beschikbare printers vinden en in uw eigen interface tonen, de gebruiker een printer laten kiezen en opties laten instellen, een print-intent met de inhoud en de gekozen instellingen versturen, en een bevestiging ontvangen wanneer de printopdracht is voltooid. Elke stap gebruikt de standaard Intent-communicatie van Android, waardoor de integratie voor Android-ontwikkelaars eenvoudig is.

Toepassingen

De Intent API is perfect voor applicaties met complexe inhoud zoals kantoordocumenten, kaarten, eigen formulieren of rapporten die app-specifieke opmaak vereisen. Hij is ook ideaal wanneer u printopties vooraf wilt instellen op basis van documenttype of gebruikersvoorkeuren, of wanneer u printen wilt opnemen in workflows met meerdere stappen waarbij gebruikers uw app niet hoeven te verlaten.

Vereisten

Gebruikers hebben de PrintHand-app met een geldige licentie nodig. Uw app moet de servicedeclaraties van de PrintHand Intent API in het manifest opnemen en het intent-communicatieprotocol implementeren zoals beschreven in onze API-referentie en voorbeeldcode.

De PrintHand SDK biedt directe, low-level toegang tot onze printengine en geeft geavanceerde applicaties maximale flexibiliteit en controle. Anders dan de Intent API, die gebruikmaakt van de interfacecomponenten van PrintHand, geeft de SDK u de volledige vrijheid om elk aspect van de printervaring zelf te ontwerpen. Deze aanpak is ideaal voor zakelijke applicaties, white-label-oplossingen en elke app waarin printen onzichtbaar op de achtergrond moet gebeuren, zonder tussenkomst van de gebruiker.

Met de SDK krijgt u fijnmazige controle over elk onderdeel van het printproces: printers detecteren en filteren, drivers beheren en installeren, printopdrachten in de wachtrij zetten en prioriteren, en eigen foutafhandeling en herstel. Uw applicatie wordt volledig verantwoordelijk voor de hele printworkflow, van het tonen van printeropties aan de gebruiker tot het afhandelen van voltooide opdrachten en fouten.

Geavanceerde mogelijkheden

• Volledige controle over de interface: bouw eigen schermen voor het vinden en instellen van printers en voor het afdrukvoorbeeld, passend bij het ontwerp van uw app
• Printen op de achtergrond: voer printopdrachten uit zonder enige interactie met de gebruiker of interfacecomponenten
• Driverbeheer: download en beheer programmatisch printerdrivers voor ondersteunde apparaten
• Eigen opmaak: volledige controle over het voorbereiden en opmaken van de inhoud
• Zakelijke functies: wachtrijen, batchgewijs printen, automatische printerkeuze en eigen foutafhandeling

Complexiteit van de implementatie

De SDK vereist een dieper begrip van mobiel printen en aanzienlijk meer ontwikkelwerk dan de Intent API. Uw applicatie moet een volledige interface bieden voor het vinden van printers, de mogelijkheden en opties van de printer tonen, het downloaden en installeren van drivers afhandelen, de levenscyclus van printopdrachten beheren en foutafhandeling en herstel implementeren. Deze inspanning wordt echter beloond met ongeëvenaarde flexibiliteit en controle.

Opbouw van de SDK

De PrintHand SDK wordt geleverd als een Java-bibliotheek die rechtstreeks in uw Android-applicatie wordt opgenomen. Hij biedt een uitgebreide API voor alle printbewerkingen, met gedetailleerde documentatie over printerbeheer, het indienen van opdrachten, statusbewaking en configuratiebeheer. De SDK is ontworpen om thread-safe en efficiënt te zijn en is geschikt voor scenario's met grote printvolumes.

Toepassingen

Perfect voor zakelijke applicaties met geautomatiseerde printworkflows, kassasystemen die bonnen moeten printen zonder tussenkomst van de gebruiker, logistieke en bezorgapps die grote aantallen labels printen, en white-label-oplossingen waarin de merknaam PrintHand niet mag verschijnen.

Vereisten

Gebruikers hebben de PrintHand-app of de losse PrintHand-printservice met een geldige licentie op hun apparaat nodig. Uw app moet de SDK-bibliotheek in het project opnemen, en voor een optimale implementatie is kennis van printercommunicatieprotocollen en de printarchitectuur van Android vereist.

Voorbeeldcode en bronnen

Om u op weg te helpen met de integratie van PrintHand hebben wij een uitgebreide voorbeeldapplicatie gemaakt die alle drie de integratiemethoden demonstreert. De voorbeeldcode toont de beste werkwijzen voor elke aanpak, het afhandelen van randgevallen en het bieden van een goede gebruikerservaring.

GitHub-repository

Onze PrintingSample-repository bevat werkende voorbeelden van integratie via Share Intent, de Intent API en de SDK. De code is goed gedocumenteerd en laat zien hoe de integratie in de praktijk wordt gebruikt. Bezoek onze GitHub-repository op:

github.com/DynamixSoftware/PrintingSample

Documentatie

Gedetailleerde API-documentatie, integratiehandleidingen en hulp bij het oplossen van problemen vindt u in de wiki van de repository. Wij werken de documentatie regelmatig bij op basis van feedback van ontwikkelaars en nieuwe Android-versies.

Ondersteuning

Voor technische vragen, hulp bij de integratie of het melden van problemen kunt u contact opnemen met ons ontwikkelaarsteam via support@printhand.com. Wij helpen u graag om PrintHand met succes in uw applicatie te integreren.