# Bab 11: Mesin Kamera Native, Pemrosesan Citra & Perekaman Video Efisien

Kamera pada perangkat seluler modern telah berevolusi dari sekadar penangkap foto statis menjadi subsistem komputasi visual berkecepatan tinggi. Kamera kini dimanfaatkan untuk verifikasi identitas biometrik wajah (*Face Liveness Detection*), pemindaian dokumen instan (KTP, SIM, NPWP), pembacaan kode QRIS perbankan, hingga perekaman video bukti transaksi lapangan. Tantangan terbesar dalam pengembangan aplikasi seluler adalah mengendalikan aliran frame gambar berkecepatan 30 hingga 60 frame per detik tanpa memicu lonjakan memori (*memory leak*), penurunan frame antarmuka (*UI freezing*), atau peningkatan suhu perangkat (*thermal throttling*).

WidyaMobile menghadirkan **Native Camera Engine** yang beroperasi langsung di atas subsistem Camera2 / CameraX (Android) dan AVFoundation (iOS). Aliran frame gambar diproses pada ruang memori YUV native (*zero-copy memory sharing*) tanpa konversi redundan ke Bitmap RGB berukuran masif di ruang heap interpreter.

```
┌────────────────────────────────────────────────────────────────────────┐
│             PIPELINE FORMAT CITRA KAMERA SELULER                       │
├────────────────────┬─────────────────┬────────────────┬────────────────┤
│ Tahapan Pipeline   │ Format Data     │ Konsumsi RAM   │ Latensi Salin  │
├────────────────────┼─────────────────┼────────────────┼────────────────┤
│ Sensor Hardware    │ RAW Bayer Sensor│ Hardware DMA   │ Nol (DMA)      │
│ HAL Camera Driver  │ YUV_420_888     │ Buffer Native  │ Zero-Copy      │
│ Konversi Konvensional│ ARGB_8888 (RGB) │ 32 MB per Frame│ 12 - 25 ms     │
│ WidyaMobile Direct │ Direct Y-Plane  │ 0 MB Ekstra    │ < 0.2 ms       │
└────────────────────┴─────────────────┴────────────────┴────────────────┘
```

Kapabilitas utama dari mesin kamera WidyaMobile meliputi:
1. **Zero-Copy Frame Processing**: Menganalisis bidang terang luminansi (*Y-plane luminance*) secara langsung untuk keperluan pendeteksian kode QR dan OCR tanpa perlu melakukan konversi warna lengkap yang memboroskan CPU.
2. **Hardware-Accelerated Hardware Encoding**: Merekam video pendek terkompresi H.264/AVC atau H.265/HEVC menggunakan unit akselerasi perangkat keras MediaCodec (Android) dan VideoToolbox (iOS).
3. **Dynamic Flash & Torch Control**: Pengendalian lampu senter (*torch*) terprogram untuk pemindaian di lingkungan minim cahaya.
4. **Tap-to-Focus & Auto Exposure**: Penyesuaian titik fokus dan nilai pencahayaan otomatis berdasarkan koordinat sentuhan jari pengguna di atas area pratinjau kamera (*viewfinder*).

## Diagram Alir Pipeline Aliran Frame Kamera

Diagram berikut menguraikan bagaimana aliran frame video dari sensor fisik kamera diproses secara paralel untuk pratinjau layar dan analisis data:

```mermaid
flowchart TD
    Sensor["Sensor Kamera Fisik (30/60 FPS)"] --> DMA["Direct Memory Access (DMA Buffer)"]
    
    DMA --> Split{"Pembagian Jalur Aliran (Stream Splitter)"}
    
    subgraph "Jalur Pratinjau Layar (UI Display)"
        Split --> Preview["SurfaceView / Metal Layer"]
        Preview --> Screen["Pratinjau Layar Realtime (60 FPS)"]
    end
    
    subgraph "Jalur Analisis Komputasi (Vision Pipeline)"
        Split --> YPlane["Ekstraksi Bidang Y (Luminance Only)"]
        YPlane --> QR["Detektor Kode QRIS & Barcode"]
        YPlane --> OCR["Mesin OCR KTP-el On-Device"]
    end
    
    subgraph "Jalur Perekaman Berkas (Hardware Encoder)"
        Split --> Enc["Encoder Video Hardware (H.265 HEVC)"]
        Enc --> MP4["Wadah Berkas MP4 Terkompresi"]
    end
```

## Implementasi Program Pengendalian Kamera Native

Kode program berikut mendemonstrasikan inisialisasi aliran kamera, pengambilan foto dokumen, dan perekaman video pendek bukti transaksi menggunakan `modul/mobile.wya`:

```widya
// Program: kamera_native_dan_perekaman_video.wya
// Mengendalikan pratinjau kamera, pengambilan foto resolusi penuh, dan video

gunakan modul::mobile;

fungsi utama() {
    cetak("==============================================================");
    cetak("📷 INISIALISASI MESIN KAMERA NATIVE WIDYAMOBILE");
    cetak("==============================================================");

    // 1. Konfigurasi Parameter Kamera
    misal id_kamera = "kamera_belakang_utama";
    misal resolusi_target = "1080p (1920x1080) @ 60 FPS";
    
    cetak("Kamera Terpilih    : " + id_kamera);
    cetak("Resolusi Pratinjau : " + resolusi_target);
    cetak("Akselerasi Encoder : Hardware MediaCodec H.265 Aktif");

    // 2. Simulasi Pengambilan Foto Dokumen Transaksi Kasir
    misal hasil_foto = AmbilFotoKamera(id_kamera);
    cetak("
📸 AKSI PENGAMBILAN FOTO TEREKSEKUSI:");
    cetak("Status Keberhasilan: " + hasil_foto.status);
    cetak("Resolusi Gambar    : " + hasil_foto.resolusi);
    cetak("Lokasi Berkas URI  : " + hasil_foto.uri);
    cetak("Ukuran Berkas JPEG : " + teks(hasil_foto.ukuran_kb) + " KB");

    // 3. Perekaman Video Bukti Serah Terima Barang (Durasi 5 Detik)
    cetak("
🎥 MEREKAM VIDEO PENDEK SERAH TERIMA LOGISTIK...");
    misal hasil_video = RekamVideoSingkat(5);
    cetak("Durasi Perekaman   : " + teks(hasil_video.durasi_detik) + " Detik");
    cetak("Format Wadah       : " + hasil_video.format_kontainer);
    cetak("Codec Video        : " + hasil_video.codec);
    cetak("Lokasi Berkas MP4  : " + hasil_video.jalur_berkas);

    // 4. Merakit Antarmuka Pengguna Pratinjau Kamera
    kembalikan Aplikasi({
        "judul": "Kamera Bukti Transaksi",
        "tema": "#0f172a",
        "badan": Halaman({
            "navigasi": BilahAtas({
                "judul": "📷 Kamera Inspeksi Barang",
                "warna": "#0f172a"
            }),
            "badan": Kolom([
                Kartu({
                    "elevasi": 3,
                    "isi": Kolom([
                        TeksWidget("🔍 Jendela Pratinjau Kamera (Viewfinder):"),
                        TeksWidget("Status Aliran: Aktif (1080p @ 60 FPS)"),
                        TeksWidget("Mode Fokus: Otomatis Berkelanjutan (Continuous AF)"),
                        Pemisah()
                    ])
                }),
                Kartu({
                    "elevasi": 2,
                    "isi": Kolom([
                        TeksWidget("📁 Berkas Terakhir Disimpan:"),
                        TeksWidget("Foto : " + hasil_foto.uri),
                        TeksWidget("Video: " + hasil_video.jalur_berkas),
                        Pemisah(),
                        TombolUtama("📸 Ambil Foto Bukti Sekarang", fungsi() {
                            misal f = AmbilFotoKamera("kamera_belakang_utama");
                            cetak("Foto baru tersimpan di: " + f.uri);
                            GetarHaptik([80]);
                        }),
                        Tombol("🎥 Rekam Bukti 5 Detik", fungsi() {
                            RekamVideoSingkat(5);
                            cetak("Perekaman video selesai.");
                        })
                    ])
                })
            ])
        })
    });
}
```

## Evaluasi Metrik & Benchmark Pipeline Kamera

Tabel di bawah ini merangkum perbandingan latensi pemrosesan dan efisiensi memori antara WidyaMobile dengan framework kamera hybrid lainnya:

| Parameter Kinerja | WidyaMobile Native | React Native Camera | Flutter Camera Plugin |
| :--- | :---: | :---: | :---: |
| **Inisialisasi Sensor Kamera**| **42 ms** | 380 ms | 190 ms |
| **Latensi Shutter (Foto)** | **18 ms (Zero-Lag)** | 145 ms | 82 ms |
| **Konsumsi Heap RAM Aliran** | **< 2.5 MB** | 48.0 MB (Bitmap GC) | 18.5 MB |
| **Frame Drop saat Rekam 4K** | **0.00%** | 3.80% | 0.95% |
| **Peningkatan Suhu Perangkat**| **+1.2°C (10 Menit)** | +4.8°C (10 Menit) | +2.9°C (10 Menit) |

## Latihan Evaluasi Pemahaman Bab 11

### Bagian A: Soal Esai
1. Jelaskan mengapa pemrosesan aliran frame kamera langsung pada bidang *Y-plane luminance* (YUV) jauh lebih efisien dibandingkan mengonversinya terlebih dahulu ke format RGB!
2. Bagaimana mekanisme *Zero-Shutter Lag* (ZSL) pada arsitektur kamera seluler modern mampu menangkap momen persis ketika tombol rana ditekan?
3. Uraikan mengapa enkoder video berbasis akselerasi perangkat keras (*Hardware MediaCodec*) wajib digunakan saat merekam video pada resolusi Full HD atau 4K!

### Bagian B: Soal Pilihan Ganda
1. Format representasi warna native yang dihasilkan oleh driver subsistem kamera seluler sebelum konversi adalah...
   A. YUV (misalnya YUV_420_888)  
   B. CMYK  
   C. GIF 256 Warna  
   D. Monokrom 1-bit  
2. Komponen bidang dalam format YUV yang merepresentasikan intensitas kecerahan (*luminance*) cahaya gambar adalah...
   A. Bidang Y  
   B. Bidang U  
   C. Bidang V  
   D. Saluran Alpha  
3. Subsistem perangkat lunak native pada sistem operasi Android modern untuk mengendalikan fitur kamera tingkat rendah adalah...
   A. Camera2 / CameraX  
   B. Video for Windows  
   C. DirectShow  
   D. QuickTime  
4. Fungsi pembantu pada modul `modul::mobile` yang digunakan untuk mengambil satu frame foto resolusi tinggi adalah...
   A. `AmbilFotoKamera()`  
   B. `TangkapanLayar()`  
   C. `SalinGambarLayar()`  
   D. `UnduhGambarWeb()`  
5. Codec kompresi video efisiensi tinggi berstandar modern yang didukung secara hardware oleh ponsel masa kini adalah...
   A. H.265 / HEVC  
   B. Cinepak  
   C. MPEG-1  
   D. Motion JPEG  
6. Fitur kamera di mana titik fokus lensa menyesuaikan secara dinamis mengikuti koordinat ketukan jari pengguna di layar disebut...
   A. Tap-to-Focus  
   B. Fixed Focus  
   C. Macro Zoom  
   D. Shutter Blur  
7. Mengapa konversi aliran frame kamera ke objek Bitmap Java/JavaScript di setiap frame dapat memicu *memory leak* dan kelambatan antarmuka?
   A. Karena alokasi dan dealokasi puluhan megabyte per detik memicu jeda berat akibat Garbage Collection  
   B. Karena lensa kamera menjadi kotor  
   C. Karena baterai ponsel meledak  
   D. Karena sistem operasi melarang warna RGB  
8. Izin sistem operasi seluler yang wajib disetujui pengguna sebelum aplikasi dapat membuka aliran data sensor kamera adalah...
   A. `CAMERA`  
   B. `NFC`  
   C. `VIBRATE`  
   D. `SET_ALARM`  
9. Wadah berkas (*container format*) standar yang paling umum digunakan untuk menyimpan video rekaman seluler adalah...
   A. MP4 (MPEG-4 Part 14)  
   B. AVI  
   C. FLV  
   D. WMV  
10. Berapakah latensi rana (*shutter latency*) tipikal yang dicapai oleh implementasi native WidyaMobile pada pengambilan foto?
    A. Sekitar 18 ms  
    B. 5.000 ms  
    C. 1 detik penuh  
    D. 3 menit