docs/docs/fa/nodes/camera.md

read_when	summary	title	x-i18n
افزودن یا تغییر ضبط دوربین روی گره‌های iOS/Android یا macOS گسترش جریان‌های کاری فایل موقت MEDIA قابل دسترسی برای عامل	ضبط با دوربین (Nodeهای iOS/Android + برنامهٔ macOS) برای استفادهٔ عامل: عکس‌ها (jpg) و کلیپ‌های ویدیویی کوتاه (mp4)	ثبت تصویر با دوربین	generated_at model provider source_hash source_path workflow 2026-04-29T23:07:55Z gpt-5.5 openai 33e23a382cdcea57e20ab1466bf32e54dd17e3b7918841dbd6d3ebf59547ad93 nodes/camera.md 16

OpenClaw از ثبت با دوربین برای گردش‌کارهای agent پشتیبانی می‌کند:

• Node iOS (جفت‌شده از طریق Gateway): ثبت یک عکس (jpg) یا کلیپ ویدیویی کوتاه (mp4، با صدای اختیاری) از طریق node.invoke.
• Node Android (جفت‌شده از طریق Gateway): ثبت یک عکس (jpg) یا کلیپ ویدیویی کوتاه (mp4، با صدای اختیاری) از طریق node.invoke.
• برنامه macOS (Node از طریق Gateway): ثبت یک عکس (jpg) یا کلیپ ویدیویی کوتاه (mp4، با صدای اختیاری) از طریق node.invoke.

همه دسترسی‌های دوربین پشت تنظیمات تحت کنترل کاربر قرار دارند.

Node 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 در Node iOS)
    • quality: 0..1 (اختیاری؛ پیش‌فرض 0.9)
    • format: در حال حاضر jpg
    • delayMs: عدد (اختیاری؛ پیش‌فرض 0)
    • deviceId: رشته (اختیاری؛ از camera.list)
  • بار پاسخ:
    • format: "jpg"
    • base64: "<...>"
    • width, height
  • محافظ بار: عکس‌ها دوباره فشرده می‌شوند تا بار base64 زیر 5 MB بماند.

• camera.clip

  • پارامترها:
    • facing: front|back (پیش‌فرض: front)
    • durationMs: عدد (پیش‌فرض 3000، با سقف حداکثر 60000)
    • includeAudio: بولی (پیش‌فرض true)
    • format: در حال حاضر mp4
    • deviceId: رشته (اختیاری؛ از camera.list)
  • بار پاسخ:
    • format: "mp4"
    • base64: "<...>"
    • durationMs
    • hasAudio

الزام پیش‌زمینه

مانند canvas.*، Node iOS فقط در پیش‌زمینه اجازه فرمان‌های camera.* را می‌دهد. فراخوانی‌های پس‌زمینه NODE_BACKGROUND_UNAVAILABLE برمی‌گردانند.

کمک‌کننده CLI (فایل‌های موقت + MEDIA)

ساده‌ترین راه برای گرفتن پیوست‌ها استفاده از کمک‌کننده CLI است، که رسانه رمزگشایی‌شده را در یک فایل موقت می‌نویسد و MEDIA:<path> را چاپ می‌کند.

نمونه‌ها:

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 به‌طور پیش‌فرض از هر دو جهت استفاده می‌کند تا هر دو نما را به agent بدهد.
• فایل‌های خروجی موقت هستند (در پوشه موقت سیستم‌عامل)، مگر اینکه wrapper خودتان را بسازید.

Node 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.*، Node Android فقط در پیش‌زمینه اجازه فرمان‌های camera.* را می‌دهد. فراخوانی‌های پس‌زمینه NODE_BACKGROUND_UNAVAILABLE برمی‌گردانند.

فرمان‌های Android (از طریق Gateway node.invoke)

• camera.list
  • بار پاسخ:
    • devices: آرایه‌ای از { id, name, position, deviceType }

محافظ بار

عکس‌ها دوباره فشرده می‌شوند تا بار base64 زیر 5 MB بماند.

برنامه macOS

تنظیم کاربر (به‌طور پیش‌فرض خاموش)

برنامه همراه macOS یک چک‌باکس ارائه می‌کند:

• تنظیمات → عمومی → اجازه دوربین (openclaw.cameraEnabled)
  • پیش‌فرض: خاموش
  • وقتی خاموش است: درخواست‌های دوربین «دوربین توسط کاربر غیرفعال شده است» برمی‌گردانند.

کمک‌کننده CLI (فراخوانی Node)

از CLI اصلی openclaw برای فراخوانی فرمان‌های دوربین روی Node macOS استفاده کنید.

نمونه‌ها:

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

نکات:

• openclaw nodes camera snap به‌طور پیش‌فرض maxWidth=1600 است، مگر اینکه بازنویسی شود.
• در macOS، camera.snap پس از گرم‌شدن/پایدار شدن نوردهی، پیش از ثبت، به اندازه delayMs (پیش‌فرض 2000ms) منتظر می‌ماند.
• بارهای عکس دوباره فشرده می‌شوند تا base64 زیر 5 MB بماند.

ایمنی + محدودیت‌های عملی

• دسترسی به دوربین و میکروفون درخواست‌های مجوز معمول سیستم‌عامل را فعال می‌کند (و به رشته‌های usage در Info.plist نیاز دارد).
• کلیپ‌های ویدیویی محدود می‌شوند (در حال حاضر <= 60s) تا از بارهای بیش‌ازحد بزرگ Node جلوگیری شود (سربار base64 + محدودیت‌های پیام).

ویدیوی صفحه macOS (در سطح سیستم‌عامل)

برای ویدیوی صفحه (نه دوربین)، از همراه macOS استفاده کنید:

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

نکات:

• به مجوز ضبط صفحه macOS نیاز دارد (TCC).

مرتبط

• پشتیبانی از تصویر و رسانه
• درک رسانه
• فرمان موقعیت مکانی