Najszybsza ścieżka do dodania możliwości drukowania do aplikacji Android. Wykorzystując standardowy mechanizm Share Intent systemu Android, Twoja aplikacja może oferować funkcjonalność drukowania bez pisania ani jednej linii kodu specyficznego dla PrintHand. Gdy użytkownicy udostępniają treści nadające się do drukowania z Twojej aplikacji, PrintHand automatycznie pojawia się jako jedna z opcji udostępniania, tak jak aplikacje e-mail czy media społecznościowe.

To podejście jest idealne dla aplikacji, które chcą zapewnić drukowanie przy minimalnym wysiłku programistycznym. Wiele uznanych aplikacji bez bezpośredniego połączenia z PrintHand używa tej metody, aby umożliwić swoim użytkownikom drukowanie dokumentów, obrazów i innych treści. Piękno tej integracji tkwi w jej prostocie: jeśli Twoja aplikacja już implementuje funkcjonalność udostępniania Android do innych celów, drukowanie jest darmowe.

Jak to Działa

Gdy użytkownik wybierze "Udostępnij" w Twojej aplikacji i wybierze PrintHand z listy dostępnych aplikacji, Android przekazuje treść do PrintHand. PrintHand następnie obsługuje cały przepływ pracy drukowania: renderowanie treści, wyświetlanie podglądu, umożliwienie użytkownikowi skonfigurowania ustawień drukarki i wreszcie wysłanie zadania do wybranej drukarki. Twoja aplikacja po prostu inicjuje akcję udostępniania, a PrintHand zajmuje się resztą.

Obsługiwane Typy Treści

• Obrazy: JPEG, PNG, GIF i inne standardowe formaty obrazów
• Dokumenty: Pliki PDF i zwykły tekst
• Treści Internetowe: Adresy URL i treści HTML
• Dane Niestandardowe: Wszelkie treści, które Twoja aplikacja może udostępnić poprzez standardowe intenty Android

Wymagania

Użytkownicy muszą mieć zainstalowaną aplikację PrintHand na swoim urządzeniu z ważną licencją do drukowania. Twoja aplikacja nie wymaga specjalnych uprawnień ani zależności, tylko standardową implementację Share Intent Android, której większość aplikacji już używa.

Implementacja

Jeśli Twoja aplikacja już implementuje funkcjonalność udostępniania Android, nie jest potrzebny dodatkowy kod. Jeśli nie, implementacja podstawowej akcji udostępniania jest prosta przy użyciu standardowych API ShareCompat lub Intent.ACTION_SEND Android. Dokumentacja PrintHand i przykładowy kod zawierają przykłady prawidłowej implementacji.

Intent API zapewnia potężny punkt pośredni między udostępnianiem bez kodu a pełną integracją SDK. Umożliwia Twojej aplikacji programowe odkrywanie drukarek, konfigurowanie opcji drukowania i inicjowanie zadań drukowania, jednocześnie zachowując kontrolę nad interfejsem użytkownika i przepływem pracy aplikacji. Jest to najczęściej używana metoda integracji dla deweloperów, którzy chcą znaczącej kontroli bez złożoności operacji drukowania niskiego poziomu.

Z Intent API możesz tworzyć niestandardowe okna dialogowe wyboru drukarki, tworzyć predefiniowane ustawienia drukowania i bezproblemowo integrować drukowanie z istniejącymi przepływami pracy Twojej aplikacji. Twoja aplikacja komunikuje się z PrintHand przez serię dobrze zdefiniowanych intentów, które obsługują odkrywanie drukarek, konfigurację opcji, renderowanie treści i wysyłanie zadań. PrintHand przetwarza te żądania i zwraca wyniki do Twojej aplikacji, pozwalając zachować pełną kontrolę nad doświadczeniem użytkownika.

Kluczowe Możliwości

• Odkrywanie Drukarek: Odkryj dostępne drukarki programowo przez WiFi, Bluetooth i USB
• Konfiguracja Ustawień: Kontroluj rozmiar papieru, orientację, jakość, tryb kolorów i inne opcje specyficzne dla drukarki
• Renderowanie Treści: Pozwól PrintHand obsłużyć złożone renderowanie dokumentów lub wyślij wstępnie wyrenderowaną treść
• Zarządzanie Zadaniami Drukowania: Inicjuj drukowanie, monitoruj status i obsługuj wyniki

Przepływ Pracy Integracji

Twoja aplikacja wysyła intenty do usługi Intent API PrintHand w celu wykonania określonych operacji. Na przykład, aby wydrukować dokument, Twoja aplikacja: odkrywa dostępne drukarki i prezentuje je w swoim interfejsie, pozwala użytkownikowi wybrać drukarkę i skonfigurować opcje, wysyła intent drukowania z treścią i wybranymi ustawieniami, oraz otrzymuje potwierdzenie po zakończeniu zadania drukowania. Każdy krok wykorzystuje standardową komunikację Intent Android, czyniąc integrację prostą dla deweloperów Android.

Przypadki Użycia

Intent API jest idealne dla aplikacji ze złożonymi treściami, takimi jak dokumenty biurowe, mapy, niestandardowe formularze lub raporty wymagające specyficznego renderowania aplikacji. Jest również idealne, gdy chcesz wstępnie ustawić opcje drukowania w zależności od typu dokumentu lub preferencji użytkownika, lub gdy musisz zintegrować drukowanie z wieloetapowymi przepływami pracy, gdzie użytkownicy nie powinni opuszczać Twojej aplikacji.

Wymagania

Użytkownicy potrzebują zainstalowanej aplikacji PrintHand z ważną licencją. Twoja aplikacja musi zawierać deklaracje usługi Intent API PrintHand w swoim manifeście i implementować protokół komunikacji intent zgodnie z naszą dokumentacją API i przykładowym kodem.

SDK PrintHand zapewnia bezpośredni dostęp niskiego poziomu do naszego silnika drukowania, oferując maksymalną elastyczność i kontrolę dla zaawansowanych aplikacji. W przeciwieństwie do Intent API, który polega na komponentach UI PrintHand, SDK daje pełną swobodę projektowania każdego aspektu doświadczenia drukowania. To podejście jest idealne dla aplikacji korporacyjnych, rozwiązań white-label lub każdej aplikacji wymagającej, aby drukowanie odbywało się w tle bez interakcji użytkownika.

Z SDK otrzymujesz szczegółową kontrolę nad każdym aspektem procesu drukowania: wykrywaniem i filtrowaniem drukarek, zarządzaniem i instalacją sterowników, kolejkowaniem i priorytetyzacją zadań drukowania, niestandardową obsługą błędów i odzyskiwaniem. Twoja aplikacja staje się w pełni odpowiedzialna za cały przepływ pracy drukowania, od prezentacji opcji drukarek użytkownikowi po obsługę ukończenia zadań i błędów.

Zaawansowane Możliwości

• Pełna Kontrola UI: Buduj niestandardowe interfejsy odkrywania drukarek, konfiguracji i podglądu zgodne z projektem Twojej aplikacji
• Drukowanie w Tle: Wykonuj zadania drukowania bez jakiejkolwiek interakcji użytkownika lub komponentów UI
• Zarządzanie Sterownikami: Pobieraj i zarządzaj sterownikami drukarek programowo dla obsługiwanych urządzeń
• Renderowanie Niestandardowe: Pełna kontrola nad przygotowaniem treści i potokiem renderowania
• Funkcje Korporacyjne: Kolejkowanie zadań, drukowanie wsadowe, automatyczny wybór drukarki i niestandardowa obsługa błędów

Złożoność Implementacji

SDK wymaga głębszego zrozumienia koncepcji drukowania mobilnego i znacznie większego wysiłku programistycznego niż Intent API. Twoja aplikacja musi zapewniać kompletny interfejs użytkownika do odkrywania drukarek, wyświetlania możliwości i opcji drukarki, obsługi pobierania i instalacji sterowników, zarządzania cyklem życia zadań drukowania oraz implementacji obsługi błędów i odzyskiwania. Jednakże ten wysiłek jest nagradzany niezrównaną elastycznością i kontrolą.

Struktura SDK

SDK PrintHand jest dostarczany jako biblioteka Java, która integruje się bezpośrednio z Twoją aplikacją Android. Udostępnia kompleksowe API dla wszystkich operacji drukowania, ze szczegółową dokumentacją obejmującą zarządzanie drukarkami, przesyłanie zadań, monitorowanie stanu i zarządzanie konfiguracją. SDK jest zaprojektowany jako bezpieczny wątkowo i wydajny, odpowiedni dla scenariuszy drukowania o dużej objętości.

Przypadki Użycia

Idealne dla aplikacji korporacyjnych wymagających zautomatyzowanych przepływów pracy drukowania, systemów punktów sprzedaży potrzebujących drukowania paragonów bez interakcji użytkownika, aplikacji logistycznych i dostawczych z drukowaniem etykiet o dużej objętości oraz rozwiązań white-label, gdzie marka PrintHand nie powinna być widoczna.

Wymagania

Użytkownicy potrzebują albo aplikacji PrintHand, albo niezależnej usługi drukowania PrintHand zainstalowanej na swoim urządzeniu z ważną licencją. Twoja aplikacja musi zawierać bibliotekę SDK w swoim projekcie i wymaga zrozumienia protokołów komunikacji drukarek oraz architektury drukowania Android dla optymalnej implementacji.

Przykładowy Kod i Zasoby

Aby pomóc Ci rozpocząć integrację PrintHand, stworzyliśmy kompleksową przykładową aplikację demonstrującą wszystkie trzy metody integracji. Przykładowy kod pokazuje najlepsze praktyki implementacji każdego podejścia, obsługi przypadków brzegowych i zapewniania doskonałego doświadczenia użytkownika.

Repozytorium GitHub

Nasze repozytorium PrintingSample zawiera działające przykłady Share Intent, Intent API i integracji SDK. Kod jest dobrze udokumentowany i demonstruje rzeczywiste wzorce użycia. Odwiedź nasze repozytorium GitHub pod adresem:

github.com/DynamixSoftware/PrintingSample

Dokumentacja

Szczegółowa dokumentacja API, przewodniki integracji i zasoby rozwiązywania problemów są dostępne na wiki repozytorium. Regularnie aktualizujemy dokumentację na podstawie opinii deweloperów i nowych wersji Android.

Wsparcie

W przypadku pytań technicznych, pomocy w integracji lub zgłaszania problemów, skontaktuj się z naszym zespołem wsparcia deweloperów pod adresem support@printhand.com. Jesteśmy tutaj, aby pomóc Ci pomyślnie zintegrować PrintHand z Twoją aplikacją.