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

يدعم OpenClaw التقاط الكاميرا لسير عمل الوكلاء:

• عقدة 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

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

مثل canvas.*، لا تسمح عقدة iOS بأوامر camera.* إلا في الواجهة الأمامية. تعيد الاستدعاءات في الخلفية NODE_BACKGROUND_UNAVAILABLE.

مساعد CLI

أسهل طريقة للحصول على ملفات الوسائط هي عبر مساعد CLI، الذي يكتب الوسائط المفكوكة الترميز إلى ملف مؤقت ويطبع المسار المحفوظ.

أمثلة:

openclaw nodes camera snap --node <id>               # default: both front + back (2 MEDIA lines)openclaw nodes camera snap --node <id> --facing frontopenclaw nodes camera clip --node <id> --duration 3000openclaw 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.

إذا كانت الأذونات مفقودة، فسيطلبها التطبيق عندما يكون ذلك ممكنًا؛ وإذا رُفضت، تفشل طلبات camera.* بخطأ *_PERMISSION_REQUIRED.

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

مثل canvas.*، لا تسمح عقدة Android بأوامر camera.* إلا في الواجهة الأمامية. تعيد الاستدعاءات في الخلفية NODE_BACKGROUND_UNAVAILABLE.

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

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

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

يُعاد ضغط الصور لإبقاء حمولة base64 أقل من 5 ميغابايت.

تطبيق macOS

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

يعرض التطبيق المرافق على macOS مربع اختيار:

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

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

استخدم CLI الرئيسي openclaw لاستدعاء أوامر الكاميرا على عقدة macOS.

أمثلة:

openclaw nodes camera list --node <id>            # list camera idsopenclaw nodes camera snap --node <id>            # prints saved pathopenclaw nodes camera snap --node <id> --max-width 1280openclaw nodes camera snap --node <id> --delay-ms 2000openclaw nodes camera snap --node <id> --device-id <id>openclaw nodes camera clip --node <id> --duration 10s          # prints saved pathopenclaw 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 (على مستوى نظام التشغيل)

بالنسبة إلى فيديو الشاشة (وليس الكاميرا)، استخدم المرافق على macOS:

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

ملاحظات:

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

ذات صلة

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