Panduan Lengkap: Cara Mengintegrasikan Perangkat Lunak dengan Printer SUNMI

Berikut adalah langkah-langkah untuk mengintegrasikan perangkat lunak Anda dengan printer SUNMI yang menggunakan layanan cetak bawaan (Built-in Print Service):

1. Pahami Layanan Cetak SUNMI

Layanan cetak bawaan SUNMI dirancang untuk perangkat yang memiliki printer bawaan, seperti V2. Dengan layanan ini, Anda dapat mencetak struk atau dokumen secara langsung dari aplikasi Anda. Layanan ini mendukung berbagai metode koneksi dan menawarkan keunggulan teknis yang mempermudah integrasi perangkat keras dan perangkat lunak.

2. Persiapkan Lingkungan Pengembangan

• Unduh SUNMI SDK:
  • Kunjungi SUNMI Developer Center untuk mengunduh SDK, dokumentasi, atau demo aplikasi terkait.
• Pilih Metode Koneksi: SUNMI mendukung beberapa metode koneksi:
  • Bluetooth: Gunakan jika printer dan perangkat tidak terhubung secara fisik.
  • AIDL (Android Interface Definition Language): Cocok untuk aplikasi Android.
  • JavaScript Bridge: Digunakan untuk aplikasi berbasis web atau hybrid.

3. Implementasi Layanan Cetak

Berikut adalah panduan integrasi berdasarkan metode koneksi:

A. Menggunakan AIDL (Android Interface Definition Language):

1. Tambahkan SDK ke Proyek:
   • Tambahkan dependensi SDK SUNMI di file build.gradle.
2. Inisialisasi AIDL:
   • Hubungkan aplikasi dengan printer menggunakan file antarmuka AIDL yang disediakan oleh SUNMI.
   java

   Copy code

   // Contoh kode inisialisasi
IPrinter printer = SunmiPrinterApi.getInstance();
printer.initPrinter();

3. Kirim Perintah Cetak:
   • Gunakan fungsi seperti printText() atau printBitmap() untuk mencetak data.
   java

   Copy code

   printer.printText("Halo, ini adalah struk Anda!\n");


B. Menggunakan Bluetooth:

1. Pasangkan Printer dengan Perangkat:
   • Pastikan printer terhubung melalui Bluetooth dan terdeteksi oleh perangkat.
2. Gunakan Protokol Bluetooth:
   • Kirim perintah cetak melalui protokol komunikasi Bluetooth.

C. Menggunakan JavaScript Bridge:

1. Integrasi dengan WebView:
   • Tambahkan dukungan JavaScript di aplikasi berbasis WebView.
   javascript

   Copy code

   window.SunmiPrinter.printText("Halo, ini adalah struk Anda!\n");


4. Penyesuaian dan Pengaturan Global

• Atur Gaya Global: Anda dapat mengubah pengaturan cetak, seperti font atau margin, secara global tanpa memodifikasi kode aplikasi.
  java

  Copy code

  printer.setStyle(PrinterStyle.BOLD);

• Pantau Hasil Cetak dan Tangani Kesalahan: SUNMI dapat mendeteksi jika printer kehabisan kertas atau gagal mencetak. Tambahkan logika untuk menangani skenario ini.
  java

  Copy code

  if (printer.checkStatus() == PrinterStatus.OUT_OF_PAPER) {
// Tampilkan notifikasi atau opsi untuk mencetak ulang
}


5. Uji dan Implementasi

• Gunakan aplikasi demo SUNMI untuk menguji integrasi.
• Pastikan semua fungsi cetak berjalan dengan baik di perangkat target (misalnya V2, V2s, T2 MINI).

6. Model yang Didukung

Layanan cetak bawaan ini mendukung berbagai model perangkat SUNMI, termasuk:

• V2, V2s, T1 MINI, T2 MINI, dll.

Dengan langkah-langkah ini, Anda dapat dengan mudah mengintegrasikan perangkat lunak dengan printer bawaan SUNMI untuk mencetak dokumen atau struk secara efisien.