كاميرا.حذف

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

المعلمات

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

النتائج

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

الأخطاء

  • غير متوفِّر: لم يتم تحديد fileUri.
  • spamparamName: لم يتم التعرُّف على اسم معلَمة الإدخال.
  • invalidParameterValue: يتم التعرّف على اسم معلَمة الإدخال، ولكن قيمتها غير صالحة؛ على سبيل المثال، لا تصل قيمة fileUri في المستوى 1 من واجهة برمجة التطبيقات أو أي عنوان URL في عناوين fileUrl لا يتوفّر في المستوى 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."
    }
}