دوربین.فرآیندتصویر

پردازش تصاویر، که قبلا گرفته شده بود، اما هنوز پردازش نشده است. این دستور فقط در صورتی مرتبط است که delayProcessing پشتیبانی می‌کنید زیرا پردازش طولانی است. اگر delayProcessing پشتیبانی نمی‌کنید، درخواست این دستور باید با کد خطا disabledCommand ناموفق باشد. این دستور در سطح 2 API اضافه شده است.

مولفه های

  • previewFileUrls: فهرستی از URLهای تصاویر پردازش نشده. اگر می خواهید تمام تصاویر پردازش نشده در دوربین را پردازش کنید، ["همه"] است. نمی تواند خالی باشد. اگر دوربین در پردازش هر تصویری مشکل داشته باشد، دوربین با خطا پاسخ نمی دهد، در عوض، باید آن URL را نادیده بگیرد و با دیگران ادامه دهد، و حالت شدید می تواند previewToFinalFileUrls به عنوان یک JSONObject خالی برگردانده شود.

نتایج

  • previewToFinalFileUrls: یک شی JSON از JSON جفت، که در آن هر کلید URL مطلق تصویر پیش نمایش است، و هر کلید تصویر نهایی پردازش شده مربوطه است و می توان از آن برای دانلود مستقیم از دوربین استفاده کرد. لطفاً توجه داشته باشید که این دستور شبیه camera.takePicture است و فوراً previewToFinalFileUrls بر نمی گرداند (به جز یک مورد گوشه ای که بعداً در این پاراگراف توضیح داده شد) زیرا پردازش (از جمله دوخت در دوربین) معمولاً مدتی طول می کشد (از چند ثانیه تا چند دقیقه متفاوت است). ) برای تکمیل. پیشرفت فرمان با نظرسنجی دوره‌ای از دوربین با استفاده از /osc/commands/status API بدست می‌آید و previewToFinalFileUrls نتیجه‌ای است که پس از پایان فرمان بازگردانده می‌شود. اگر قبل از پایان فرمان، اتصال به دوربین قطع شود، مشتری می‌تواند از listFiles برای به دست آوردن URL تصاویر نهایی هنگام اتصال مجدد به دوربین استفاده کند یا دستور previewToFinalFileUrls دیگری صادر کند، که اگر تصاویر قبلاً قبل از اتصال مجدد

خطاها

  • disabledCommand: اگر از پردازش تاخیری پشتیبانی نمی کنید.
  • invalidParameterName: نام پارامتر ورودی شناسایی نشده است.
  • invalidParameterValue: نام پارامتر ورودی شناسایی می شود، اما مقدار آن نامعتبر است. برای مثال، هر URL در previewFileUrls نامعتبر است.

دستور I/O

ورودی فرمان
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
خروجی فرمان
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
خروجی فرمان (خطا)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}