Laluan paling cepat untuk menambah keupayaan pencetakan ke aplikasi Android anda. Dengan menggunakan mekanisme Share Intent standard Android, aplikasi anda boleh menawarkan fungsi pencetakan tanpa menulis satu baris kod khusus PrintHand. Apabila pengguna berkongsi kandungan yang sesuai untuk dicetak dari aplikasi anda, PrintHand muncul secara automatik sebagai salah satu pilihan perkongsian, sama seperti aplikasi e-mel atau media sosial.

Pendekatan ini sesuai untuk aplikasi yang ingin menyediakan pencetakan dengan usaha pembangunan minimum. Banyak aplikasi yang mantap tanpa sambungan langsung dengan PrintHand menggunakan kaedah ini untuk membolehkan pengguna mereka mencetak dokumen, imej dan kandungan lain. Keindahan integrasi ini adalah kesederhanaannya: jika aplikasi anda sudah melaksanakan fungsi perkongsian Android untuk tujuan lain, pencetakan datang secara percuma.

Cara Ia Berfungsi

Apabila pengguna memilih "Kongsi" dalam aplikasi anda dan memilih PrintHand dari senarai aplikasi yang tersedia, Android menghantar kandungan ke PrintHand. PrintHand kemudian mengendalikan keseluruhan aliran kerja pencetakan: merender kandungan, memaparkan pratonton, membenarkan pengguna mengkonfigurasi tetapan pencetak dan akhirnya menghantar kerja ke pencetak yang dipilih. Aplikasi anda hanya memulakan tindakan perkongsian dan PrintHand mengendalikan semua yang lain.

Jenis Kandungan yang Disokong

• Imej: JPEG, PNG, GIF dan format imej standard lain
• Dokumen: Fail PDF dan teks biasa
• Kandungan Web: URL dan kandungan HTML
• Data Tersuai: Apa-apa kandungan yang aplikasi anda boleh kongsi melalui intent standard Android

Keperluan

Pengguna mesti mempunyai aplikasi PrintHand dipasang pada peranti mereka dengan lesen yang sah untuk mencetak. Aplikasi anda tidak memerlukan kebenaran khas atau kebergantungan, hanya pelaksanaan Share Intent standard Android yang kebanyakan aplikasi sudah gunakan.

Pelaksanaan

Jika aplikasi anda sudah melaksanakan fungsi perkongsian Android, tiada kod tambahan diperlukan. Jika tidak, melaksanakan tindakan perkongsian asas adalah mudah menggunakan API ShareCompat atau Intent.ACTION_SEND standard Android. Dokumentasi PrintHand dan kod contoh menyediakan contoh pelaksanaan yang sesuai.

Intent API menyediakan titik tengah yang berkuasa antara perkongsian tanpa kod dan integrasi SDK penuh. Ia membolehkan aplikasi anda menemui pencetak secara programatik, mengkonfigurasi pilihan pencetakan dan memulakan kerja pencetakan, semua sambil mengekalkan kawalan ke atas antara muka pengguna dan aliran kerja aplikasi anda. Ini adalah kaedah integrasi yang paling biasa digunakan untuk pembangun yang mahukan kawalan penting tanpa kerumitan operasi pencetakan aras rendah.

Dengan Intent API, anda boleh mencipta dialog pemilihan pencetak tersuai, membuat pratetap konfigurasi pencetakan dan mengintegrasikan pencetakan dengan lancar ke dalam aliran kerja sedia ada aplikasi anda. Aplikasi anda berkomunikasi dengan PrintHand melalui siri intent yang ditakrifkan dengan baik yang mengendalikan penemuan pencetak, konfigurasi pilihan, rendering kandungan dan penghantaran kerja. PrintHand memproses permintaan ini dan mengembalikan hasil kepada aplikasi anda, membolehkan anda mengekalkan kawalan penuh ke atas pengalaman pengguna.

Keupayaan Utama

• Penemuan Pencetak: Temui pencetak yang tersedia secara programatik melalui WiFi, Bluetooth dan USB
• Konfigurasi Tetapan: Kawal saiz kertas, orientasi, kualiti, mod warna dan pilihan khusus pencetak lain
• Rendering Kandungan: Biarkan PrintHand mengendalikan rendering dokumen yang kompleks atau hantar kandungan pra-render
• Pengurusan Kerja Pencetakan: Mulakan pencetakan, pantau status dan kendalikan hasil

Aliran Kerja Integrasi

Aplikasi anda menghantar intent ke perkhidmatan Intent API PrintHand untuk melakukan operasi tertentu. Sebagai contoh, untuk mencetak dokumen, aplikasi anda: akan menemui pencetak yang tersedia dan membentangkannya dalam UI anda, membenarkan pengguna memilih pencetak dan mengkonfigurasi pilihan, menghantar intent pencetakan dengan kandungan dan konfigurasi yang dipilih, dan menerima pengesahan apabila kerja pencetakan selesai. Setiap langkah menggunakan komunikasi Intent standard Android, menjadikan integrasi mudah untuk pembangun Android.

Kes Penggunaan

Intent API sempurna untuk aplikasi dengan kandungan kompleks seperti dokumen pejabat, peta, borang tersuai atau laporan yang memerlukan rendering khusus aplikasi. Ia juga sesuai apabila anda ingin menetapkan pilihan pencetakan berdasarkan jenis dokumen atau pilihan pengguna, atau apabila anda perlu mengintegrasikan pencetakan ke dalam aliran kerja berbilang langkah di mana pengguna tidak sepatutnya keluar dari aplikasi anda.

Keperluan

Pengguna memerlukan aplikasi PrintHand dipasang dengan lesen yang sah. Aplikasi anda mesti memasukkan pengisytiharan perkhidmatan Intent API PrintHand dalam manifes anda dan melaksanakan protokol komunikasi intent seperti yang didokumenkan dalam rujukan API dan kod contoh kami.

SDK PrintHand menyediakan akses terus aras rendah kepada enjin pencetakan kami, menawarkan fleksibiliti dan kawalan maksimum untuk aplikasi yang canggih. Tidak seperti Intent API yang bergantung kepada komponen UI PrintHand, SDK memberi anda kebebasan penuh untuk mereka setiap aspek pengalaman pencetakan. Pendekatan ini sesuai untuk aplikasi perusahaan, penyelesaian label putih atau mana-mana aplikasi yang memerlukan pencetakan berlaku secara senyap di latar belakang tanpa interaksi pengguna.

Dengan SDK, anda mendapat kawalan terperinci ke atas setiap aspek proses pencetakan: pengesanan dan penapisan pencetak, pengurusan dan pemasangan pemacu, penyenaraian dan keutamaan kerja pencetakan, pengendalian ralat tersuai dan pemulihan. Aplikasi anda menjadi sepenuhnya bertanggungjawab untuk keseluruhan aliran kerja pencetakan, dari membentangkan pilihan pencetak kepada pengguna hingga mengendalikan penyiapan kerja dan ralat.

Keupayaan Lanjutan

• Kawalan Penuh UI: Bina antara muka tersuai penemuan pencetak, konfigurasi dan pratonton yang sepadan dengan reka bentuk aplikasi anda
• Pencetakan Latar Belakang: Jalankan kerja pencetakan tanpa sebarang interaksi pengguna atau komponen UI
• Pengurusan Pemacu: Muat turun dan urus pemacu pencetak secara programatik untuk peranti yang disokong
• Rendering Tersuai: Kawalan penuh ke atas penyediaan kandungan dan pipeline rendering
• Fungsi Perusahaan: Penyenaraian kerja, pencetakan kelompok, pemilihan pencetak automatik dan pengendalian ralat tersuai

Kerumitan Pelaksanaan

SDK memerlukan pemahaman yang lebih mendalam tentang konsep pencetakan mudah alih dan usaha pembangunan yang lebih besar daripada Intent API. Aplikasi anda mesti menyediakan UI lengkap untuk penemuan pencetak, memaparkan keupayaan dan pilihan pencetak, mengendalikan muat turun dan pemasangan pemacu, mengurus kitaran hayat kerja pencetakan, dan melaksanakan pengendalian ralat dan pemulihan. Walau bagaimanapun, usaha ini diberi ganjaran dengan fleksibiliti dan kawalan yang tiada tandingan.

Struktur SDK

SDK PrintHand disediakan sebagai perpustakaan Java yang diintegrasikan terus ke dalam aplikasi Android anda. Ia mendedahkan API lengkap untuk semua operasi pencetakan, dengan dokumentasi terperinci yang meliputi pengurusan pencetak, penghantaran kerja, pemantauan status dan pengurusan konfigurasi. SDK direka untuk selamat-thread dan cekap, sesuai untuk senario pencetakan volum tinggi.

Kes Penggunaan

Sempurna untuk aplikasi perusahaan yang memerlukan aliran kerja pencetakan automatik, sistem tempat jualan yang memerlukan pencetakan resit tanpa interaksi pengguna, aplikasi logistik dan penghantaran dengan pencetakan label volum tinggi, dan penyelesaian label putih di mana jenama PrintHand tidak sepatutnya muncul.

Keperluan

Pengguna memerlukan sama ada aplikasi PrintHand atau perkhidmatan pencetakan bebas PrintHand dipasang pada peranti mereka dengan lesen yang sah. Aplikasi anda mesti memasukkan perpustakaan SDK dalam projek anda dan memerlukan pemahaman protokol komunikasi pencetak dan seni bina pencetakan Android untuk pelaksanaan optimum.

Kod Contoh dan Sumber

Untuk membantu anda bermula dengan integrasi PrintHand, kami telah mencipta aplikasi contoh komprehensif yang menunjukkan ketiga-tiga kaedah integrasi. Kod contoh mempamerkan amalan terbaik untuk melaksanakan setiap pendekatan, mengendalikan kes pinggir dan menyediakan pengalaman pengguna yang hebat.

Repositori GitHub

Repositori PrintingSample kami mengandungi contoh berfungsi Share Intent, Intent API dan integrasi SDK. Kod didokumenkan dengan baik dan menunjukkan corak penggunaan dunia sebenar. Lawati repositori GitHub kami di:

github.com/DynamixSoftware/PrintingSample

Dokumentasi

Dokumentasi API terperinci, panduan integrasi dan sumber penyelesaian masalah tersedia di wiki repositori. Kami mengemas kini dokumentasi secara berkala berdasarkan maklum balas pembangun dan keluaran Android baharu.

Sokongan

Untuk soalan teknikal, bantuan integrasi atau untuk melaporkan isu, hubungi pasukan sokongan pembangun kami di support@printhand.com. Kami di sini untuk membantu anda mengintegrasikan PrintHand dengan jayanya ke dalam aplikasi anda.