Przechwytywanie obrazu z kamery

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• Node iOS (sparowany przez Gateway): przechwyć zdjęcie (jpg) lub krótki klip wideo (mp4, z opcjonalnym dźwiękiem) przez node.invoke.
• Node Android (sparowany przez Gateway): przechwyć zdjęcie (jpg) lub krótki klip wideo (mp4, z opcjonalnym dźwiękiem) przez node.invoke.
• Aplikacja macOS (Node przez Gateway): przechwyć zdjęcie (jpg) lub krótki klip wideo (mp4, z opcjonalnym dźwiękiem) przez node.invoke.

​

Node iOS

​

Ustawienie użytkownika (domyślnie włączone)

• Karta Ustawienia iOS → Kamera → Zezwalaj na kamerę (camera.enabled)
  • Domyślnie: włączone (brakujący klucz jest traktowany jako włączony).
  • Gdy wyłączone: polecenia camera.* zwracają CAMERA_DISABLED.

​

Polecenia (przez Gateway node.invoke)

• camera.list
  • Ładunek odpowiedzi:
    • devices: tablica { id, name, position, deviceType }
• camera.snap
  • Parametry:
    • facing: front|back (domyślnie: front)
    • maxWidth: liczba (opcjonalnie; domyślnie 1600 w Node iOS)
    • quality: 0..1 (opcjonalnie; domyślnie 0.9)
    • format: obecnie jpg
    • delayMs: liczba (opcjonalnie; domyślnie 0)
    • deviceId: string (opcjonalnie; z camera.list)
  • Ładunek odpowiedzi:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • Ochrona ładunku: zdjęcia są ponownie kompresowane, aby utrzymać ładunek base64 poniżej 5 MB.
• camera.clip
  • Parametry:
    • facing: front|back (domyślnie: front)
    • durationMs: liczba (domyślnie 3000, ograniczona do maksymalnie 60000)
    • includeAudio: boolean (domyślnie true)
    • format: obecnie mp4
    • deviceId: string (opcjonalnie; z camera.list)
  • Ładunek odpowiedzi:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

Wymóg pracy na pierwszym planie

​

Pomocnik CLI (pliki tymczasowe + MEDIA)

openclaw nodes camera snap --node <id>               # domyślnie: przód + tył (2 wiersze MEDIA)
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 3000
openclaw nodes camera clip --node <id> --no-audio

• nodes camera snap domyślnie używa obu kierunków, aby dać agentowi oba widoki.
• Pliki wyjściowe są tymczasowe (w katalogu tymczasowym systemu operacyjnego), chyba że zbudujesz własny wrapper.

​

Node Android

​

Ustawienie użytkownika Androida (domyślnie włączone)

• Arkusz Ustawienia Androida → Kamera → Zezwalaj na kamerę (camera.enabled)
  • Domyślnie: włączone (brakujący klucz jest traktowany jako włączony).
  • Gdy wyłączone: polecenia camera.* zwracają CAMERA_DISABLED.

​

Uprawnienia

• Android wymaga uprawnień czasu wykonywania:
  • CAMERA dla camera.snap i camera.clip.
  • RECORD_AUDIO dla camera.clip, gdy includeAudio=true.

​

Wymóg pracy na pierwszym planie w Androidzie

​

Polecenia Androida (przez Gateway node.invoke)

• camera.list
  • Ładunek odpowiedzi:
    • devices: tablica { id, name, position, deviceType }

​

Ochrona ładunku

​

Aplikacja macOS

​

Ustawienie użytkownika (domyślnie wyłączone)

• Ustawienia → Ogólne → Zezwalaj na kamerę (openclaw.cameraEnabled)
  • Domyślnie: wyłączone
  • Gdy wyłączone: żądania kamery zwracają „Kamera wyłączona przez użytkownika”.

​

Pomocnik CLI (wywołanie Node)

openclaw nodes camera list --node <id>            # wyświetl identyfikatory kamer
openclaw nodes camera snap --node <id>            # wypisuje 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          # wypisuje MEDIA:<path>
openclaw nodes camera clip --node <id> --duration-ms 3000      # wypisuje MEDIA:<path> (starsza flaga)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio

• openclaw nodes camera snap domyślnie używa maxWidth=1600, chyba że zostanie nadpisane.
• W macOS camera.snap czeka delayMs (domyślnie 2000 ms) po rozgrzaniu i ustabilizowaniu ekspozycji przed przechwyceniem.
• Ładunki zdjęć są ponownie kompresowane, aby utrzymać base64 poniżej 5 MB.

​

Bezpieczeństwo i praktyczne limity

• Dostęp do kamery i mikrofonu wywołuje zwykłe monity o uprawnienia systemu operacyjnego (i wymaga ciągów opisu użycia w Info.plist).
• Klipy wideo są ograniczone (obecnie <= 60s), aby uniknąć zbyt dużych ładunków Node (narzut base64 + limity wiadomości).

​

Wideo ekranu macOS (poziom systemu operacyjnego)

openclaw nodes screen record --node <id> --duration 10s --fps 15   # wypisuje MEDIA:<path>

• Wymaga uprawnienia macOS Nagrywanie ekranu (TCC).

​

Powiązane

• Obsługa obrazów i multimediów
• Rozumienie multimediów
• Polecenie lokalizacji