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

# Kamera Yakalama

# Kamera yakalama (ajan)

OpenClaw, ajan iş akışları için **kamera yakalamayı** destekler:

* **iOS düğümü** (Gateway üzerinden eşleştirilmiş): `node.invoke` aracılığıyla **fotoğraf** (`jpg`) veya **kısa video klip** (`mp4`, isteğe bağlı sesle) yakalama.
* **Android düğümü** (Gateway üzerinden eşleştirilmiş): `node.invoke` aracılığıyla **fotoğraf** (`jpg`) veya **kısa video klip** (`mp4`, isteğe bağlı sesle) yakalama.
* **macOS uygulaması** (Gateway üzerinden düğüm): `node.invoke` aracılığıyla **fotoğraf** (`jpg`) veya **kısa video klip** (`mp4`, isteğe bağlı sesle) yakalama.

Tüm kamera erişimleri **kullanıcı tarafından kontrol edilen ayarlarla** sınırlandırılmıştır.

## iOS düğümü

### Kullanıcı ayarı (varsayılan açık)

* iOS Ayarlar sekmesi → **Kamera** → **Kameraya İzin Ver** (`camera.enabled`)
  * Varsayılan: **açık** (anahtar yoksa etkin kabul edilir).
  * Kapalıyken: `camera.*` komutları `CAMERA_DISABLED` döndürür.

### Komutlar (Gateway üzerinden `node.invoke`)

* `camera.list`
  * Yanıt yükü:
    * `devices`: `{ id, name, position, deviceType }` dizisi

* `camera.snap`
  * Parametreler:
    * `facing`: `front|back` (varsayılan: `front`)
    * `maxWidth`: sayı (isteğe bağlı; iOS düğümünde varsayılan `1600`)
    * `quality`: `0..1` (isteğe bağlı; varsayılan `0.9`)
    * `format`: şu anda `jpg`
    * `delayMs`: sayı (isteğe bağlı; varsayılan `0`)
    * `deviceId`: string (isteğe bağlı; `camera.list`’ten)
  * Yanıt yükü:
    * `format: "jpg"`
    * `base64: "<...>"`
    * `width`, `height`
  * Yük koruması: fotoğraflar, base64 yükünü 5 MB altında tutmak için yeniden sıkıştırılır.

* `camera.clip`
  * Parametreler:
    * `facing`: `front|back` (varsayılan: `front`)
    * `durationMs`: sayı (varsayılan `3000`, en fazla `60000` ile sınırlandırılır)
    * `includeAudio`: boolean (varsayılan `true`)
    * `format`: şu anda `mp4`
    * `deviceId`: string (isteğe bağlı; `camera.list`’den)
  * Yanıt yükü:
    * `format: "mp4"`
    * `base64: "<...>"`
    * `durationMs`
    * `hasAudio`

### Ön planda olma gereksinimi

`canvas.*` gibi, iOS düğümü `camera.*` komutlarına yalnızca **ön planda** izin verir. Arka plan çağrıları `NODE_BACKGROUND_UNAVAILABLE` döndürür.

### CLI yardımcı aracı (geçici dosyalar + MEDIA)

Ekleri almanın en kolay yolu, çözümlenmiş medyayı geçici bir dosyaya yazan ve `MEDIA:<path>` yazdıran CLI yardımcı aracını kullanmaktır.

Örnekler:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes camera snap --node <id>               # default: both front + back (2 MEDIA lines)
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio
```

Notlar:

* `nodes camera snap`, ajana her iki görünümü de sağlamak için varsayılan olarak **her iki** yüzeyi kullanır.
* Çıkış dosyaları, kendi sarmalayıcınızı oluşturmadıkça geçicidir (OS geçici dizininde).

## Android düğümü

### Android kullanıcı ayarı (varsayılan açık)

* Android Ayarlar sayfası → **Kamera** → **Kameraya İzin Ver** (`camera.enabled`)
  * Varsayılan: **açık** (anahtar yoksa etkin kabul edilir).
  * Kapalıyken: `camera.*` komutları `CAMERA_DISABLED` döndürür.

### Permissions

* Android çalışma zamanı izinleri gerektirir:
  * Hem `camera.snap` hem de `camera.clip` için `CAMERA`.
  * `includeAudio=true` durumunda `camera.clip` için `RECORD_AUDIO`.

İzinler eksikse, uygulama mümkün olduğunda istemde bulunur; reddedilirse, `camera.*` istekleri
`*_PERMISSION_REQUIRED` hatasıyla başarısız olur.

### Android ön planda olma gereksinimi

`canvas.*` gibi, Android düğümü `camera.*` komutlarına yalnızca **ön planda** izin verir. Arka plan çağrıları `NODE_BACKGROUND_UNAVAILABLE` döndürür.

### Yük koruması

Fotoğraflar, base64 yükünü 5 MB altında tutmak için yeniden sıkıştırılır.

## macOS uygulaması

### Kullanıcı ayarı (varsayılan kapalı)

macOS yardımcı uygulaması bir onay kutusu sunar:

* **Ayarlar → Genel → Kameraya İzin Ver** (`openclaw.cameraEnabled`)
  * Varsayılan: **kapalı**
  * Kapalıyken: kamera istekleri “Camera disabled by user” döndürür.

### CLI yardımcı aracı (düğüm çağırma)

macOS düğümünde kamera komutlarını çağırmak için ana `openclaw` CLI’sını kullanın.

Örnekler:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes camera list --node <id>            # list camera ids
openclaw nodes camera snap --node <id>            # prints MEDIA:<path>
openclaw nodes camera snap --node <id> --max-width 1280
openclaw nodes camera snap --node <id> --delay-ms 2000
openclaw nodes camera snap --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --duration 10s          # prints MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # prints MEDIA:<path> (legacy flag)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio
```

Notlar:

* `openclaw nodes camera snap`, geçersiz kılınmadıkça varsayılan olarak `maxWidth=1600`’dir.
* macOS’te, `camera.snap` çekimden önce ısınma/pozlama dengelenmesinden sonra `delayMs` (varsayılan 2000 ms) bekler.
* Fotoğraf yükleri, base64’ü 5 MB altında tutmak için yeniden sıkıştırılır.

## Güvenli kullanım + pratik sınırlar

* Kamera ve mikrofon erişimi, olağan OS izin istemlerini tetikler (ve Info.plist’te kullanım dizgeleri gerektirir).
* Video klipler, aşırı büyük düğüm yüklerini önlemek için (şu anda `<= 60s`) sınırlandırılmıştır (base64 ek yükü + mesaj sınırları).

## macOS ekran videosu (OS düzeyi)

*Kamera* değil, *ekran* videosu için macOS yardımcı uygulamasını kullanın:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes screen record --node <id> --duration 10s --fps 15   # prints MEDIA:<path>
```

Notlar:

* macOS **Screen Recording** izni (TCC) gerektirir.