> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jagaind.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Penyusupan Zona

> Tandai objek yang masuk ke area terlarang, seperti pintu darurat atau jalur evakuasi.

Modul **Penyusupan Zona** menandai objek yang masuk ke area yang dilarang.

**Cocok untuk:**

* Pintu darurat dan jalur evakuasi
* Jalur forklift atau jalur logistik
* Area panel listrik, gudang obat, atau ruang server
* Bahu jalan yang tidak boleh dilalui kendaraan

## Cara kerja

1. Anda menandai satu atau beberapa area terlarang di video.
2. Anda memilih jenis objek yang diawasi, misalnya orang atau kendaraan.
3. Saat objek target pertama kali terlihat di dalam area, modul mencatat satu kejadian **Masuk ke zona terlarang**.
4. Selama objek itu masih berada di area, modul tidak mencatat kejadian lagi. Keluar dari area juga tidak dicatat.

Objek yang keluar dari area selama lebih dari 2 detik lalu masuk lagi dihitung sebagai penyusupan baru. Keluar sesaat karena getaran deteksi di tepi area tidak dihitung keluar, sehingga tidak memicu alarm berulang. Bila objek sempat tidak terlihat karena terhalang kurang dari sekitar 10 detik, modul menganggapnya masih objek yang sama di area itu.

> [!NOTE]
>
> Bila modul baru dipasang atau pengaturannya baru disimpan, objek yang **sudah berada di dalam area** tidak langsung dilaporkan. Modul mulai melaporkan setelah objek itu keluar dan masuk lagi. Ini mencegah alarm palsu setiap kali Anda menyimpan pengaturan.

## Jenis kejadian

| Kejadian | Arti |
| - | - |
| **Masuk ke zona terlarang** | Objek target terlihat berada di dalam area terlarang. |

## Yang perlu digambar

Minimal satu **zona** berupa poligon dengan minimal 3 titik. Anda dapat menggambar beberapa zona; setiap zona dilaporkan sendiri.

## Pengaturan

| Pengaturan | Bawaan | Pilihan | Penjelasan |
| - | - | - | - |
| **Jenis objek** | `person` | `person`, `bicycle`, `car`, `motorcycle`, `bus`, `truck` | Objek yang dianggap menyusup saat berada di dalam zona. |

Ketik nama kelas atau pilih dari saran yang muncul, lalu pilih **Tambah**. Nilai di luar daftar ditolak saat disimpan.

## Tips

* Gunakan [Ignore Zone](https://docs.jagaind.com/kamera/cara-membuat-ignore-zone.md) untuk jalan atau layar yang tidak perlu diawasi.
* Atur **Cooldown** pada [aturan alarm](https://docs.jagaind.com/aturan/cara-membuat-aturan-alarm.md) sesuai tingkat risiko area. Cooldown berlaku per zona: beberapa orang yang masuk ke zona yang sama dalam satu periode cooldown menjadi satu insiden.
* Cocokkan **Jenis objek** dengan aturan alarm. Modul ini hanya mengirim kejadian **Masuk ke zona terlarang**, jadi pastikan aturan alarm memilih jenis kejadian itu.

## Batasan

* Modul menilai posisi titik kaki objek. Orang yang berdiri di luar area lalu menjangkau ke dalam tidak terdeteksi.
* Area dinilai dari gambar kamera. Bagian area yang tertutup objek lain atau keluar dari sudut pandang kamera tidak dapat diawasi.
* Modul ini melapor sekali saat objek masuk. Bila Anda perlu alarm ketika objek **berdiam** terlalu lama, gunakan [Berdiam Terlalu Lama](https://docs.jagaind.com/modul/berdiam-terlalu-lama.md).

## Lihat juga

* [Cara memasang modul](https://docs.jagaind.com/modul/cara-memasang-modul.md)
* [Cara membuat aturan alarm](https://docs.jagaind.com/aturan/cara-membuat-aturan-alarm.md)
* [Katalog Modul](https://docs.jagaind.com/modul/katalog-modul.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.