เส้นทางที่เร็วที่สุดในการเพิ่มความสามารถในการพิมพ์ในแอป Android ของคุณ โดยการใช้กลไก Share Intent มาตรฐานของ Android แอปของคุณสามารถให้ฟังก์ชันการพิมพ์โดยไม่ต้องเขียนโค้ดเฉพาะของ PrintHand สักบรรทัดเดียว เมื่อผู้ใช้แชร์เนื้อหาที่เหมาะสมสำหรับการพิมพ์จากแอปของคุณ PrintHand จะปรากฏโดยอัตโนมัติเป็นหนึ่งในตัวเลือกการแชร์ เช่นเดียวกับแอปอีเมลหรือโซเชียลมีเดีย

แนวทางนี้เหมาะสำหรับแอปที่ต้องการให้การพิมพ์ด้วยความพยายามในการพัฒนาน้อยที่สุด แอปที่จัดตั้งขึ้นดีหลายแอปที่ไม่มีการเชื่อมต่อโดยตรงกับ PrintHand ใช้วิธีนี้เพื่อให้ผู้ใช้สามารถพิมพ์เอกสาร รูปภาพ และเนื้อหาอื่นๆ ได้ ความงามของการบูรณาการนี้คือความเรียบง่าย: หากแอปของคุณใช้งานฟังก์ชันการแชร์ของ Android อยู่แล้วเพื่อวัตถุประสงค์อื่น การพิมพ์จะมาฟรี

วิธีการทำงาน

เมื่อผู้ใช้เลือก "แชร์" ในแอปของคุณและเลือก PrintHand จากรายการแอปที่มี Android จะส่งเนื้อหาไปยัง PrintHand จากนั้น PrintHand จะดูแลเวิร์กโฟลว์การพิมพ์ทั้งหมด: การเรนเดอร์เนื้อหา การแสดงตัวอย่าง การอนุญาตให้ผู้ใช้กำหนดค่าการตั้งค่าเครื่องพิมพ์ และสุดท้ายส่งงานไปยังเครื่องพิมพ์ที่เลือก แอปของคุณเพียงแค่เริ่มการแชร์และ PrintHand ดูแลทุกอย่างที่เหลือ

ประเภทเนื้���หาที่รองรับ

• รูปภาพ: JPEG, PNG, GIF และรูปแบบภาพมาตรฐานอื่นๆ
• เอกสาร: ไฟล์ PDF และข้อความธรรมดา
• เนื้อหาเว็บ: URLs และเนื้อหา HTML
• ข้อมูลแบบกำหนดเอง: เนื้อหาใดๆ ที่แอปของคุณสามารถแชร์ผ่าน intents มาตรฐานของ Android

ข้อกำหนด

ผู้ใช้ต้องมีแอป PrintHand ติดตั้งในอุปกรณ์ของพวกเขาพร้อมใบอนุญาตที่ถูกต้องเพื่อพิมพ์ แอปของคุณไม่ต้องการสิทธิ์พิเศษหรือการพึ่งพา เพียงแค่การใช้งาน Share Intent มาตรฐานของ Android ที่แอปส่วนใหญ่ใช้อยู่แล้ว

การใช้งาน

หากแอปของคุณใช้งานฟังก์ชันการแชร์ของ Android อยู่แล้ว ไม่ต้องเขียนโค้ดเพิ่มเติม หากไม่ การใช้งานการแชร์พื้นฐานนั้นง่ายดายโดยใช้ ShareCompat มาตรฐานหรือ Intent.ACTION_SEND APIs ของ Android เอกสารและโค้ดตัวอย่างของ PrintHand ให้ตัวอย่างการใช้งานที่เหมาะสม

Intent API ให้จุดกึ่งกลางที่ทรงพลังระหว่างการแชร์แบบไม่ต้องเขียนโค้ดและการบูรณาการ SDK เต็มรูปแบบ ช่วยให้แอปของคุณค้นพบเครื่องพิมพ์แบบโปรแกรม ตั้งค่าตัวเลือกการพิมพ์ และเริ่มงานพิมพ์ ทั้งหมดในขณะที่รักษาการควบคุมอินเทอร์เฟซผู้ใช้และเวิร์กโฟลว์ของแอป นี่คือวิธีการบูรณาการที่ใช้บ่อยที่สุดสำหรับนักพัฒนาที่ต้องการการควบคุมที่มีนัยสำคัญโดยไม่ต้องมีความซับซ้อนของการดำเนินการพิมพ์ระดับต่ำ

ด้วย Intent API คุณสามารถสร้างไดอะล็อกการเลือกเครื่องพิมพ์แบบกำหนดเอง สร้างพรีเซ็ตการตั้งค่าการพิมพ์ และบูรณาการการพิมพ์อย่างราบรื่นเข้ากับเวิร์กโฟลว์ที่มีอยู่ของแอป แอปของคุณสื่อสารกับ PrintHand ผ่าน intents ที่กำหนดไว้อย่างดีซึ่งจัดการการค้นพบเครื่องพิมพ์ การตั้งค่าตัวเลือก การเรนเดอร์เนื้อหา และการส่งงาน PrintHand ประมวลผลคำขอเหล่านี้และส่งผลลัพธ์กลับไปยังแอปของคุณ ทำให้คุณรักษาการควบคุมอย่างเต็มที่เหนือประสบการณ์ผู้ใช้

ความสามารถหลัก

• การค้นพบเครื่องพิมพ์: ค้นพบเครื่องพิมพ์ที่มีแบบโปรแกรมผ่าน WiFi, Bluetooth และ USB
• การตั้งค่าการกำหนดค่า: ควบคุมขนาดกระดาษ การวางแนว คุณภาพ โหมดสี และตัวเลือกเฉพาะเครื่องพิมพ์อื่นๆ
• การเรนเดอร์เนื้อหา: ให้ PrintHand จัดการการเรนเดอร์เอกสารที่ซับซ้อนหรือส่งเนื้อหาที่เรนเดอร์แล้ว
• การจัดการงานพิมพ์: เริ่มการพิมพ์ ตรวจสอบสถานะ และจัดการผลลัพธ์

เวิร์กโฟลว์การบูรณาการ

แอปของคุณส่ง intents ไปยังบริการ Intent API ของ PrintHand เพื่อดำเนินการเฉพาะ ตัวอย่างเช่น ในการพิมพ์เอกสาร แอปของคุณ: ค้นพบเครื่องพิมพ์ที่มีและนำเสนอใน UI ของคุณ อนุญาตให้ผู้ใช้เลือกเครื่องพิมพ์และกำหนดค่าตัวเลือก ส่ง intent การพิมพ์พร้อมเนื้อหาและการตั้งค่าที่เลือก และรับการยืนยันเมื่องานพิมพ์เสร็จสมบูรณ์ แต่ละขั้นตอนใช้การสื่อสาร Intent มาตรฐานของ Android ทำให้การบูรณาการเป็นไปอย่างตรงไปตรงมาสำหรับนักพัฒนา Android

กรณีการใช้งาน

Intent API เหมาะสำหรับแอปที่มีเนื้อหาซับซ้อนเช่นเอกสารออฟฟิศ แผนที่ ฟอร์มแบบกำหนดเอง หรือรายงานที่ต้องการการเรนเดอร์เฉพาะแอป นอกจากนี้ยังเหมาะเมื่อคุณต้องการตั้งค่าตัวเลือกการพิมพ์ล่วงหน้าตามประเภทเอกสารหรือค่ากำหนดของผู้ใช้ หรือเมื่อคุณต้องการบูรณาการการพิมพ์เข้ากับเวิร์กโฟลว์หลายขั้นตอนที่ผู้ใช้ไม่ควรออกจากแอปของคุณ

ข้อกำหนด

ผู้ใช้ต้องการแอป PrintHand ที่ติดตั้งพร้อมใบอนุญาตที่ถูกต้อง แอปของคุณต้องรวมการประกาศบริการ Intent API ของ PrintHand ใน manifest ของคุณและใช้งานโปรโตคอลการสื่อสาร intent ตามที่ระบุในเอกสารอ้างอิง API และโค้ดตัวอย่างของเรา

SDK ของ PrintHand ให้การเข้าถึงระดับต่ำโดยตรงไปยังเครื่องมือพิมพ์ของเรา เสนอความยืดหยุ่นและการควบคุมสูงสุดสำหรับแอปพลิเคชันที่ซับซ้อน แตกต่างจาก Intent API ซึ่งขึ้นอยู่กับคอมโพเนนต์ UI ของ PrintHand SDK ให้อิสระอย่างเต็มที่ในการออกแบบทุกด้านของประสบการณ์การพิมพ์ แนวทางนี้เหมาะสำหรับแอปพลิเคชันองค์กร โซลูชัน white-label หรือแอปใดๆ ที่ต้องการให้การพิมพ์เกิดขึ้นอย่างไม่เด่นชัดในพื้นหลังโดยไม่มีการโต้ตอบของผู้ใช้

ด้วย SDK คุณจะได้รับการควบคุมละเอียดเหนือทุกด้านของกระบวนการพิมพ์: การตรวจจับและการกรองเครื่องพิมพ์ การจัดการและการติดตั้งไดรเวอร์ การจัดคิวและการจัดลำดับความสำคัญของงานพิมพ์ การจัดการข้อผิดพลาดและการกู้คืนแบบกำหนดเอง แอปของคุณจะรับผิดชอบอย่างเต็มที่สำหรับเวิร์กโฟลว์การพิมพ์ทั้งหมด ตั้งแต่การนำเสนอตัวเลือกเครื่องพิมพ์ให้กับผู้ใช้ไปจนถึงการจัดการงานที่เสร็จสมบูรณ์และข้อผิดพลาด

ความสามารถขั้นสูง

• การควบคุม UI แบบเต็ม: สร้างอินเทอร์เฟซแบบกำหนดเองสำหรับการค้นพบเครื่องพิมพ์ การกำหนดค่า และการดูตัวอย่างที่ตรงกับการออกแบบของแอป
• การพิมพ์ในพื้นหลัง: ดำเนินงานพิมพ์โดยไม่มีการโต้ตอบของผู้ใช้หรือคอมโพเนนต์ UI
• การจัดการไดรเวอร์: ดาวน์โหลดและจัดการไดรเวอร์เครื่องพิมพ์แบบโปรแกรมสำหรับอุปกรณ์ที่รองรับ
• การเรนเดอร์แบบกำหนดเอง: การควบคุมอย่างเต็มที่เหนือการเตรียมเนื้อหาและไปป์ไลน์การเรนเดอร์
• ฟีเจอร์องค์กร: การจัดคิวงาน การพิมพ์แบบแบตช์ การเลือกเครื่องพิมพ์อัตโนมัติ และการจัดการข้อผิดพลาดแบบกำหนดเอง

ความซับซ้อนในการใช้งาน

SDK ต้องการความเข้าใจที่ลึกซึ้งยิ่งขึ้นเกี่ยวกับแนวคิดการพิมพ์บนมือถือและความพยายามในการพัฒนามากกว่า Intent API อย่างมีนัยสำคัญ แอปของคุณต้องให้ UI ที่สมบูรณ์สำหรับการค้นพบเครื่องพิมพ์ แสดงความสามารถและตัวเลือกของเครื่องพิมพ์ จัดการดาวน์โหลดและการติดตั้งไดรเวอร์ จัดการวงจรชีวิตของงานพิมพ์ และใช้งานการจัดการข้อผิดพลาดและการกู้คืน อย่างไรก็ตาม ความพยายามนี้จะได้รับผลตอบแทนด้วยความยืดหยุ่นและการควบคุมที่ไม่มีใครเทียบได้

โครงสร้าง SDK

SDK ของ PrintHand จัดทำเป็นไลบรารี Java ที่บูรณาการโดยตรงในแอป Android ของคุณ แสดง API ที่สมบูรณ์สำหรับการดำเนินการพิมพ์ทั้งหมด พร้อมเอกสารโดยละเอียดครอบคลุมการจัดการเครื่องพิมพ์ การส่งงาน การตรวจสอบสถานะ และการจัดการการกำหนดค่า SDK ออกแบบมาเพื่อความปลอดภัยของเธรดและมีประสิทธิภาพ เหมาะสำหรับสถานการณ์การพิมพ์ปริมาณสูง

กรณีการใช้งาน

เหมาะสำหรับแอปพลิเคชันองค์กรที่ต้องการเวิร์กโฟลว์การพิมพ์อัตโนมัติ ระบบจุดขายที่ต้องการการพิมพ์ใบเสร็จโดยไม่มีการโต้ตอบของผู้ใช้ แอปโลจิสติกส์และการจัดส่งที่มีการพิมพ์ป้ายกำกับปริมาณสูง และโซลูชัน white-label ที่แบรนด์ 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 เข้ากับแอปของคุณอย่างประสบความสำเร็จ