أسرع مسار لإضافة قدرات الطباعة إلى تطبيق Android الخاص بك. باستخدام آلية Share Intent القياسية في Android، يمكن لتطبيقك تقديم وظائف الطباعة دون كتابة سطر واحد من كود PrintHand المحدد. عندما يشارك المستخدمون محتوى قابل للطباعة من تطبيقك، يظهر PrintHand تلقائيًا كأحد خيارات المشاركة، تمامًا مثل تطبيقات البريد الإلكتروني أو وسائل التواصل الاجتماعي.

هذا النهج مثالي للتطبيقات التي ترغب في توفير الطباعة بأقل جهد تطوير. تستخدم العديد من التطبيقات الراسخة التي ليس لها اتصال مباشر مع PrintHand هذه الطريقة للسماح لمستخدميها بطباعة المستندات والصور والمحتوى الآخر. جمال هذا التكامل هو بساطته: إذا كان تطبيقك يطبق بالفعل وظائف المشاركة في Android لأغراض أخرى، فالطباعة تأتي مجانًا.

كيف يعمل

عندما يختار المستخدم "مشاركة" في تطبيقك ويختار PrintHand من قائمة التطبيقات المتاحة، يمرر Android المحتوى إلى PrintHand. ثم يتعامل PrintHand مع سير عمل الطباعة بالكامل: عرض المحتوى، وعرض معاينة، والسماح للمستخدم بتكوين إعدادات الطابعة، وأخيراً إرسال المهمة إلى الطابعة المحددة. تطبيقك ببساطة يبدأ إجراء المشاركة و PrintHand يتولى كل شيء آخر.

أنواع المحتوى المدعوم

• الصور: JPEG و PNG و GIF وتنسيقات الصور القياسية الأخرى
• المستندات: ملفات PDF والنص العادي
• محتوى الويب: عناوين URL ومحتوى HTML
• البيانات المخصصة: أي محتوى يمكن لتطبيقك مشاركته من خلال intents قياسية في Android

المتطلبات

يجب أن يكون لدى المستخدمين تطبيق PrintHand مثبتًا على أجهزتهم مع ترخيص صالح للطباعة. لا يتطلب تطبيقك أذونات خاصة أو تبعيات، فقط تطبيق Share Intent القياسي في Android الذي تستخدمه معظم التطبيقات بالفعل.

التنفيذ

إذا كان تطبيقك يطبق بالفعل وظائف المشاركة في Android، فلا حاجة إلى كود إضافي. إذا لم يكن كذلك، فإن تنفيذ إجراء مشاركة أساسي أمر بسيط باستخدام ShareCompat أو Intent.ACTION_SEND القياسية في Android. توفر وثائق PrintHand ورمز العينة أمثلة على التنفيذ الصحيح.

توفر Intent API نقطة وسطى قوية بين المشاركة بدون كود والتكامل الكامل لـ SDK. تسمح لتطبيقك باكتشاف الطابعات برمجيًا وتكوين خيارات الطباعة وبدء مهام الطباعة، كل ذلك مع الحفاظ على التحكم في واجهة المستخدم وسير العمل لتطبيقك. هذه هي طريقة التكامل الأكثر استخدامًا للمطورين الذين يريدون تحكمًا كبيرًا دون تعقيد عمليات الطباعة منخفضة المستوى.

مع Intent API، يمكنك إنشاء مربعات حوار مخصصة لاختيار الطابعة، وإنشاء إعدادات مسبقة للطباعة، ودمج الطباعة بسلاسة في سير عمل تطبيقك الحالي. يتواصل تطبيقك مع PrintHand من خلال سلسلة من intents محددة جيدًا تتعامل مع اكتشاف الطابعة وتكوين الخيارات وعرض المحتوى وإرسال المهام. يعالج PrintHand هذه الطلبات ويعيد النتائج إلى تطبيقك، مما يسمح لك بالحفاظ على التحكم الكامل في تجربة المستخدم.

القدرات الرئيسية

• اكتشاف الطابعات: اكتشف الطابعات المتاحة برمجيًا عبر WiFi و Bluetooth و USB
• تكوين الإعدادات: تحكم في حجم الورق والاتجاه والجودة ووضع الألوان والخيارات الأخرى الخاصة بالطابعة
• عرض المحتوى: اترك PrintHand يتعامل مع عرض المستندات المعقدة أو أرسل محتوى معروضًا مسبقًا
• إدارة مهام الطباعة: ابدأ الطباعة، وراقب الحالة، وتعامل مع النتائج

سير عمل التكامل

يرسل تطبيقك intents إلى خدمة Intent API الخاصة بـ PrintHand لتنفيذ عمليات محددة. على سبيل المثال، لطباعة مستند، سيقوم تطبيقك بما يلي: اكتشاف الطابعات المتاحة وتقديمها في واجهة المستخدم الخاصة بك، والسماح للمستخدم باختيار طابعة وتكوين الخيارات، وإرسال intent طباعة مع المحتوى والإعدادات المحددة، وتلقي التأكيد عند اكتمال مهمة الطباعة. تستخدم كل خطوة اتصال Intent قياسي في Android، مما يجعل التكامل مباشرًا لمطوري Android.

حالات الاستخدام

Intent API مثالي للتطبيقات ذات المحتوى المعقد مثل مستندات المكتب والخرائط والنماذج المخصصة أو التقارير التي تتطلب عرضًا خاصًا بالتطبيق. كما أنه مثالي عندما تريد إعدادات طباعة مسبقة بناءً على نوع المستند أو تفضيلات المستخدم، أو عندما تحتاج إلى دمج الطباعة في سير عمل متعدد الخطوات حيث لا ينبغي للمستخدمين مغادرة تطبيقك.

المتطلبات

يحتاج المستخدمون إلى تطبيق PrintHand المثبت مع ترخيص صالح. يجب أن يتضمن تطبيقك إعلانات خدمة Intent API الخاصة بـ PrintHand في ملف manifest الخاص به وتنفيذ بروتوكول اتصال intent كما هو موثق في مرجع API ورمز العينة الخاص بنا.

يوفر SDK الخاص بـ PrintHand وصولاً مباشرًا منخفض المستوى إلى محرك الطباعة لدينا، مما يوفر أقصى قدر من المرونة والتحكم للتطبيقات المتطورة. على عكس Intent API، التي تعتمد على مكونات واجهة المستخدم الخاصة بـ PrintHand، يمنحك SDK حرية كاملة لتصميم كل جانب من جوانب تجربة الطباعة. هذا النهج مثالي للتطبيقات المؤسسية، وحلول العلامة البيضاء، أو أي تطبيق يتطلب حدوث الطباعة بشكل غير مرئي في الخلفية دون تفاعل المستخدم.

مع SDK، تحصل على تحكم دقيق في كل جانب من جوانب عملية الطباعة: اكتشاف الطابعة والتصفية، وإدارة وتثبيت برامج التشغيل، وقائمة الانتظار وترتيب أولويات مهام الطباعة، ومعالجة الأخطاء المخصصة والاستعادة. يصبح تطبيقك مسؤولاً بالكامل عن سير عمل الطباعة بالكامل، من تقديم خيارات الطابعة للمستخدم إلى معالجة إكمال المهمة والأخطاء.

القدرات المتقدمة

• التحكم الكامل في واجهة المستخدم: قم ببناء واجهات مخصصة لاكتشاف الطابعة والتكوين والمعاينة تتطابق مع تصميم تطبيقك
• الطباعة في الخلفية: قم بتشغيل مهام الطباعة دون أي تفاعل من المستخدم أو مكونات واجهة المستخدم
• إدارة برامج التشغيل: قم بتنزيل وإدارة برامج تشغيل الطابعة برمجيًا للأجهزة المدعومة
• العرض المخصص: تحكم كامل في إعداد المحتوى وخط أنابيب العرض
• ميزات المؤسسة: قوائم انتظار المهام، والطباعة الدُفعية، واختيار الطابعة التلقائي، ومعالجة الأخطاء المخصصة

تعقيد التنفيذ

يتطلب SDK فهمًا أعمق لمفاهيم الطباعة عبر الهاتف المحمول وجهدًا تطويريًا أكبر بكثير من Intent API. يجب أن يوفر تطبيقك واجهة مستخدم كاملة لاكتشاف الطابعة، وعرض قدرات وخيارات الطابعة، ومعالجة تنزيلات وتثبيت برامج التشغيل، وإدارة دورة حياة مهام الطباعة، وتنفيذ معالجة الأخطاء والاستعادة. ومع ذلك، يتم مكافأة هذا الجهد بمرونة وتحكم لا مثيل لهما.

بنية SDK

يتم توفير SDK الخاص بـ PrintHand كمكتبة Java تتكامل مباشرة في تطبيق Android الخاص بك. يعرض API شاملاً لجميع عمليات الطباعة، مع توثيق تفصيلي يغطي إدارة الطابعة وإرسال المهام ومراقبة الحالة وإدارة التكوين. تم تصميم SDK ليكون آمنًا للخيوط وفعالاً، ومناسبًا لسيناريوهات الطباعة عالية الحجم.

حالات الاستخدام

مثالي للتطبيقات المؤسسية التي تتطلب سير عمل طباعة تلقائي، وأنظمة نقاط البيع التي تحتاج إلى طباعة إيصالات دون تفاعل المستخدم، وتطبيقات الخدمات اللوجستية والتوصيل مع طباعة ملصقات عالية الحجم، وحلول العلامة البيضاء حيث لا ينبغي أن تظهر علامة 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 بنجاح في تطبيقك.