# Kamera

Kamera menyediakan pengamatan gambar yang dilihat oleh kebijakan. Setiap backend — OpenCV, Intel RealSense, Reachy 2 — mengimplementasikan antarmuka `Camera`, sehingga penggantian perangkat keras tidak mengubah kode yang membaca frame.

Lihat [Panduan Kamera](../cameras) untuk memilih dan mengonfigurasi kamera, serta [Kamera & Sensor Pihak Ketiga](../third_party_sensors) untuk perangkat di luar set inti.

## Kamera[[lerobot.cameras.Camera]]

#### lerobot.cameras.Camera[[lerobot.cameras.Camera]]

```python
lerobot.cameras.Camera(config: CameraConfig)
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L26)

**Parameter:**

fps (float | None) : Bingkai per detik yang dikonfigurasi atau diukur

width (int | None) : Lebar bingkai dalam piksel

height (int | None) : Tinggi bingkai dalam piksel

Kelas dasar untuk implementasi kamera.

Mendefinisikan antarmuka standar untuk operasi kamera di berbagai backend. Subkelas harus mengimplementasikan semua metode abstrak.

Mengelola properti dasar kamera (FPS, resolusi) dan operasi inti:
- Koneksi/diskoneksi
- Penangkapan bingkai (sinkron/asinkron/terbaru)

#### connect[[lerobot.cameras.Camera.connect]]

```python
connect(warmup: bool = True)
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L99)

**Parameter:**

warmup : Jika True (default), menangkap bingkai pemanasan sebelum mengembalikan. Berguna untuk kamera yang membutuhkan waktu untuk menyesuaikan pengaturan penangkapan. Jika False, melewati bingkai pemanasan.

Buat koneksi ke kamera.

#### putuskan[[lerobot.cameras.Camera.disconnect]]

```python
disconnect()
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L181)

Putuskan koneksi dari kamera dan lepaskan sumber daya.

#### baca[[lerobot.cameras.Camera.read]]

```python
read()
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L110)

**Mengembalikan:** `np.ndarray`

Frame yang ditangkap sebagai array numpy.

Ambil dan kembalikan satu frame dari kamera secara sinkron.

Ini adalah panggilan yang memblokir dan akan menunggu perangkat keras beserta SDK-nya.

#### async_read[[lerobot.cameras.Camera.async_read]]

```python
async_read(timeout_ms: float = Ellipsis)
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L121)

**Parameter:**

timeout_ms : Waktu maksimum untuk menunggu frame baru dalam milidetik. Bawaan adalah 200ms (0,2s).

**Mengembalikan:** `np.ndarray`

Frame yang ditangkap sebagai array numpy.

**Mengangkat:** ``TimeoutError``

- ``TimeoutError`` -- Jika tidak ada frame baru yang tiba dalam `timeout_ms`.

Kembalikan frame baru yang paling terakhir.

Metode ini mengambil frame terbaru yang ditangkap oleh thread latar belakang. Jika frame baru sudah tersedia di buffer (ditangkap sejak pemanggilan terakhir), metode ini akan mengembalikannya secara langsung.

Itu memblokir hingga `timeout_ms` hanya jika buffer kosong atau jika frame terbaru sudah dikonsumsi oleh panggilan `async_read` sebelumnya.

Pada dasarnya, metode ini mengembalikan frame terbaru yang belum dikonsumsi, menunggu jika diperlukan hingga frame baru tiba dalam batas waktu yang ditentukan.

Penggunaan:
- Ideal untuk loop kontrol di mana Anda ingin memastikan setiap frame yang diproses
baru, secara efektif menyinkronkan loop Anda dengan FPS kamera.
- Penyebab timeout biasanya meliputi: FPS kamera yang sangat rendah, beban pemrosesan yang berat,
atau jika kamera terputus.

#### find_cameras[[lerobot.cameras.Camera.find_cameras]]

```python
find_cameras()
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/camera.py#L89)

**Mengembalikan:** List[Dict[str, Any]]

Daftar kamus, di mana setiap kamus berisi informasi tentang kamera yang terdeteksi.

Mendeteksi kamera yang tersedia dan terhubung ke sistem.

## CameraConfig[[lerobot.cameras.CameraConfig]]

#### lerobot.cameras.CameraConfig[[lerobot.cameras.CameraConfig]]

```python
lerobot.cameras.CameraConfig(fps: int | None = None, width: int | None = None, height: int | None = None)
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/configs.py#L60)

## make_cameras_from_configs[[lerobot.cameras.make_cameras_from_configs]]

#### lerobot.cameras.make_cameras_from_configs[[lerobot.cameras.make_cameras_from_configs]]

```python
lerobot.cameras.make_cameras_from_configs(camera_configs: dict)
```

[Sumber](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/cameras/utils.py#L25)

