Con đường nhanh nhất để thêm khả năng in vào ứng dụng Android của bạn. Bằng cách sử dụng cơ chế Share Intent tiêu chuẩn của Android, ứng dụng của bạn có thể cung cấp chức năng in mà không cần viết một dòng code cụ thể nào của PrintHand. Khi người dùng chia sẻ nội dung có thể in từ ứng dụng của bạn, PrintHand tự động xuất hiện như một trong các tùy chọn chia sẻ, giống như ứng dụng email hoặc mạng xã hội.

Cách tiếp cận này lý tưởng cho các ứng dụng muốn cung cấp chức năng in với nỗ lực phát triển tối thiểu. Nhiều ứng dụng đã thiết lập không có kết nối trực tiếp với PrintHand sử dụng phương pháp này để cho phép người dùng của họ in tài liệu, hình ảnh và nội dung khác. Vẻ đẹp của tích hợp này là sự đơn giản của nó: nếu ứng dụng của bạn đã triển khai chức năng chia sẻ Android cho các mục đích khác, in ấn đi kèm miễn phí.

Cách Hoạt Động

Khi người dùng chọn "Chia sẻ" trong ứng dụng của bạn và chọn PrintHand từ danh sách các ứng dụng có sẵn, Android chuyển nội dung cho PrintHand. PrintHand sau đó xử lý toàn bộ quy trình in: hiển thị nội dung, hiển thị bản xem trước, cho phép người dùng cấu hình cài đặt máy in và cuối cùng gửi công việc đến máy in được chọn. Ứng dụng của bạn chỉ cần khởi tạo hành động chia sẻ và PrintHand xử lý mọi thứ khác.

Loại Nội Dung Được Hỗ Trợ

• Hình Ảnh: JPEG, PNG, GIF và các định dạng hình ảnh tiêu chuẩn khác
• Tài Liệu: Tệp PDF và văn bản thuần túy
• Nội Dung Web: URLs và nội dung HTML
• Dữ Liệu Tùy Chỉnh: Bất kỳ nội dung nào ứng dụng của bạn có thể chia sẻ qua intent tiêu chuẩn của Android

Yêu Cầu

Người dùng phải cài đặt ứng dụng PrintHand trên thiết bị của họ với giấy phép hợp lệ để in. Ứng dụng của bạn không yêu cầu quyền đặc biệt hoặc phụ thuộc, chỉ cần triển khai Share Intent tiêu chuẩn của Android mà hầu hết các ứng dụng đã sử dụng.

Triển Khai

Nếu ứng dụng của bạn đã triển khai chức năng chia sẻ Android, không cần code bổ sung. Nếu không, việc triển khai hành động chia sẻ cơ bản rất đơn giản bằng cách sử dụng API ShareCompat hoặc Intent.ACTION_SEND tiêu chuẩn của Android. Tài liệu và mã mẫu của PrintHand cung cấp ví dụ về triển khai thích hợp.

Intent API cung cấp một điểm giữa mạnh mẽ giữa chia sẻ không cần code và tích hợp SDK đầy đủ. Nó cho phép ứng dụng của bạn khám phá máy in theo chương trình, cấu hình tùy chọn in và bắt đầu công việc in, tất cả trong khi duy trì quyền kiểm soát giao diện người dùng và quy trình làm việc của ứng dụng. Đây là phương pháp tích hợp được sử dụng phổ biến nhất cho các nhà phát triển muốn kiểm soát đáng kể mà không có sự phức tạp của các hoạt động in mức thấp.

Với Intent API, bạn có thể tạo hộp thoại chọn máy in tùy ch��nh, tạo cài đặt in sẵn và tích hợp in liền mạch vào quy trình làm việc hiện có của ứng dụng. Ứng dụng của bạn giao tiếp với PrintHand thông qua một loạt các intent được xác định rõ ràng xử lý khám phá máy in, cấu hình tùy chọn, hiển thị nội dung và gửi công việc. PrintHand xử lý các yêu cầu này và trả kết quả cho ứng dụng của bạn, cho phép bạn duy trì quyền kiểm soát hoàn toàn trải nghiệm người dùng.

Khả Năng Chính

• Khám Phá Máy In: Khám phá máy in có sẵn theo chương trình qua WiFi, Bluetooth và USB
• Cấu Hình Cài Đặt: Kiểm soát kích thước giấy, hướng, chất lượng, chế độ màu và các tùy chọn cụ thể của máy in khác
• Hiển Thị Nội Dung: Để PrintHand xử lý hiển thị tài liệu phức tạp hoặc gửi nội dung đã hiển thị trước
• Quản Lý Công Việc In: Bắt đầu in, theo dõi trạng thái và xử lý kết quả

Quy Trình Tích Hợp

Ứng dụng của bạn gửi intent đến dịch vụ Intent API của PrintHand để thực hiện các hoạt động cụ thể. Ví dụ, để in tài liệu, ứng dụng của bạn sẽ: khám phá máy in có sẵn và trình bày chúng trong UI của bạn, cho phép người dùng chọn máy in và cấu hình tùy chọn, gửi intent in với nội dung và cài đặt đã chọn, và nhận xác nhận khi công việc in hoàn thành. Mỗi bước sử dụng giao tiếp Intent tiêu chuẩn của Android, làm cho việc tích hợp trở nên đơn giản cho các nhà phát triển Android.

Trường Hợp Sử Dụng

Intent API hoàn hảo cho các ứng dụng có nội dung phức tạp như tài liệu văn phòng, bản đồ, biểu mẫu tùy chỉnh hoặc báo cáo yêu cầu hiển thị cụ thể của ứng dụng. Nó cũng lý tưởng khi bạn muốn thiết lập trước các tùy chọn in dựa trên loại tài liệu hoặc tùy chọn người dùng, hoặc khi bạn cần tích hợp in vào quy trình làm việc nhiều bước nơi người dùng không nên rời khỏi ứng dụng của bạn.

Yêu Cầu

Người dùng cần cài đặt ứng dụng PrintHand với giấy phép hợp lệ. Ứng dụng của bạn phải bao gồm khai báo dịch vụ Intent API của PrintHand trong manifest và triển khai giao thức giao tiếp intent như được ghi trong tài liệu tham khảo API và mã mẫu của chúng tôi.

SDK của PrintHand cung cấp quyền truy cập trực tiếp mức thấp vào công cụ in của chúng tôi, cung cấp tính linh hoạt và kiểm soát tối đa cho các ứng dụng tinh vi. Không giống như Intent API phụ thuộc vào các thành phần UI của PrintHand, SDK cung cấp cho bạn quyền tự do hoàn toàn để thiết kế mọi khía cạnh của trải nghiệm in. Cách tiếp cận này lý tưởng cho các ứng dụng doanh nghiệp, giải pháp nhãn hiệu trắng hoặc bất kỳ ứng dụng nào yêu cầu in diễn ra âm thầm ở chế độ nền mà không cần tương tác người dùng.

Với SDK, bạn có được quyền kiểm soát chi tiết đối với mọi khía cạnh của quá trình in: phát hiện và lọc máy in, quản lý và cài đặt trình điều khiển, xếp hàng và ưu tiên công việc in, xử lý lỗi tùy chỉnh và khôi phục. Ứng dụng của bạn trở nên hoàn toàn chịu trách nhiệm cho toàn bộ quy trình in, từ việc trình bày tùy chọn máy in cho người dùng đến xử lý hoàn thành công việc và lỗi.

Khả Năng Nâng Cao

• Kiểm Soát UI Đầy Đủ: Xây dựng giao diện tùy chỉnh khám phá máy in, cấu hình và xem trước phù hợp với thiết kế ứng dụng của bạn
• In Nền: Chạy công việc in mà không cần bất kỳ tương tác người dùng hoặc thành phần UI nào
• Quản Lý Trình Điều Khiển: Tải xuống và quản lý trình điều khiển máy in theo chương trình cho các thiết bị được hỗ trợ
• Hiển Thị Tùy Chỉnh: Kiểm soát hoàn toàn việc chuẩn bị nội dung và quy trình hiển thị
• Tính Năng Doanh Nghiệp: Xếp hàng công việc, in hàng loạt, chọn máy in tự động và xử lý lỗi tùy chỉnh

Độ Phức Tạp Triển Khai

SDK yêu cầu hiểu biết sâu hơn về các khái niệm in di động và nỗ lực phát triển đáng kể hơn so với Intent API. Ứng dụng của bạn phải cung cấp UI hoàn chỉnh cho khám phá máy in, hiển thị khả năng và tùy chọn máy in, xử lý tải xuống và cài đặt trình điều khiển, quản lý vòng đời công việc in và triển khai xử lý lỗi và khôi phục. Tuy nhiên, nỗ lực này được đền đáp bằng tính linh hoạt và kiểm soát vô song.

Cấu Trúc SDK

SDK của PrintHand được cung cấp dưới dạng thư viện Java tích hợp trực tiếp vào ứng dụng Android của bạn. Nó cung cấp API hoàn chỉnh cho tất cả các hoạt động in, với tài liệu chi tiết bao gồm quản lý máy in, gửi công việc, theo dõi trạng thái và quản lý cấu hình. SDK được thiết kế để an toàn với luồng và hiệu quả, phù hợp cho các tình huống in khối lượng lớn.

Trường Hợp Sử Dụng

Hoàn hảo cho các ứng dụng doanh nghiệp yêu cầu quy trình in tự động, hệ thống điểm bán hàng cần in biên lai mà không cần tương tác người dùng, ứng dụng logistics và giao hàng với in nhãn khối lượng lớn và giải pháp nhãn hiệu trắng nơi thương hiệu PrintHand không nên xuất hiện.

Yêu Cầu

Người dùng cần ứng dụng PrintHand hoặc dịch vụ in độc lập PrintHand được cài đặt trên thiết bị của họ với giấy phép hợp lệ. Ứng dụng của bạn phải bao gồm thư viện SDK trong dự án và yêu cầu hiểu biết về giao thức giao tiếp máy in và kiến trúc in Android để triển khai tối ưu.

Mã Mẫu và Tài Nguyên

Để giúp bạn bắt đầu với tích hợp PrintHand, chúng tôi đã tạo một ứng dụng mẫu toàn diện minh họa cả ba phương pháp tích hợp. Mã mẫu cho thấy các phương pháp tốt nhất để triển khai m��i cách tiếp cận, xử lý các trường hợp đặc biệt và cung cấp trải nghiệm người dùng tuyệt vời.

Kho GitHub

Kho PrintingSample của chúng tôi chứa các ví dụ hoạt động về Share Intent, Intent API và tích hợp SDK. Code được ghi chép tốt và minh họa các mẫu sử dụng thực tế. Truy cập kho GitHub của chúng tôi tại:

github.com/DynamixSoftware/PrintingSample

Tài Liệu

Tài liệu API chi tiết, hướng dẫn tích hợp và tài nguyên khắc phục sự cố có sẵn trong wiki của kho. Chúng tôi thường xuyên cập nhật tài liệu dựa trên phản hồi của nhà phát triển và phiên bản Android mới.

Hỗ Trợ

Đối với câu hỏi kỹ thuật, hỗ trợ tích hợp hoặc báo cáo vấn đề, hãy liên hệ với nhóm hỗ trợ nhà phát triển của chúng tôi tại support@printhand.com. Chúng tôi ở đây để giúp bạn tích hợp thành công PrintHand vào ứng dụng của bạn.