كاميرا.حذف

حذف ملف محدد عبر URI الخاص به. تم تعديل هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.

المَعلمات

  • المستوى 1 من واجهة برمجة التطبيقات
    • fileUri: معرّف الموارد المنتظم (URI) لملف سيتم حذفه. تقرّر الشركات المصنّعة ما إذا كان يجب استخدام معرفات الموارد المنتظمة (URI) المطلقة أو النسبية. قد يتعامل العملاء مع هذا المعرّف كمعرّف مبهم.
  • المستوى 2 من واجهة برمجة التطبيقات
    • fileUrls: قائمة بعناوين URL المطلقة للملفات التي سيتم حذفها من الكاميرا والتي تم الحصول عليها سابقًا من خلال أمر camera.listFiles أو camera.takePicture مثلاً. هناك ثلاث حالات خاصة:
      • تحتوي القائمة على السلسلة "all" فقط: حذف جميع الملفات في الكاميرا.
      • تحتوي القائمة على السلسلة "image" فقط: حذف جميع الصور في الكاميرا.
      • تحتوي القائمة على السلسلة "فيديو" فقط: يمكنك حذف جميع الفيديوهات في الكاميرا.

النتائج

  • fileUrls: عناوين URL للملفات التي لم يتم حذفها بنجاح. يُرجى العلم أنّ ذلك يحدث عندما تكون جميع عناوين URL المتوفّرة في عناوين URL للملفات صالحة ولكن يتعذّر على الكاميرا حذف بعضها. إذا كان أي من عناوين URL غير صالح، يجب عرض رمز الخطأ invalidParameterValue بدون حذف أي ملف. تمّت إضافة هذه الإعدادات في المستوى 2 من واجهة برمجة التطبيقات.

الأخطاء

  • missingParameter: لم يتم تحديد fileUri.
  • invalidParameterName: لم يتم التعرّف على اسم مَعلمة الإدخال.
  • validParameterValue: تم التعرّف على اسم معلَمة الإدخال، لكن قيمته غير صالحة. على سبيل المثال، لا يتوفر fileUri في المستوى 1 لواجهة برمجة التطبيقات أو أي عنوان URL في fileUrls غير متوفّر في المستوى 2 لواجهة برمجة التطبيقات.

Command I/O (إدخال وإخراج)
إدخال الأوامر (المستوى 1 من واجهة برمجة التطبيقات) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
مخرجات الأوامر (المستوى 1 من واجهة برمجة التطبيقات) 
none
مخرجات الأمر (الخطأ) (مستوى واجهة برمجة التطبيقات 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
إدخال الأوامر (المستوى 2 من واجهة برمجة التطبيقات) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
مخرجات الأوامر (المستوى 2 لواجهة برمجة التطبيقات) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
مخرجات الأمر (الخطأ) (مستوى واجهة برمجة التطبيقات 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}