التقاط الكاميرا

• عقدة iOS (مقترنة عبر Gateway): التقط صورة (jpg) أو مقطع فيديو قصيرًا (mp4، مع صوت اختياري) عبر node.invoke.
• عقدة Android (مقترنة عبر Gateway): التقط صورة (jpg) أو مقطع فيديو قصيرًا (mp4، مع صوت اختياري) عبر node.invoke.
• تطبيق macOS (عقدة عبر Gateway): التقط صورة (jpg) أو مقطع فيديو قصيرًا (mp4، مع صوت اختياري) عبر node.invoke.

​

عقدة iOS

​

إعداد المستخدم (مفعّل افتراضيًا)

• تبويب إعدادات iOS ← الكاميرا ← السماح بالكاميرا (camera.enabled)
  • الافتراضي: مفعّل (يُعامل المفتاح المفقود على أنه مفعّل).
  • عند إيقافه: تعيد أوامر camera.* القيمة CAMERA_DISABLED.

​

الأوامر (عبر Gateway node.invoke)

• camera.list
  • حمولة الاستجابة:
    • devices: مصفوفة من { id, name, position, deviceType }
• camera.snap
  • المعاملات:
    • facing: front|back (الافتراضي: front)
    • maxWidth: رقم (اختياري؛ الافتراضي 1600 على عقدة iOS)
    • quality: 0..1 (اختياري؛ الافتراضي 0.9)
    • format: حاليًا jpg
    • delayMs: رقم (اختياري؛ الافتراضي 0)
    • deviceId: سلسلة نصية (اختياري؛ من camera.list)
  • حمولة الاستجابة:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • حماية الحمولة: يُعاد ضغط الصور لإبقاء حمولة base64 أقل من 5 ميغابايت.
• camera.clip
  • المعاملات:
    • facing: front|back (الافتراضي: front)
    • durationMs: رقم (الافتراضي 3000، ومحدود بحد أقصى 60000)
    • includeAudio: قيمة منطقية (الافتراضي true)
    • format: حاليًا mp4
    • deviceId: سلسلة نصية (اختياري؛ من camera.list)
  • حمولة الاستجابة:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

​

متطلب الواجهة الأمامية

​

مساعد CLI

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

• يستخدم nodes camera snap كلا الاتجاهين معًا افتراضيًا ليمنح الوكيل كلا المنظورين.
• ملفات الإخراج مؤقتة (في دليل النظام المؤقت) ما لم تبنِ مغلّفك الخاص.

​

عقدة Android

​

إعداد مستخدم Android (مفعّل افتراضيًا)

• ورقة إعدادات Android ← الكاميرا ← السماح بالكاميرا (camera.enabled)
  • الافتراضي: مفعّل (يُعامل المفتاح المفقود على أنه مفعّل).
  • عند إيقافه: تعيد أوامر camera.* القيمة CAMERA_DISABLED.

​

الأذونات

• يتطلب Android أذونات وقت التشغيل:
  • CAMERA لكل من camera.snap وcamera.clip.
  • RECORD_AUDIO لـ camera.clip عندما تكون includeAudio=true.

​

متطلب الواجهة الأمامية في Android

​

أوامر Android (عبر Gateway node.invoke)

• camera.list
  • حمولة الاستجابة:
    • devices: مصفوفة من { id, name, position, deviceType }

​

حماية الحمولة

​

تطبيق macOS

​

إعداد المستخدم (متوقف افتراضيًا)

• الإعدادات ← عام ← السماح بالكاميرا (openclaw.cameraEnabled)
  • الافتراضي: متوقف
  • عند إيقافه: تعيد طلبات الكاميرا “Camera disabled by user”.

​

مساعد CLI (استدعاء العقدة)

openclaw nodes camera list --node <id>            # list camera ids
openclaw nodes camera snap --node <id>            # prints saved 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 saved path
openclaw nodes camera clip --node <id> --duration-ms 3000      # prints saved path (legacy flag)
openclaw nodes camera clip --node <id> --device-id <id>
openclaw nodes camera clip --node <id> --no-audio

• يستخدم openclaw nodes camera snap القيمة maxWidth=1600 افتراضيًا ما لم يتم تجاوزها.
• على macOS، ينتظر camera.snap مدة delayMs (الافتراضي 2000ms) بعد الإحماء/استقرار التعريض قبل الالتقاط.
• يُعاد ضغط حمولات الصور لإبقاء base64 أقل من 5 ميغابايت.

​

السلامة والحدود العملية

• يؤدي الوصول إلى الكاميرا والميكروفون إلى مطالبات أذونات نظام التشغيل المعتادة (ويتطلب سلاسل استخدام في Info.plist).
• تُقيّد مقاطع الفيديو (حاليًا <= 60s) لتجنب حمولات العقد كبيرة الحجم (تكلفة base64 الإضافية + حدود الرسائل).

​

فيديو شاشة macOS (على مستوى نظام التشغيل)

openclaw nodes screen record --node <id> --duration 10s --fps 15   # prints saved path

• يتطلب إذن تسجيل الشاشة في macOS (TCC).

​

ذات صلة

• دعم الصور والوسائط
• فهم الوسائط
• أمر الموقع