Најкраћи пут да својој Android апликацији додате штампање. Користећи стандардни Android механизам Share Intent, Ваша апликација може да понуди штампање без иједне линије кода специфичног за PrintHand. Када корисници из Ваше апликације поделе садржај погодан за штампање, PrintHand се аутоматски појављује као једна од опција дељења, као и апликације за имејл или друштвене мреже.

Овај приступ је идеалан за апликације које желе да понуде штампање уз минималан развојни напор. Многе познате апликације без икакве директне везе са PrintHand-ом користе баш овај начин да својим корисницима омогуће штампање докумената, слика и другог садржаја. Лепота ове интеграције је у њеној једноставности: ако Ваша апликација већ користи Android дељење у друге сврхе, штампање добијате бесплатно.

Како функционише

Када корисник у Вашој апликацији изабере „Подели“ и са списка доступних апликација одабере PrintHand, Android предаје садржај PrintHand-у. PrintHand затим преузима цео ток штампања: рендерује садржај, приказује преглед, омогућава кориснику да подеси опције штампача и на крају шаље посао на изабрани штампач. Ваша апликација само покреће дељење, а PrintHand се брине о свему осталом.

Подржани типови садржаја

• Слике: JPEG, PNG, GIF и други стандардни формати слика
• Документи: PDF датотеке и обичан текст
• Веб садржај: URL адресе и HTML садржај
• Прилагођени подаци: сваки садржај који Ваша апликација може да подели стандардним Android интентима

Захтеви

Корисници морају имати инсталирану апликацију PrintHand са важећом лиценцом за штампање. Ваша апликација не захтева никакве посебне дозволе ни зависности, само стандардну имплементацију Android Share Intent-а коју већина апликација већ има.

Имплементација

Ако Ваша апликација већ подржава Android дељење, додатни код није потребан. Ако не, основно дељење се једноставно имплементира помоћу стандардних Android API-ја ShareCompat или Intent.ACTION_SEND. PrintHand документација и пример-код показују исправну имплементацију.

Intent API је моћна средина између дељења без кода и пуне SDK интеграције. Омогућава Вашој апликацији да програмски пронађе штампаче, подеси опције штампања и покрене послове штампања, а да при томе задржи контролу над својим корисничким интерфејсом и током рада. Ово је најчешће коришћени начин интеграције за програмере који желе значајну контролу без сложености операција штампања ниског нивоа.

Помоћу Intent API-ја можете да направите сопствене дијалоге за избор штампача, унапред подешене конфигурације штампања и да штампање уклопите у постојеће токове рада своје апликације. Ваша апликација комуницира са PrintHand-ом низом јасно дефинисаних интента који покривају откривање штампача, подешавање опција, рендеровање садржаја и слање посла. PrintHand обрађује те захтеве и враћа резултате Вашој апликацији, тако да корисничко искуство остаје потпуно под Вашом контролом.

Главне могућности

• Откривање штампача: програмски пронађите доступне штампаче преко WiFi, Bluetooth и USB везе
• Подешавање опција: управљајте величином папира, оријентацијом, квалитетом, режимом боје и другим опцијама специфичним за штампач
• Рендеровање садржаја: препустите PrintHand-у сложено рендеровање докумената или пошаљите већ рендерован садржај
• Управљање пословима штампања: покрените штампање, пратите стање и обрадите резултате

Ток интеграције

Ваша апликација шаље интенте PrintHand Intent API сервису за одређене операције. На пример, да бисте одштампали документ, Ваша апликација би: пронашла доступне штампаче и приказала их у свом интерфејсу, омогућила кориснику да изабере штампач и подеси опције, послала интент за штампање са садржајем и изабраним подешавањима и примила потврду када се посао штампања заврши. Сваки корак користи стандардну Android комуникацију интентима, па је интеграција за Android програмере једноставна.

Примене

Intent API је идеалан за апликације са сложеним садржајем као што су канцеларијски документи, мапе, прилагођени обрасци или извештаји који захтевају рендеровање специфично за апликацију. Такође је одличан избор када желите да опције штампања унапред подесите према типу документа или подешавањима корисника, или када штампање треба да уклопите у вишекорачне токове рада у којима корисник не би смео да напусти Вашу апликацију.

Захтеви

Корисницима је потребна инсталирана апликација PrintHand са важећом лиценцом. Ваша апликација мора да укључи декларације PrintHand Intent API сервиса у свом манифесту и да имплементира протокол комуникације интентима како је описано у нашој API документацији и пример-коду.

PrintHand SDK даје директан приступ ниског нивоа нашем механизму за штампање и нуди максималну флексибилност и контролу за захтевне апликације. За разлику од Intent API-ја, који се ослања на PrintHand компоненте корисничког интерфејса, SDK Вам даје потпуну слободу да осмислите сваки аспект искуства штампања. Овај приступ је идеалан за пословне апликације, white-label решења и сваку апликацију у којој штампање треба да се одвија невидљиво у позадини, без учешћа корисника.

Са SDK-ом добијате детаљну контролу над сваким аспектом процеса штампања: откривањем и филтрирањем штампача, управљањем и инсталацијом драјвера, редом и приоритетима послова штампања, сопственом обрадом грешака и опоравком. Ваша апликација постаје у потпуности одговорна за цео ток штампања, од приказа опција штампача кориснику до обраде завршетка посла и грешака.

Напредне могућности

• Потпуна контрола интерфејса: направите сопствене екране за откривање штампача, подешавање и преглед у складу са дизајном своје апликације
• Штампање у позадини: извршавајте послове штампања без икаквог учешћа корисника и без компоненти интерфејса
• Управљање драјверима: програмски преузимајте драјвере за подржане уређаје и управљајте њима
• Сопствено рендеровање: пуна контрола над припремом садржаја и током рендеровања
• Пословне функције: ред послова, групно штампање, аутоматски избор штампача и сопствена обрада грешака

Сложеност имплементације

SDK захтева дубље разумевање концепата мобилног штампања и знатно више развојног рада него Intent API. Ваша апликација мора да обезбеди комплетан интерфејс за откривање штампача, да прикаже могућности и опције штампача, да обради преузимање и инсталацију драјвера, да управља животним циклусом посла штампања и да имплементира обраду грешака и опоравак. Тај труд се, међутим, исплаћује непревазиђеном флексибилношћу и контролом.

Структура SDK-а

PrintHand SDK се испоручује као 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 успешно уградите у своју апликацију.