Il percorso più rapido per aggiungere capacità di stampa alla tua applicazione Android. Utilizzando il meccanismo standard Share Intent di Android, la tua applicazione può offrire funzionalità di stampa senza scrivere una singola riga di codice specifico per PrintHand. Quando gli utenti condividono contenuti stampabili dalla tua applicazione, PrintHand appare automaticamente come una delle opzioni di condivisione, proprio come le applicazioni email o social media.

Questo approccio è ideale per applicazioni che desiderano fornire stampa con uno sforzo di sviluppo minimo. Molte applicazioni consolidate senza connessione diretta a PrintHand utilizzano questo metodo per consentire ai loro utenti di stampare documenti, immagini e altri contenuti. La bellezza di questa integrazione è la sua semplicità: se la tua applicazione implementa già la funzionalità di condivisione Android per altri scopi, la stampa è gratuita.

Come Funziona

Quando un utente seleziona "Condividi" nella tua applicazione e sceglie PrintHand dall'elenco di app disponibili, Android passa il contenuto a PrintHand. PrintHand quindi gestisce l'intero flusso di lavoro di stampa: renderizzare il contenuto, mostrare un'anteprima, consentire all'utente di configurare le impostazioni della stampante e infine inviare il lavoro alla stampante selezionata. La tua applicazione avvia semplicemente l'azione di condivisione e PrintHand si occupa di tutto il resto.

Tipi di Contenuto Supportati

• Immagini: JPEG, PNG, GIF e altri formati immagine standard
• Documenti: File PDF e testo semplice
• Contenuto Web: URL e contenuto HTML
• Dati Personalizzati: Qualsiasi contenuto che la tua applicazione può condividere tramite intent standard di Android

Requisiti

Gli utenti devono avere l'applicazione PrintHand installata sul loro dispositivo con una licenza valida per stampare. La tua applicazione non richiede permessi speciali o dipendenze, solo l'implementazione standard Share Intent di Android che la maggior parte delle applicazioni già utilizza.

Implementazione

Se la tua applicazione implementa già la funzionalità di condivisione Android, non è necessario codice aggiuntivo. In caso contrario, implementare un'azione di condivisione di base è semplice utilizzando le API standard ShareCompat o Intent.ACTION_SEND di Android. La documentazione di PrintHand e il codice di esempio forniscono esempi di implementazione corretta.

L'Intent API fornisce un punto intermedio potente tra la condivisione senza codice e l'integrazione completa dell'SDK. Consente alla tua applicazione di scoprire stampanti in modo programmatico, configurare opzioni di stampa e avviare lavori di stampa, il tutto mantenendo il controllo sull'interfaccia utente e sul flusso di lavoro della tua applicazione. Questo è il metodo di integrazione più comunemente utilizzato per gli sviluppatori che desiderano un controllo significativo senza la complessità delle operazioni di stampa di basso livello.

Con l'Intent API, puoi creare finestre di dialogo personalizzate per la selezione della stampante, creare configurazioni di stampa predefinite e integrare la stampa senza soluzione di continuità nei flussi di lavoro esistenti della tua applicazione. La tua applicazione comunica con PrintHand attraverso una serie di intent ben definiti che gestiscono la scoperta delle stampanti, la configurazione delle opzioni, il rendering del contenuto e l'invio dei lavori. PrintHand elabora queste richieste e restituisce risultati alla tua applicazione, consentendoti di mantenere il pieno controllo sull'esperienza utente.

Capacità Principali

• Scoperta Stampanti: Scopri stampanti disponibili in modo programmatico tramite WiFi, Bluetooth e USB
• Configurazione Impostazioni: Controlla formato carta, orientamento, qualità, modalità colore e altre opzioni specifiche della stampante
• Rendering del Contenuto: Lascia che PrintHand gestisca il rendering complesso dei documenti o invia contenuto pre-renderizzato
• Gestione Lavori di Stampa: Avvia la stampa, monitora lo stato e gestisci i risultati

Flusso di Lavoro di Integrazione

La tua applicazione invia intent al servizio Intent API di PrintHand per eseguire operazioni specifiche. Ad esempio, per stampare un documento, la tua applicazione: scoprirebbe le stampanti disponibili e le presenterebbe nella tua UI, consentirebbe all'utente di selezionare una stampante e configurare le opzioni, invierebbe un intent di stampa con il contenuto e le configurazioni selezionate, e riceverebbe conferma quando il lavoro di stampa è completato. Ogni passaggio utilizza la comunicazione Intent standard di Android, rendendo l'integrazione diretta per gli sviluppatori Android.

Casi d'Uso

L'Intent API è perfetta per applicazioni con contenuto complesso come documenti d'ufficio, mappe, moduli personalizzati o report che richiedono rendering specifico dell'applicazione. È anche ideale quando vuoi preimpostare opzioni di stampa in base al tipo di documento o alle preferenze dell'utente, o quando devi integrare la stampa in flussi di lavoro multi-step dove gli utenti non dovrebbero uscire dalla tua applicazione.

Requisiti

Gli utenti necessitano dell'applicazione PrintHand installata con una licenza valida. La tua applicazione deve includere le dichiarazioni del servizio Intent API di PrintHand nel suo manifest e implementare il protocollo di comunicazione intent come documentato nella nostra riferimento API e codice di esempio.

L'SDK di PrintHand fornisce accesso diretto di basso livello al nostro motore di stampa, offrendo massima flessibilità e controllo per applicazioni sofisticate. A differenza dell'Intent API, che dipende dai componenti UI di PrintHand, l'SDK ti dà piena libertà di progettare ogni aspetto dell'esperienza di stampa. Questo approccio è ideale per applicazioni aziendali, soluzioni white-label o qualsiasi applicazione che richieda che la stampa avvenga silenziosamente in background senza interazione dell'utente.

Con l'SDK, ottieni controllo granulare su ogni aspetto del processo di stampa: rilevamento e filtraggio delle stampanti, gestione e installazione dei driver, accodamento e prioritizzazione dei lavori di stampa, gestione personalizzata degli errori e recupero. La tua applicazione diventa completamente responsabile dell'intero flusso di lavoro di stampa, dalla presentazione delle opzioni della stampante all'utente alla gestione del completamento dei lavori e degli errori.

Capacità Avanzate

• Controllo Completo UI: Costruisci interfacce personalizzate per la scoperta delle stampanti, configurazione e anteprima che corrispondono al design della tua applicazione
• Stampa in Background: Esegui lavori di stampa senza alcuna interazione dell'utente o componenti UI
• Gestione Driver: Scarica e gestisci driver di stampante in modo programmatico per dispositivi supportati
• Rendering Personalizzato: Controllo completo sulla preparazione del contenuto e pipeline di rendering
• Funzionalità Aziendali: Accodamento lavori, stampa batch, selezione automatizzata della stampante e gestione personalizzata degli errori

Complessità di Implementazione

L'SDK richiede una comprensione più profonda dei concetti di stampa mobile e uno sforzo di sviluppo significativamente maggiore rispetto all'Intent API. La tua applicazione deve fornire UI completa per la scoperta delle stampanti, visualizzare capacità e opzioni della stampante, gestire download e installazione dei driver, gestire il ciclo di vita dei lavori di stampa e implementare gestione degli errori e recupero. Tuttavia, questo sforzo è ricompensato con flessibilità e controllo senza pari.

Struttura SDK

L'SDK di PrintHand è fornito come libreria Java che si integra direttamente nella tua applicazione Android. Espone un'API completa per tutte le operazioni di stampa, con documentazione dettagliata che copre gestione stampanti, invio lavori, monitoraggio stato e gestione configurazione. L'SDK è progettato per essere thread-safe ed efficiente, adatto per scenari di stampa ad alto volume.

Casi d'Uso

Perfetto per applicazioni aziendali che richiedono flussi di lavoro di stampa automatizzati, sistemi punto vendita che necessitano di stampa ricevute senza interazione dell'utente, applicazioni logistica e consegna con stampa etichette ad alto volume e soluzioni white-label dove il brand PrintHand non dovrebbe apparire.

Requisiti

Gli utenti necessitano dell'applicazione PrintHand o del servizio di stampa standalone PrintHand installato sul loro dispositivo con una licenza valida. La tua applicazione deve includere la libreria SDK nel tuo progetto e richiede comprensione dei protocolli di comunicazione delle stampanti e dell'architettura di stampa Android per un'implementazione ottimale.

Codice di Esempio e Risorse

Per aiutarti a iniziare con l'integrazione di PrintHand, abbiamo creato un'applicazione di esempio completa che dimostra i tre metodi di integrazione. Il codice di esempio mostra le migliori pratiche per implementare ogni approccio, gestire casi limite e fornire un'ottima esperienza utente.

Repository GitHub

Il nostro repository PrintingSample contiene esempi funzionanti di Share Intent, Intent API e integrazione SDK. Il codice è ben documentato e dimostra pattern di utilizzo del mondo reale. Visita il nostro repository GitHub su:

github.com/DynamixSoftware/PrintingSample

Documentazione

Documentazione dettagliata dell'API, guide di integrazione e risorse per la risoluzione dei problemi sono disponibili nella wiki del repository. Aggiorniamo regolarmente la documentazione in base ai feedback degli sviluppatori e alle nuove versioni di Android.

Supporto

Per domande tecniche, assistenza all'integrazione o per segnalare problemi, contatta il nostro team di supporto sviluppatori all'indirizzo support@printhand.com. Siamo qui per aiutarti a integrare con successo PrintHand nella tua applicazione.