Jalur tercepat untuk menambahkan kemampuan pencetakan ke aplikasi Android Anda. Dengan memanfaatkan mekanisme Share Intent standar Android, aplikasi Anda dapat menawarkan fungsionalitas pencetakan tanpa menulis satu baris kode khusus PrintHand. Ketika pengguna membagikan konten yang cocok untuk dicetak dari aplikasi Anda, PrintHand secara otomatis muncul sebagai salah satu opsi berbagi, sama seperti aplikasi email atau media sosial.

Pendekatan ini ideal untuk aplikasi yang ingin menyediakan pencetakan dengan upaya pengembangan minimal. Banyak aplikasi mapan tanpa koneksi langsung ke PrintHand menggunakan metode ini untuk memungkinkan pengguna mereka mencetak dokumen, gambar, dan konten lainnya. Keindahan integrasi ini adalah kesederhanaannya: jika aplikasi Anda sudah mengimplementasikan fungsionalitas berbagi Android untuk tujuan lain, pencetakan datang secara gratis.

Cara Kerja

Ketika pengguna memilih "Bagikan" di aplikasi Anda dan memilih PrintHand dari daftar aplikasi yang tersedia, Android meneruskan konten ke PrintHand. PrintHand kemudian menangani seluruh alur kerja pencetakan: merender konten, menampilkan pratinjau, memungkinkan pengguna mengonfigurasi pengaturan printer, dan akhirnya mengirim pekerjaan ke printer yang dipilih. Aplikasi Anda cukup memulai tindakan berbagi dan PrintHand menangani sisanya.

Jenis Konten yang Didukung

• Gambar: JPEG, PNG, GIF, dan format gambar standar lainnya
• Dokumen: File PDF dan teks biasa
• Konten Web: URL dan konten HTML
• Data Kustom: Konten apa pun yang dapat dibagikan aplikasi Anda melalui intent standar Android

Persyaratan

Pengguna harus memiliki aplikasi PrintHand yang terinstal di perangkat mereka dengan lisensi yang valid untuk mencetak. Aplikasi Anda tidak memerlukan izin khusus atau dependensi, hanya implementasi Share Intent standar Android yang sudah digunakan sebagian besar aplikasi.

Implementasi

Jika aplikasi Anda sudah mengimplementasikan fungsionalitas berbagi Android, tidak diperlukan kode tambahan. Jika tidak, mengimplementasikan tindakan berbagi dasar sangat mudah menggunakan API standar ShareCompat atau Intent.ACTION_SEND Android. Dokumentasi PrintHand dan kode contoh menyediakan contoh implementasi yang tepat.

Intent API menyediakan titik tengah yang kuat antara berbagi tanpa kode dan integrasi SDK penuh. Ini memungkinkan aplikasi Anda menemukan printer secara programatik, mengonfigurasi opsi pencetakan, dan memulai pekerjaan pencetakan, semuanya sambil mempertahankan kontrol atas antarmuka pengguna dan alur kerja aplikasi Anda. Ini adalah metode integrasi yang paling umum digunakan untuk pengembang yang menginginkan kontrol signifikan tanpa kompleksitas operasi pencetakan tingkat rendah.

Dengan Intent API, Anda dapat membuat dialog pemilihan printer kustom, membuat preset pengaturan pencetakan, dan mengintegrasikan pencetakan dengan mulus ke dalam alur kerja aplikasi Anda yang ada. Aplikasi Anda berkomunikasi dengan PrintHand melalui serangkaian intent yang terdefinisi dengan baik yang menangani penemuan printer, konfigurasi opsi, rendering konten, dan pengiriman pekerjaan. PrintHand memproses permintaan ini dan mengembalikan hasil ke aplikasi Anda, memungkinkan Anda mempertahankan kontrol penuh atas pengalaman pengguna.

Kemampuan Utama

• Penemuan Printer: Temukan printer yang tersedia secara programatik melalui WiFi, Bluetooth, dan USB
• Konfigurasi Pengaturan: Kontrol ukuran kertas, orientasi, kualitas, mode warna, dan opsi khusus printer lainnya
• Rendering Konten: Biarkan PrintHand menangani rendering dokumen yang kompleks atau kirim konten yang sudah dirender
• Manajemen Pekerjaan Cetak: Mulai pencetakan, pantau status, dan tangani hasil

Alur Kerja Integrasi

Aplikasi Anda mengirim intent ke layanan Intent API PrintHand untuk melakukan operasi tertentu. Misalnya, untuk mencetak dokumen, aplikasi Anda: menemukan printer yang tersedia dan menyajikannya di UI Anda, memungkinkan pengguna memilih printer dan mengonfigurasi opsi, mengirim intent cetak dengan konten dan pengaturan yang dipilih, dan menerima konfirmasi saat pekerjaan cetak selesai. Setiap langkah menggunakan komunikasi Intent standar Android, membuat integrasi menjadi langsung untuk pengembang Android.

Kasus Penggunaan

Intent API sempurna untuk aplikasi dengan konten kompleks seperti dokumen kantor, peta, formulir kustom, atau laporan yang memerlukan rendering khusus aplikasi. Ini juga ideal ketika Anda ingin mengatur opsi pencetakan berdasarkan jenis dokumen atau preferensi pengguna, atau ketika Anda perlu mengintegrasikan pencetakan ke dalam alur kerja multi-langkah di mana pengguna tidak boleh meninggalkan aplikasi Anda.

Persyaratan

Pengguna memerlukan aplikasi PrintHand yang terinstal dengan lisensi yang valid. Aplikasi Anda harus menyertakan deklarasi layanan Intent API PrintHand di manifes Anda dan mengimplementasikan protokol komunikasi intent seperti yang didokumentasikan dalam referensi API dan kode contoh kami.

SDK PrintHand menyediakan akses langsung tingkat rendah ke mesin pencetakan kami, menawarkan fleksibilitas dan kontrol maksimum untuk aplikasi canggih. Tidak seperti Intent API yang bergantung pada komponen UI PrintHand, SDK memberi Anda kebebasan penuh untuk merancang setiap aspek pengalaman pencetakan. Pendekatan ini ideal untuk aplikasi perusahaan, solusi white-label, atau aplikasi apa pun yang memerlukan pencetakan terjadi secara diam-diam di latar belakang tanpa interaksi pengguna.

Dengan SDK, Anda mendapatkan kontrol granular atas setiap aspek proses pencetakan: deteksi dan penyaringan printer, manajemen dan instalasi driver, antrian dan prioritas pekerjaan cetak, penanganan kesalahan kustom dan pemulihan. Aplikasi Anda menjadi sepenuhnya bertanggung jawab atas seluruh alur kerja pencetakan, dari menyajikan opsi printer kepada pengguna hingga menangani penyelesaian pekerjaan dan kesalahan.

Kemampuan Lanjutan

• Kontrol UI Penuh: Bangun antarmuka kustom penemuan printer, konfigurasi, dan pratinjau yang sesuai dengan desain aplikasi Anda
• Pencetakan Latar Belakang: Jalankan pekerjaan cetak tanpa interaksi pengguna atau komponen UI
• Manajemen Driver: Unduh dan kelola driver printer secara programatik untuk perangkat yang kompatibel
• Rendering Kustom: Kontrol penuh atas persiapan konten dan pipeline rendering
• Fitur Perusahaan: Antrian pekerjaan, pencetakan batch, pemilihan printer otomatis, dan penanganan kesalahan kustom

Kompleksitas Implementasi

SDK memerlukan pemahaman yang lebih mendalam tentang konsep pencetakan mobile dan upaya pengembangan yang jauh lebih signifikan daripada Intent API. Aplikasi Anda harus menyediakan UI lengkap untuk penemuan printer, menampilkan kemampuan dan opsi printer, menangani unduhan dan instalasi driver, mengelola siklus hidup pekerjaan cetak, dan mengimplementasikan penanganan kesalahan dan pemulihan. Namun, upaya ini dibalas dengan fleksibilitas dan kontrol yang tak tertandingi.

Struktur SDK

SDK PrintHand disediakan sebagai pustaka Java yang terintegrasi langsung ke dalam aplikasi Android Anda. Ini mengekspos API lengkap untuk semua operasi pencetakan, dengan dokumentasi terperinci yang mencakup manajemen printer, pengiriman pekerjaan, pemantauan status, dan manajemen konfigurasi. SDK dirancang agar thread-safe dan efisien, cocok untuk skenario pencetakan volume tinggi.

Kasus Penggunaan

Sempurna untuk aplikasi perusahaan yang memerlukan alur kerja pencetakan otomatis, sistem point-of-sale yang memerlukan pencetakan tanda terima tanpa interaksi pengguna, aplikasi logistik dan pengiriman dengan pencetakan label volume tinggi, dan solusi white-label di mana merek PrintHand tidak boleh muncul.

Persyaratan

Pengguna memerlukan aplikasi PrintHand atau layanan pencetakan mandiri PrintHand yang terinstal di perangkat mereka dengan lisensi yang valid. Aplikasi Anda harus menyertakan pustaka SDK dalam proyek Anda dan memerlukan pemahaman tentang protokol komunikasi printer dan arsitektur pencetakan Android untuk implementasi optimal.

Kode Contoh dan Sumber Daya

Untuk membantu Anda memulai integrasi PrintHand, kami telah membuat aplikasi contoh lengkap yang mendemonstrasikan ketiga metode integrasi. Kode contoh menunjukkan praktik terbaik untuk mengimplementasikan setiap pendekatan, menangani kasus tepi, dan memberikan pengalaman pengguna yang luar biasa.

Repositori GitHub

Repositori PrintingSample kami berisi contoh yang berfungsi dari Share Intent, Intent API, dan integrasi SDK. Kode terdokumentasi dengan baik dan mendemonstrasikan pola penggunaan dunia nyata. Kunjungi repositori GitHub kami di:

github.com/DynamixSoftware/PrintingSample

Dokumentasi

Dokumentasi API terperinci, panduan integrasi, dan sumber daya pemecahan masalah tersedia di wiki repositori. Kami secara teratur memperbarui dokumentasi berdasarkan umpan balik pengembang dan rilis Android baru.

Dukungan

Untuk pertanyaan teknis, bantuan integrasi, atau untuk melaporkan masalah, hubungi tim dukungan pengembang kami di support@printhand.com. Kami di sini untuk membantu Anda mengintegrasikan PrintHand dengan sukses ke dalam aplikasi Anda.