Самый быстрый путь к добавлению возможностей печати в ваше приложение Android. Используя стандартный механизм Share Intent в Android, ваше приложение может предложить функциональность печати без написания ни одной строки кода, специфичного для PrintHand. Когда пользователи делятся контентом, подходящим для печати, из вашего приложения, PrintHand автоматически появляется как один из вариантов обмена, так же как приложения электронной почты или социальных сетей.

Этот подход идеален для приложений, которые хотят предоставить печать с минимальными усилиями по разработке. Многие хорошо зарекомендовавшие себя приложения без прямой связи с PrintHand используют этот метод, чтобы позволить своим пользователям печатать документы, изображения и другой контент. Прелесть этой интеграции в её простоте — если ваше приложение уже реализует функциональность Share в Android для других целей, печать приходит бесплатно.

Как Это Работает

Когда пользователь выбирает "Поделиться" в вашем приложении и выбирает PrintHand из списка доступных приложений, Android передает контент в PrintHand. Затем PrintHand берет на себя весь рабочий процесс печати: рендеринг контента, отображение предварительного просмотра, позволяя пользователю настраивать параметры принтера и, наконец, отправляя задание на выбранный принтер. Ваше приложение просто инициирует действие обмена, а PrintHand обрабатывает все остальное.

Поддерживаемые Типы Контента

• Изображения: JPEG, PNG, GIF и другие стандартные форматы изображений
• Документы: PDF-файлы и обычный текст
• Веб-Контент: URL-адреса и HTML-контент
• Пользовательские Данные: Любой контент, которым ваше приложение может поделиться через стандартные интенты Android

Требования

У пользователей должно быть установлено приложение PrintHand на их устройстве с действительной лицензией для печати. Вашему приложению не требуются специальные разрешения или зависимости — только стандартная реализация Share Intent в Android, которую большинство приложений уже используют.

Реализация

Если ваше приложение уже реализует функциональность Share в Android, дополнительный код не нужен. Если нет, реализация базового действия обмена проста с использованием стандартных API ShareCompat или Intent.ACTION_SEND в Android. Документация PrintHand и примеры кода предоставляют примеры правильной реализации.

Intent API обеспечивает мощную золотую середину между интеграцией без кода и полной интеграцией SDK. Это позволяет вашему приложению программно обнаруживать принтеры, настраивать параметры печати и инициировать задания печати — все это сохраняя контроль над пользовательским интерфейсом и рабочим процессом вашего приложения. Это наиболее часто используемый метод интеграции для разработчиков, которые хотят значимого контроля без сложности низкоуровневых операций печати.

С Intent API вы можете создавать пользовательские диалоги выбора принтера, создавать предустановленные конфигурации печати и бесшовно интегрировать печать в существующие рабочие процессы вашего приложения. Ваше приложение общается с PrintHand через серию четко определенных интентов, которые обрабатывают обнаружение принтеров, настройку параметров, рендеринг контента и отправку заданий. PrintHand обрабатывает эти запросы и возвращает результаты обратно в ваше приложение, позволяя вам сохранять полный контроль над пользовательским опытом.

Основные Возможности

• Обнаружение Принтеров: Программное обнаружение доступных принтеров через WiFi, Bluetooth и USB
• Настройка Параметров: Контроль размера бумаги, ориентации, качества, цветового режима и других специфичных параметров принтера
• Рендеринг Контента: Позвольте PrintHand обрабатывать сложный рендеринг документов или отправляйте предварительно отрендеренный контент
• Управление Заданиями Печати: Инициируйте печать, отслеживайте статус и обрабатывайте результаты

Рабочий Процесс Интеграции

Ваше приложение отправляет интенты в сервис Intent API PrintHand для выполнения конкретных операций. Например, чтобы распечатать документ, ваше приложение: обнаружит доступные принтеры и представит их в вашем UI, позволит пользователю выбрать принтер и настроить параметры, отправит интент печати с контентом и выбранными настройками и получит подтверждение о завершении задания печати. Каждый шаг использует стандартную коммуникацию Intent в Android, делая интеграцию простой для разработчиков Android.

Случаи Использования

Intent API идеален для приложений со сложным контентом, таким как офисные документы, карты, пользовательские формы или отчеты, требующие рендеринга, специфичного для приложения. Он также идеален, когда вы хотите предустановить параметры печати на основе типа документа или предпочтений пользователя, или когда вам нужно интегрировать печать в многошаговые рабочие процессы, где пользователи не должны покидать ваше приложение.

Требования

У пользователей должно быть установлено приложение PrintHand с действительной лицензией. Ваше приложение должно включать объявления сервиса Intent API PrintHand в вашем манифесте и реализовывать протокол коммуникации интентов, как описано в нашей API-справке и примерах кода.

SDK PrintHand обеспечивает прямой низкоуровневый доступ к нашему движку печати, предлагая максимальную гибкость и контроль для сложных приложений. В отличие от Intent API, который полагается на UI-компоненты PrintHand, SDK дает вам полную свободу проектировать каждый аспект опыта печати. Этот подход идеален для корпоративных приложений, решений под белой маркой или любого приложения, которое требует, чтобы печать происходила невидимо в фоновом режиме без взаимодействия с пользователем.

С SDK вы получаете детальный контроль над каждым аспектом процесса печати: обнаружением и фильтрацией принтеров, управлением драйверами и установкой, очередностью и приоритетом заданий печати, пользовательской обработкой ошибок и восстановлением. Ваше приложение становится полностью ответственным за весь рабочий процесс печати, от представления вариантов принтеров пользователю до обработки завершения заданий и ошибок.

Расширенные Возможности

• Полный Контроль UI: Создавайте пользовательские интерфейсы обнаружения, настройки и предварительного просмотра принтеров, соответствующие дизайну вашего приложения
• Фоновая Печать: Выполняйте задания печати без какого-либо взаимодействия с пользователем или UI-компонентов
• Управление Драйверами: Программно загружайте и управляйте драйверами принтеров для поддерживаемых устройств
• Пользовательский Рендеринг: Полный контроль над подготовкой контента и конвейером рендеринга
• Корпоративные Функции: Очередность заданий, пакетная печать, автоматический выбор принтера и пользовательская обработка ошибок

Сложность Реализации

SDK требует более глубокого понимания концепций мобильной печати и значительно больше усилий по разработке, чем Intent API. Ваше приложение должно предоставлять полный UI для обнаружения принтеров, отображать возможности и параметры принтера, обрабатывать загрузки и установку драйверов, управлять жизненным циклом заданий печати и реализовывать обработку ошибок и восстановление. Однако эти усилия вознаграждаются непревзойденной гибкостью и контролем.

Структура 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, руководства по интеграции и ресурсы по устранению неполадок доступны в вики репозитория. Мы регулярно обновляем документацию на основе отзывов разработчиков и новых версий Android.

Поддержка

По техническим вопросам, помощи в интеграции или для сообщения о проблемах свяжитесь с нашей командой поддержки разработчиков по адресу support@printhand.com. Мы здесь, чтобы помочь вам успешно интегрировать PrintHand в ваше приложение.