سریع‌ترین مسیر برای افزودن قابلیت‌های چاپ به برنامه Android شما. با استفاده از مکانیزم استاندارد Share Intent در Android، برنامه شما می‌تواند قابلیت چاپ را بدون نوشتن یک خط کد خاص PrintHand ارائه دهد. هنگامی که کاربران محتوای مناسب برای چاپ را از برنامه شما به اشتراک می‌گذارند، PrintHand به‌طور خودکار به عنوان یکی از گزینه‌های اشتراک‌گذاری ظاهر می‌شود، درست مانند برنامه‌های ایمیل یا شبکه‌های اجتماعی.

این رویکرد برای برنامه‌هایی که می‌خواهند چاپ را با حداقل تلاش توسعه ارائه دهند ایده‌آل است. بسیاری از برنامه‌های تثبیت شده بدون ارتباط مستقیم با PrintHand از این روش برای فعال کردن چاپ اسناد، تصاویر و سایر محتوا توسط کاربران خود استفاده می‌کنند. زیبایی این یکپارچگی در سادگی آن است: اگر برنامه شما از قبل قابلیت اشتراک‌گذاری Android را برای اهداف دیگر پیاده‌سازی کرده است، چاپ رایگان ارائه می‌شود.

نحوه کار

وقتی کاربر "اشتراک‌گذاری" را در برنامه شما انتخاب می‌کند و PrintHand را از لیست برنامه‌های موجود انتخاب می‌کند، Android محتوا را به PrintHand منتقل می‌کند. PrintHand سپس کل گردش کار چاپ را مدیریت می‌کند: رندر محتوا، نمایش پیش‌نمایش، اجازه دادن به کاربر برای پیکربندی تنظیمات چاپگر و در نهایت ارسال کار به چاپگر انتخاب شده. برنامه شما فقط عمل اشتراک‌گذاری را آغاز می‌کند و PrintHand بقیه را انجام می‌دهد.

انواع محتوای پشتیبانی شده

• تصاویر: JPEG، PNG، GIF و سایر فرمت‌های استاندارد تصویر
• اسناد: فایل‌های PDF و متن ساده
• محتوای وب: URL ها و محتوای HTML
• داده‌های سفارشی: هر محتوایی که برنامه شما می‌تواند از طریق intent های استاندارد Android به اشتراک بگذارد

الزامات

کاربران باید برنامه PrintHand را با یک لایسنس معتبر برای چاپ روی دستگاه خود نصب کرده باشند. برنامه شما نیازی به مجوزهای خاص یا وابستگی‌ها ندارد، فقط پیاده‌سازی استاندارد Share Intent در Android که اکثر برنامه‌ها از قبل استفاده می‌کنند.

پیاده‌سازی

اگر برنامه شما از قبل قابلیت اشتراک‌گذاری Android را پیاده‌سازی کرده است، کد اضافی لازم نیست. اگر نه، پیاده‌سازی یک عمل اشتراک‌گذاری اولیه با استفاده از APIهای استاندارد ShareCompat یا Intent.ACTION_SEND در Android ساده است. مستندات PrintHand و کد نمونه مثال‌هایی از پیاده‌سازی صحیح ارائه می‌دهند.

Intent API یک نقطه میانی قدرتمند بین اشتراک‌گذاری بدون کد و یکپارچگی کامل SDK فراهم می‌کند. به برنامه شما اجازه می‌دهد تا به‌صورت برنامه‌نویسی چاپگرها را کشف کند، گزینه‌های چاپ را پیکربندی کرده و کارهای چاپ را آغاز کند، همه در حالی که کنترل رابط کاربری و گردش کار برنامه خود را حفظ می‌کنید. این معمولاً روش یکپارچگی رایج برای توسعه‌دهندگانی است که کنترل قابل‌توجهی می‌خواهند بدون پیچیدگی عملیات چاپ سطح پایین.

با Intent API، می‌توانید دیالوگ‌های انتخاب چاپگر سفارشی بسازید، تنظیمات چاپ از پیش تعریف شده ایجاد کنید و چاپ را به‌طور یکپارچه در گردش کار موجود برنامه خود ادغام کنید. برنامه شما از طریق یک سری intent های کاملاً تعریف شده که کشف چاپگر، پیکربندی گزینه‌ها، رندر محتوا و ارسال کار را مدیریت می‌کنند با PrintHand ارتباط برقرار می‌کند. PrintHand این درخواست‌ها را پردازش کرده و نتایج را به برنامه شما برمی‌گرداند و به شما اجازه می‌دهد کنترل کامل بر تجربه کاربر را حفظ کنید.

قابلیت‌های کلیدی

• کشف چاپگر: کشف برنامه‌نویسی چاپگرهای موجود از طریق WiFi، Bluetooth و USB
• پیکربندی تنظیمات: کنترل اندازه کاغذ، جهت، کیفیت، حالت رنگ و سایر گزینه‌های خاص چاپگر
• رندر محتوا: اجازه دهید PrintHand رندر پیچیده اسناد را مدیریت کند یا محتوای از پیش رندر شده را ارسال کنید
• مدیریت کار چاپ: چاپ را شروع کنید، وضعیت را نظارت کرده و نتایج را مدیریت کنید

گردش کار یکپارچگی

برنامه شما intent ها را به سرویس Intent API در PrintHand برای انجام عملیات خاص ارسال می‌کند. به عنوان مثال، برای چاپ یک سند، برنامه شما: چاپگرهای موجود را کشف کرده و آن‌ها را در UI خود ارائه می‌دهد، به کاربر اجازه می‌دهد یک چاپگر را انتخاب کرده و گزینه‌ها را پیکربندی کند، یک intent چاپ با محتوا و تنظیمات انتخاب شده ارسال می‌کند و تأیید را هنگام تکمیل کار چاپ دریافت می‌کند. هر مرحله از ارتباط استاندارد Intent در Android استفاده می‌کند و یکپارچگی را برای توسعه‌دهندگان Android ساده می‌سازد.

موارد استفاده

Intent API برای برنامه‌هایی با محتوای پیچیده مانند اسناد اداری، نقشه‌ها، فرم‌های سفارشی یا گزارش‌هایی که به رندر خاص برنامه نیاز دارند مناسب است. همچنین زمانی ایده‌آل است که می‌خواهید گزینه‌های چاپ را بر اساس نوع سند یا ترجیحات کاربر از پیش تنظیم کنید، یا زمانی که نیاز دارید چاپ را در گردش کار چند مرحله‌ای ادغام کنید که کاربران نباید از برنامه شما خارج شوند.

الزامات

کاربران نیاز دارند برنامه PrintHand را با یک لایسنس معتبر نصب کرده باشند. برنامه شما باید اعلامیه‌های سرویس Intent API در PrintHand را در manifest خود شامل کند و پروتکل ارتباط intent را همانطور که در مرجع API و کد نمونه ما مستند شده است پیاده‌سازی کند.

SDK در PrintHand دسترسی مستقیم سطح پایین به موتور چاپ ما را فراهم می‌کند و حداکثر انعطاف‌پذیری و کنترل را برای برنامه‌های پیچیده ارائه می‌دهد. بر خلاف Intent API که به اجزای UI در PrintHand وابسته است، SDK آزادی کامل برای طراحی هر جنبه از تجربه چاپ را به شما می‌دهد. این رویکرد برای برنامه‌های سازمانی، راهکارهای برچسب سفید یا هر برنامه‌ای که نیاز دارد چاپ به‌طور نامرئی در پس‌زمینه بدون تعامل کاربر انجام شود ایده‌آل است.

با SDK، کنترل دقیق بر هر جنبه از فرآیند چاپ دریافت می‌کنید: تشخیص و فیلتر چاپگر، مدیریت و نصب درایور، صف‌بندی و اولویت‌بندی کار چاپ، مدیریت سفارشی خطا و بازیابی. برنامه شما کاملاً مسئول کل گردش کار چاپ می‌شود، از ارائه گزینه‌های چاپگر به کاربر تا مدیریت تکمیل کار و خطاها.

قابلیت‌های پیشرفته

• کنترل کامل UI: رابط‌های سفارشی کشف چاپگر، پیکربندی و پیش‌نمایش بسازید که با طراحی برنامه شما مطابقت داشته باشد
• چاپ در پس‌زمینه: کارهای چاپ را بدون هیچ تعامل کاربر یا اجزای UI اجرا کنید
• مدیریت درایور: به‌صورت برنامه‌نویسی درایورهای چاپگر را برای دستگاه‌های پشتیبانی شده دانلود و مدیریت کنید
• رندر سفارشی: کنترل کامل بر آماده‌سازی محتوا و خط لوله رندر
• ویژگی‌های سازمانی: صف‌بندی کار، چاپ دسته‌ای، انتخاب خودکار چاپگر و مدیریت سفارشی خطا

پیچیدگی پیاده‌سازی

SDK نیاز به درک عمیق‌تر از مفاهیم چاپ موبایل و تلاش توسعه قابل‌توجهی بیشتر از Intent API دارد. برنامه شما باید UI کامل برای کشف چاپگر، نمایش قابلیت‌ها و گزینه‌های چاپگر، مدیریت دانلود و نصب درایور، مدیریت چرخه عمر کار چاپ و پیاده‌سازی مدیریت خطا و بازیابی را فراهم کند. با این حال، این تلاش با انعطاف‌پذیری و کنترل بی‌نظیر پاداش داده می‌شود.

ساختار SDK

SDK در PrintHand به عنوان یک کتابخانه Java ارائه می‌شود که مستقیماً در برنامه Android شما یکپارچه می‌شود. یک API جامع برای تمام عملیات چاپ را با مستندات دقیق که مدیریت چاپگر، ارسال کار، نظارت وضعیت و مدیریت پیکربندی را پوشش می‌دهد، در معرض دید قرار می‌دهد. SDK طراحی شده تا thread-safe و کارآمد باشد و برای سناریوهای چاپ با حجم بالا مناسب است.

موارد استفاده

مناسب برای برنامه‌های سازمانی که به گردش کار چاپ خودکار نیاز دارند، سیستم‌های فروشگاهی که به چاپ رسید بدون تعامل کاربر نیاز دارند، برنامه‌های لجستیک و تحویل با چاپ برچسب با حجم بالا و راهکارهای برچسب سفید که نباید برند PrintHand ظاهر شود.

الزامات

کاربران نیاز دارند یا برنامه PrintHand یا سرویس چاپ مستقل PrintHand را با یک لایسنس معتبر روی دستگاه خود نصب کرده باشند. برنامه شما باید کتابخانه SDK را در پروژه خود شامل کند و نیاز به درک پروتکل‌های ارتباط چاپگر و معماری چاپ Android برای پیاده‌سازی بهینه دارد.

کد نمونه و منابع

برای کمک به شروع یکپارچگی PrintHand، یک برنامه نمونه جامع ایجاد کرده‌ایم که هر سه روش یکپارچگی را نشان می‌دهد. کد نمونه بهترین شیوه‌ها برای پیاده‌سازی هر رویکرد، مدیریت موارد استثنا و ارائه تجربه کاربری عالی را نشان می‌دهد.

مخزن GitHub

مخزن PrintingSample ما شامل مثال‌های کاربردی از Share Intent، Intent API و یکپارچگی SDK است. کد به خوبی مستند شده و الگوهای استفاده دنیای واقعی را نشان می‌دهد. مخزن GitHub ما را در اینجا ملاحظه کنید:

github.com/DynamixSoftware/PrintingSample

مستندات

مستندات دقیق API، راهنماهای یکپارچگی و منابع عیب‌یابی در wiki مخزن موجود است. ما به‌طور منظم مستندات را بر اساس بازخورد توسعه‌دهندگان و نسخه‌های جدید Android به‌روزرسانی می‌کنیم.

پشتیبانی

برای سؤالات فنی، کمک یکپارچگی یا گزارش مشکلات، با تیم پشتیبانی توسعه‌دهنده ما در support@printhand.com تماس بگیرید. ما اینجا هستیم تا به شما در یکپارچگی موفق PrintHand در برنامه خود کمک کنیم.