كاميرا.startCapture

لبدء التقاط الفيديو أو التقاط الصور بفاصل زمني بناءً على قيمة captureMode في الخيارات. تمت إضافة هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

  • لا يحتوي هذا الأمر على معلَمة في نص الطلب. ما إذا كانت صورة تمرين متناوب يتمّ تحديد التقاط الصور أو تصويرها بواسطة خيار captureMode. بالنسبة إلى الالتقاط بفاصل زمني، يعتمد ما إذا كان الالتقاط مفتوحًا أم لا على ما إذا كانت captureNumber تساوي 0 أو أكبر منه. captureMode وcaptureInterval و يجب ضبط captureNumber قبل الفاصل الزمني. يجب ضبط captureMode فقط على "فيديو". قبل الفيديو الالتقاط، والذي لا يمكن إيقافه إلا باستخدام الأمر camera.stopCapture.

النتائج

  • التقاط فيديو بدون انقطاع (عندما يكون drawMode == "video" أو recordNumber == 0)
    • ما مِن نتائج.
  • التقاط فاصل زمني غير مفتوح:
    • fileUrls: قائمة بعناوين URL المطلقة تشير إلى الصورة من أجل الالتقاط بفاصل زمني. يُرجى ملاحظة أن هذا الأمر لا يعرض fileUrls فورًا بعد التقاط الصورة اكتمل captureNumber. يمكن تحديد تقدم الأمر من خلال استطلاع رأي الكاميرا بشكل دوري. على سبيل المثال، الاستطلاع بعد المدة المقدرة (time = captureInterval * (captureNumber - 1)) باستخدام واجهة برمجة التطبيقات /osc/commands/status وfileUrls هي النتيجة التي يتم عرضها عند انتهاء الأمر. إذا لم يكتمل الأمر بنجاح (على سبيل المثال، تم عرض 3 صور فقط من إجمالي الصور) تم التقاطها قبل نفاد شحن بطارية الكاميرا) أو عندما تكون الكاميرا غير متصلة من هاتف العميل في المنتصف، ولكن انتهى الأمر بنجاح، فينبغي أن يكون العميل قادرًا على الحصول على الصور باستخدام camera.listFiles لاحقًا عند إجراء اتصال جديد بين العميل والكاميرا.

الأخطاء

  • disableCommand: يكون الأمر غير مفعَّل حاليًا. على سبيل المثال، الكاميرا في منتصف التقاط الفيديو أو الالتقاط بفاصل زمني.
  • spamparamName: لم يتم التعرُّف على اسم المَعلمة. على سبيل المثال، لم يتم التعرّف على sessionId.

مفتاح Command I/O
إدخال الطلب 
none
مخرجات الأوامر 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
مخرجات الأوامر (خطأ) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}