Android uygulamanıza yazdırma yetenekleri eklemenin en hızlı yolu. Android'in standart Paylaşım Intent mekanizmasını kullanarak, uygulamanız PrintHand'e özgü tek satır kod yazmadan yazdırma işlevselliği sunabilir. Kullanıcılar uygulamanızdan yazdırmaya uygun içeriği paylaştığında, PrintHand e-posta veya sosyal medya uygulamaları gibi paylaşım seçeneklerinden biri olarak otomatik olarak görünür.

Bu yaklaşım, minimum geliştirme çabasıyla yazdırma sağlamak isteyen uygulamalar için idealdir. PrintHand ile doğrudan bağlantısı olmayan birçok köklü uygulama, kullanıcılarının belgeler, resimler ve diğer içerikleri yazdırmasına izin vermek için bu yöntemi kullanır. Bu entegrasyonun güzelliği basitliğindedir: uygulamanız zaten diğer amaçlar için Android paylaşım işlevselliğini uyguluyorsa, yazdırma ücretsiz gelir.

Nasıl Çalışır

Kullanıcı uygulamanızda "Paylaş"ı seçtiğinde ve mevcut uygulamalar listesinden PrintHand'i seçtiğinde, Android içeriği PrintHand'e iletir. PrintHand daha sonra tüm yazdırma iş akışını halleder: içeriği işleme, önizleme gösterme, kullanıcının yazıcı ayarlarını yapılandırmasına izin verme ve sonunda işi seçilen yazıcıya gönderme. Uygulamanız sadece paylaşım eylemini başlatır ve PrintHand geri kalanını halleder.

Desteklenen İçerik Türleri

• Resimler: JPEG, PNG, GIF ve diğer standart resim formatları
• Belgeler: PDF dosyaları ve düz metin
• Web İçeriği: URL'ler ve HTML içeriği
• Özel Veri: Uygulamanızın standart Android intentleri aracılığıyla paylaşabileceği herhangi bir içerik

Gereksinimler

Kullanıcıların cihazlarında geçerli bir lisansa sahip PrintHand uygulaması yüklü olmalıdır. Uygulamanız özel izinler veya bağımlılıklar gerektirmez, yalnızca çoğu uygulamanın zaten kullandığı standart Android Paylaşım Intent uygulaması.

Uygulama

Uygulamanız zaten Android paylaşım işlevselliğini uyguluyorsa, ek kod gerekmez. Aksi takdirde, temel bir paylaşım eylemi uygulamak standart Android ShareCompat veya Intent.ACTION_SEND API'leri kullanılarak basittir. PrintHand belgeleri ve örnek kod, uygun uygulamaya örnekler sağlar.

Intent API, kodsuz paylaşım ile tam SDK entegrasyonu arasında güçlü bir orta nokta sağlar. Uygulamanızın kullanıcı arayüzü ve iş akışı üzerindeki kontrolü korurken, programatik olarak yazıcıları keşfetmenize, yazdırma seçeneklerini yapılandırmanıza ve yazdırma işlerini başlatmanıza olanak tanır. Bu, düşük seviyeli yazdırma işlemlerinin karmaşıklığı olmadan önemli kontrol isteyen geliştiriciler için en yaygın kullanılan entegrasyon yöntemidir.

Intent API ile özel yazıcı seçimi diyalogları oluşturabilir, ön ayarlı yazdırma yapılandırmaları oluşturabilir ve yazdırmayı uygulamanızın mevcut iş akışlarına sorunsuz bir şekilde entegre edebilirsiniz. Uygulamanız, yazıcı keşfi, seçenek yapılandırması, içerik işleme ve iş gönderimini işleyen iyi tanımlanmış bir dizi intent aracılığıyla PrintHand ile iletişim kurar. PrintHand bu istekleri işler ve uygulamanıza sonuçları döndürerek kullanıcı deneyimi üzerinde tam kontrol sağlar.

Ana Yetenekler

• Yazıcı Keşfi: WiFi, Bluetooth ve USB üzerinden kullanılabilir yazıcıları programatik olarak keşfedin
• Ayar Yapılandırması: Kağıt boyutu, yönlendirme, kalite, renk modu ve diğer yazıcıya özgü seçenekleri kontrol edin
• İçerik İşleme: PrintHand'in karmaşık belge işlemesini halletmesine izin verin veya önceden işlenmiş içerik gönderin
• Yazdırma İşi Yönetimi: Yazdırma başlatın, durumu izleyin ve sonuçları yönetin

Entegrasyon İş Akışı

Uygulamanız belirli işlemleri gerçekleştirmek için PrintHand'in Intent API hizmetine intentler gönderir. Örneğin, bir belge yazdırmak için uygulamanız: kullanılabilir yazıcıları keşfeder ve UI'ınızda sunar, kullanıcının bir yazıcı seçmesine ve seçenekleri yapılandırmasına izin verir, içerik ve seçilen ayarlarla bir yazdırma intenti gönderir ve yazdırma işi tamamlandığında onay alır. Her adım, Android geliştiricileri için entegrasyonu basitleştiren standart Android Intent iletişimini kullanır.

Kullanım Senaryoları

Intent API, ofis belgeleri, haritalar, özel formlar veya uygulamaya özgü işleme gerektiren raporlar gibi karmaşık içeriğe sahip uygulamalar için mükemmeldir. Ayrıca, belge türüne veya kullanıcı tercihlerine göre yazdırma seçeneklerini önceden ayarlamak istediğinizde veya kullanıcıların uygulamanızdan çıkmaması gereken çok adımlı iş akışlarına yazdırmayı entegre etmeniz gerektiğinde idealdir.

Gereksinimler

Kullanıcıların geçerli bir lisansa sahip PrintHand uygulaması yüklü olması gerekir. Uygulamanız, manifestonuza PrintHand Intent API hizmet bildirimlerini içermeli ve API referansımız ve örnek kodumuzda belgelendiği şekilde intent iletişim protokolünü uygulamalıdır.

PrintHand SDK, gelişmiş uygulamalar için maksimum esneklik ve kontrol sunarak yazdırma motorumuza doğrudan düşük seviyeli erişim sağlar. PrintHand'in UI bileşenlerine dayanan Intent API'sinin aksine, SDK yazdırma deneyiminin her yönünü tasarlamak için tam özgürlük verir. Bu yaklaşım, kurumsal uygulamalar, beyaz etiket çözümleri veya kullanıcı etkileşimi olmadan arka planda sessizce yazdırma gerektiren herhangi bir uygulama için idealdir.

SDK ile yazdırma sürecinin her yönü üzerinde ayrıntılı kontrol elde edersiniz: yazıcı algılama ve filtreleme, sürücü yönetimi ve kurulumu, iş kuyruğu oluşturma ve önceliklendirme, özel hata işleme ve kurtarma. Uygulamanız, kullanıcıya yazıcı seçeneklerini sunmaktan iş tamamlanmasını ve hataları yönetmeye kadar tüm yazdırma iş akışından tamamen sorumlu olur.

Gelişmiş Yetenekler

• Tam UI Kontrolü: Uygulamanızın tasarımıyla eşleşen özel yazıcı keşfi, yapılandırma ve önizleme arayüzleri oluşturun
• Arka Plan Yazdırma: Herhangi bir kullanıcı etkileşimi veya UI bileşeni olmadan yazdırma işlerini çalıştırın
• Sürücü Yönetimi: Desteklenen cihazlar için yazıcı sürücülerini programatik olarak indirin ve yönetin
• Özel İşleme: İçerik hazırlama ve işleme hattı üzerinde tam kontrol
• Kurumsal Özellikler: İş kuyruğu oluşturma, toplu yazdırma, otomatik yazıcı seçimi ve özel hata işleme

Uygulama Karmaşıklığı

SDK, mobil yazdırma kavramlarının daha derin bir anlayışını ve Intent API'sinden önemli ölçüde daha fazla geliştirme çabası gerektirir. Uygulamanız, yazıcı keşfi için eksiksiz UI sağlamalı, yazıcı yeteneklerini ve seçeneklerini göstermeli, sürücü indirmelerini ve kurulumunu yönetmeli, yazdırma işi yaşam döngüsünü yönetmeli ve hata işleme ve kurtarma uygulamalıdır. Ancak bu çaba, eşsiz esneklik ve kontrolle ödüllendirilir.

SDK Yapısı

PrintHand SDK, doğrudan Android uygulamanıza entegre olan bir Java kütüphanesi olarak sağlanır. Tüm yazdırma işlemleri için kapsamlı bir API sunar, yazıcı yönetimi, iş gönderimi, durum izleme ve yapılandırma yönetimini kapsayan ayrıntılı belgelerle birlikte gelir. SDK, yüksek hacimli yazdırma senaryolarına uygun, thread-safe ve verimli olacak şekilde tasarlanmıştır.

Kullanım Senaryoları

Otomatik yazdırma iş akışları gerektiren kurumsal uygulamalar, kullanıcı etkileşimi olmadan makbuz yazdırma gerektiren satış noktası sistemleri, yüksek hacimli etiket yazdırma ile lojistik ve teslimat uygulamaları ve PrintHand markasının görünmemesi gereken beyaz etiket çözümleri için mükemmeldir.

Gereksinimler

Kullanıcıların cihazlarında geçerli bir lisansa sahip PrintHand uygulaması veya bağımsız PrintHand yazdırma hizmeti yüklü olması gerekir. Uygulamanız, SDK kütüphanesini projenize dahil etmeli ve optimal uygulama için yazıcı iletişim protokolleri ve Android yazdırma mimarisinin anlaşılmasını gerektirir.

Örnek Kod ve Kaynaklar

PrintHand entegrasyonuna başlamanıza yardımcı olmak için, üç entegrasyon yöntemini de gösteren kapsamlı bir örnek uygulama oluşturduk. Örnek kod, her yaklaşımı uygulamak, uç durumları ele almak ve harika bir kullanıcı deneyimi sağlamak için en iyi uygulamaları gösterir.

GitHub Deposu

PrintingSample depomuz, Paylaşım Intent, Intent API ve SDK entegrasyonunun çalışan örneklerini içerir. Kod iyi belgelenmiştir ve gerçek dünya kullanım modellerini gösterir. GitHub depomuzda ziyaret edin:

github.com/DynamixSoftware/PrintingSample

Dokümantasyon

Ayrıntılı API dokümantasyonu, entegrasyon kılavuzları ve sorun giderme kaynakları depo wiki'sinde mevcuttur. Geliştirici geri bildirimlerine ve yeni Android sürümlerine göre dokümantasyonu düzenli olarak güncelliyoruz.

Destek

Teknik sorular, entegrasyon yardımı veya sorun bildirimi için geliştirici destek ekibimizle support@printhand.com adresinden iletişime geçin. PrintHand'i uygulamanıza başarıyla entegre etmenize yardımcı olmak için buradayız.