ملف تحميل الكاميرا

يصدر التطبيق هذا الأمر إلى الكاميرا لبدء تحميل صورة أو فيديو من الكاميرا مباشرة إلى خادم. ويجب أن تستخدم الكاميرا المعلمات المُدرجة لتقديم طلب HTTP POST. يتم تحديد الملف الذي سيتم تحميله من خلال fileUrl ويجب تحميله إلى uploadUrl بالتفويض الصحيح الذي يحدّده accessToken. تمت إضافة هذا الأمر في المستوى 2.1 من واجهة برمجة التطبيقات، وهو مرتبط بالتحميل المباشر

ويمكنك تنفيذ ذلك من خلال سطر أوامر على جهاز الكمبيوتر كما يلي:

curl -X post -H "Authorization: Bearer accessToken" -T fileUrl uploadUrl

المَعلمات

  • fileUrl: عنوان URL للملف الذي سيتم تحميله إلى الخادم.
  • uploadUrl: سلسلة تمثّل مكان تحميل الملف.
  • accessToken: رمز مميّز يتضمّن معلومات المصادقة للتحميل يتم الوصول إلى التطبيق من خلال التطبيق وإرساله إلى الكاميرا.

النتائج

  • لا يعرض هذا الأمر أي نتيجة.

الأخطاء

  • missingParameter: بعض المعلمات، على سبيل المثال، fileUrl مفقودة.
  • invalidParameterName: لم يتم التعرّف على اسم واحد أو أكثر من أسماء معلَمات الإدخال.
  • invalidParameterValue: تم التعرّف على أسماء معلَمات الإدخال، ولكن قيمة واحدة أو أكثر من القيم التي تم ضبطها غير صالحة. على سبيل المثال، لا يتوفّر الملف المحدّد في fileUrl.
  • تعذّر تحميل uploadError: الكاميرا.
الأمر I/O
إدخال الأوامر 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
إخراج الأوامر 
none
إخراج الأمر (خطأ) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}