Android 앱에 인쇄 기능을 추가하는 가장 빠른 경로입니다. Android의 표준 Share Intent 메커니즘을 활용하면 PrintHand 특정 코드를 한 줄도 작성하지 않고도 앱에서 인쇄 기능을 제공할 수 있습니다. 사용자가 앱에서 인쇄할 수 있는 콘텐츠를 공유하면 PrintHand가 이메일이나 소셜 미디어 앱처럼 공유 옵션 중 하나로 자동으로 나타납니다.

이 접근 방식은 최소한의 개발 노력으로 인쇄를 제공하려는 앱에 이상적입니다. PrintHand와 직접 연결되지 않은 많은 잘 확립된 앱이 이 방법을 사용하여 사용자가 문서, 이미지 및 기타 콘텐츠를 인쇄할 수 있도록 합니다. 이 통합의 장점은 단순성입니다. 앱이 이미 다른 목적으로 Android 공유 기능을 구현한 경우 인쇄는 무료로 제공됩니다.

작동 방식

사용자가 앱에서 "공유"를 선택하고 사용 가능한 앱 목록에서 PrintHand를 선택하면 Android가 콘텐츠를 PrintHand로 전달합니다. 그런 다음 PrintHand는 전체 인쇄 워크플로를 처리합니다. 콘텐츠 렌더링, 미리보기 표시, 사용자가 프린터 설정을 구성할 수 있도록 허용하고 마지막으로 선택한 프린터로 작업을 보냅니다. 앱은 공유 작업을 시작하기만 하면 되고 PrintHand가 나머지를 모두 처리합니다.

지원되는 콘텐츠 유형

• 이미지: JPEG, PNG, GIF 및 기타 표준 이미지 형식
• 문서: PDF 파일 및 일반 텍스트
• 웹 콘텐츠: URL 및 HTML 콘텐츠
• 사용자 지정 데이터: 앱이 표준 Android Intent를 통해 공유할 수 있는 모든 콘텐츠

요구 사항

사용자는 인쇄를 위한 유효한 라이선스가 있는 PrintHand 앱을 기기에 설치해야 합니다. 앱은 특별한 권한이나 종속성이 필요하지 않으며 대부분의 앱이 이미 사용하는 표준 Android Share Intent 구현만 있으면 됩니다.

구현

앱이 이미 Android 공유 기능을 구현한 경우 추가 코드가 필요하지 않습니다. 그렇지 않은 경우 표준 Android ShareCompat 또는 Intent.ACTION_SEND API를 사용하여 기본 공유 작업을 구현하는 것은 간단합니다. PrintHand 문서 및 샘플 코드는 적절한 구현 예제를 제공합니다.

Intent API는 코드 없는 공유와 전체 SDK 통합 사이의 강력한 중간 지점을 제공합니다. 앱의 사용자 인터페이스 및 워크플로에 대한 제어를 유지하면서 프로그래밍 방식으로 프린터를 검색하고 인쇄 옵션을 구성하며 인쇄 작업을 시작할 수 있습니다. 이것은 저수준 인쇄 작업의 복잡성 없이 상당한 제어를 원하는 개발자를 위한 가장 일반적으로 사용되는 통합 방법입니다.

Intent API를 사용하면 사용자 지정 프린터 선택 대화 상자를 만들고 사전 설정 인쇄 구성을 만들며 기존 앱 워크플로에 인쇄를 원활하게 통합할 수 있습니다. 앱은 프린터 검색, 옵션 구성, 콘텐츠 렌더링 및 작업 제출을 처리하는 일련의 잘 정의된 Intent를 통해 PrintHand와 통신합니다. PrintHand는 이러한 요청을 처리하고 앱에 결과를 반환하여 사용자 경험에 대한 완전한 제어를 유지할 수 있도록 합니다.

주요 기능

• 프린터 검색: WiFi, Bluetooth 및 USB를 통해 프로그래밍 방식으로 사용 가능한 프린터 검색
• 설정 구성: 용지 크기, 방향, 품질, 색상 모드 및 기타 프린터별 옵션 제어
• 콘텐츠 렌더링: PrintHand가 복잡한 문서 렌더링을 처리하도록 하거나 미리 렌더링된 콘텐츠를 보냅니다
• 인쇄 작업 관리: 인쇄 시작, 상태 모니터링 및 결과 처리

통합 워크플로

앱은 특정 작업을 수행하기 위해 PrintHand의 Intent API 서비스에 Intent를 보냅니다. 예를 들어 문서를 인쇄하려면 앱이 사용 가능한 프린터를 검색하여 UI에 표시하고 사용자가 프린터를 선택하고 옵션을 구성할 수 있도록 하며 콘텐츠 및 선택한 설정으로 인쇄 Intent를 보내고 인쇄 작업이 완료되면 확인을 받습니다. 각 단계는 표준 Android Intent 통신을 사용하여 Android 개발자에게 통합을 간단하게 만듭니다.

사용 사례

Intent API는 사무 문서, 지도, 사용자 지정 양식 또는 앱별 렌더링이 필요한 보고서와 같은 복잡한 콘텐츠가 있는 앱에 적합합니다. 또한 문서 유형 또는 사용자 기본 설정에 따라 인쇄 옵션을 사전 설정하거나 사용자가 앱을 떠나지 않아야 하는 다단계 워크플로에 인쇄를 통합해야 할 때 이상적입니다.

요구 사항

사용자는 유효한 라이선스가 있는 PrintHand 앱을 설치해야 합니다. 앱은 매니페스트에 PrintHand의 Intent API 서비스 선언을 포함하고 API 참조 및 샘플 코드에 문서화된 대로 Intent 통신 프로토콜을 구현해야 합니다.

PrintHand SDK는 인쇄 엔진에 대한 직접적인 저수준 액세스를 제공하여 정교한 애플리케이션을 위한 최대 유연성과 제어를 제공합니다. PrintHand의 UI 구성 요소에 의존하는 Intent API와 달리 SDK는 인쇄 경험의 모든 측면을 설계할 수 있는 완전한 자유를 제공합니다. 이 접근 방식은 엔터프라이즈 애플리케이션, 화이트 레이블 솔루션 또는 사용자 상호 작용 없이 백그라운드에서 인쇄가 발생해야 하는 모든 앱에 이상적입니다.

SDK를 사용하면 인쇄 프로세스의 모든 측면에 대한 세밀한 제어를 얻을 수 있습니다. 프린터 감지 및 필터링, 드라이버 관리 및 설치, 작업 대기열 및 우선 순위 지정, 사용자 지정 오류 처리 및 복구. 앱은 사용자에게 프린터 옵션을 제시하는 것부터 작업 완료 및 오류 처리까지 전체 인쇄 워크플로에 대해 완전히 책임을 집니다.

고급 기능

• 완전한 UI 제어: 앱 디자인과 일치하는 사용자 지정 프린터 검색, 구성 및 미리보기 인터페이스 구축
• 백그라운드 인쇄: 사용자 상호 작용이나 UI 구성 요소 없이 인쇄 작업 실행
• 드라이버 관리: 지원되는 장치에 대한 프린터 드라이버를 프로그래밍 방식으로 다운로드 및 관리
• 사용자 지정 렌더링: 콘텐츠 준비 및 렌더링 파이프라인에 대한 완전한 제어
• 엔터프라이즈 기능: 작업 대기열, 일괄 인쇄, 자동화된 프린터 선택 및 사용자 지정 오류 처리

구현 복잡성

SDK는 모바일 인쇄 개념에 대한 더 깊은 이해와 Intent API보다 훨씬 더 많은 개발 노력이 필요합니다. 앱은 프린터 검색을 위한 완전한 UI, 프린터 기능 및 옵션 표시, 드라이버 다운로드 및 설치 처리, 인쇄 작업 수명 주기 관리, 오류 처리 및 복구 구현을 제공해야 합니다. 그러나 이러한 노력은 비할 데 없는 유연성과 제어로 보상받습니다.

SDK 구조

PrintHand SDK는 Android 앱에 직접 통합되는 Java 라이브러리로 제공됩니다. 프린터 관리, 작업 제출, 상태 모니터링 및 구성 관리를 다루는 상세한 문서와 함께 모든 인쇄 작업에 대한 포괄적인 API를 노출합니다. SDK는 스레드 안전하고 효율적으로 설계되어 대용량 인쇄 시나리오에 적합합니다.

사용 사례

자동화된 인쇄 워크플로가 필요한 엔터프라이즈 애플리케이션, 사용자 상호 작용 없이 영수증 인쇄가 필요한 POS 시스템, 대용량 라벨 인쇄가 있는 물류 및 배송 앱, PrintHand 브랜딩이 나타나지 않아야 하는 화이트 레이블 솔루션에 적합합니다.

요구 사항

사용자는 유효한 라이선스가 있는 PrintHand 앱 또는 독립형 PrintHand 인쇄 서비스를 기기에 설치해야 합니다. 앱은 프로젝트에 SDK 라이브러리를 포함해야 하며 최적의 구현을 위해 프린터 통신 프로토콜 및 Android 인쇄 아키텍처에 대한 이해가 필요합니다.

샘플 코드 및 리소스

PrintHand 통합을 시작할 수 있도록 세 가지 통합 방법을 모두 보여주는 포괄적인 샘플 애플리케이션을 만들었습니다. 샘플 코드는 각 접근 방식을 구현하고 예외 사례를 처리하며 훌륭한 사용자 경험을 제공하기 위한 모범 사례를 보여줍니다.

GitHub 리포지토리

PrintingSample 리포지토리에는 Share Intent, Intent API 및 SDK 통합의 작동하는 예제가 포함되어 있습니다. 코드는 잘 문서화되어 있으며 실제 사용 패턴을 보여줍니다. GitHub 리포지토리를 방문하세요:

github.com/DynamixSoftware/PrintingSample

문서

자세한 API 문서, 통합 가이드 및 문제 해결 리소스는 리포지토리 위키에서 사용할 수 있습니다. 개발자 피드백 및 새로운 Android 릴리스를 기반으로 문서를 정기적으로 업데이트합니다.

지원

기술 질문, 통합 지원 또는 문제 보고는 support@printhand.com의 개발자 지원 팀에 문의하세요. 앱에 PrintHand를 성공적으로 통합할 수 있도록 도와드리겠습니다.