camera.ProcessPicture

معالجة الصور التي تم التقاطها سابقًا، ولكن لم تتم معالجتها بعد. هذا الأمر مناسب فقط إذا كنت تستخدم delayProcessing بما أنّ وتستغرق المعالجة وقتًا طويلاً. إذا لم يكن جهازك متوافقًا مع delayProcessing، سيفشل طلب هذا الأمر مع رمز الخطأ disabledCommand. تمت إضافة هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

  • previewFileUrls: قائمة بعناوين URL للصور التي لم تتم معالجتها إذا كنت تريد معالجة جميع الصور التي لم تتم معالجتها في الكاميرا، يتم استخدام ["الكل"]. لا يمكن أن يكون فارغًا. إذا واجهت الكاميرا مشكلة في معالجة أي صورة، فإنّها لا يستجيب مع ظهور الخطأ، بل يجب تجاهل عنوان URL هذا ومتابعة غير ذلك، وقد تكون الحالة القصوى previewToFinalFileUrls هي على أنّه JSONObject فارغ.

النتائج

  • previewToFinalFileUrls: عنصر JSONObject بتنسيق JSON <key, value=""> حيث يكون كل مفتاح هو عنوان URL المطلق لصورة المعاينة، ويمثل كل مفتاح هي الصورة النهائية المقابلة التي تمت معالجتها ويمكن استخدامها لتنزيلها. من الكاميرا مباشرةً. يرجى ملاحظة أن هذا الأمر يشبه كاميرا.takePicture، ولن يتم عرض previewToFinalFileUrls على الفور (باستثناء حالة الزاوية التي سيتم توضيحها لاحقًا في هذه الفقرة) نظرًا تستغرق المعالجة (بما في ذلك التركيب داخل الكاميرا) بعض الوقت عادةً (تختلف من ثوانٍ إلى دقائق) لإكمالها. يتم معرفة مستوى تقدم الأمر من خلال استطلاع رأي الكاميرا بشكل دوري باستخدام واجهة برمجة التطبيقات /osc/commands/status previewToFinalFileUrls هي النتيجة التي يتم عرضها عند الأمر ينتهي. إذا انقطع الاتصال بالكاميرا قبل انتهاء الأمر، يمكن للعميل استخدام listFiles للحصول على عناوين URL للصور النهائية عند توصيل الجهاز بالكاميرا مرة أخرى أو تُصدر أمر processPicture آخر، والذي من المفترض أن يعرض previewToFinalFileUrls على الفور إذا كانت الصورتان سابقًا قبل إعادة الاتصال.</key,>

الأخطاء

  • DisableCommand:إذا لم تكن توفّر دعمًا لتأخير المعالجة.
  • spamPARAMName: اسم مَعلمة الإدخال هو. لم يتم التعرّف عليها.
  • invalidParameterValue: اسم معلَمة الإدخال هو ولكن تم التعرف عليها، ولكن قيمتها غير صالحة؛ على سبيل المثال، أي عنوان URL في previewFileUrls غير صالح.

مفتاح Command 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."
    }
}