camera.startCapture

بسته به مقدار captureMode در Options ، فیلمبرداری یا ضبط تصویر فاصله ای را شروع می کند. این دستور در سطح 2 API اضافه شده است.

پارامترها

  • این دستور هیچ پارامتری در بدنه درخواست ندارد. این که آیا این عکس برداری فاصله ای باشد یا فیلم برداری با گزینه captureMode تعیین می شود. برای ضبط بازه ای، باز بودن یا نبودن آن بستگی به این دارد که captureNumber برابر یا بزرگتر از 0 باشد. captureMode ، captureInterval و captureNumber باید قبل از ضبط فاصله تنظیم شوند. فقط captureMode باید قبل از ضبط ویدیو روی "video" تنظیم شود، که فقط با دستور camera.stopCapture می توان آن را متوقف کرد.

نتایج

  • عکسبرداری با پایان باز (وقتی captureMode == "ویدئو" یا captureNumber == 0)
    • بدون نتیجه.
  • ضبط بازه های بدون پایان:
    • fileUrls: فهرستی از URLهای مطلق که به فایل های تصویری برای ضبط فاصله اشاره می کند. لطفاً توجه داشته باشید که این دستور بلافاصله fileUrls بر نمی‌گرداند، زیرا برای تکمیل گرفتن captureNumber طول می‌کشد. پیشرفت دستور را می توان با نظرسنجی دوره ای دوربین به دست آورد. به عنوان مثال، نظرسنجی پس از مدت زمان تخمینی ( time = captureInterval * (captureNumber - 1) ) با استفاده از /osc/commands/status API و fileUrls نتیجه ای است که پس از پایان فرمان برمی گردد. اگر فرمان با موفقیت به پایان نرسید (مثلاً فقط 3 مورد از تصاویر قبل از تمام شدن باتری دوربین گرفته شده است) یا دوربین در وسط از تلفن مشتری جدا شده باشد، اما دستور با موفقیت به پایان برسد، مشتری باید بتواند برای به دست آوردن تصاویر با استفاده از camera.listFiles بعداً هنگامی که یک اتصال جدید بین مشتری و دوربین برقرار شد.

خطاها

  • disabledCommand: فرمان در حال حاضر غیرفعال است. به عنوان مثال، دوربین در وسط یک فیلم برداری یا یک فیلم برداری فاصله ای قرار دارد.
  • invalidParameterName: نام پارامتر ناشناخته است. برای مثال sessionId شناسایی نمی شود.

دستور I/O

ورودی فرمان
none
خروجی فرمان
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
خروجی فرمان (خطا)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}