دوربین.حذف

فایلی را با توجه به URI آن حذف می کند. این دستور در سطح 2 API اصلاح شد.

پارامترها

  • API سطح 1
    • fileUri: URI یک فایل برای حذف. تولیدکنندگان تصمیم می گیرند که از URI های مطلق یا نسبی استفاده کنند. مشتریان ممکن است این را به عنوان یک شناسه غیر شفاف تلقی کنند.
  • API سطح 2
    • fileUrls: فهرستی از URL های مطلق فایل هایی که باید از دوربین حذف شوند، که قبلاً به دست آمده بودند، به عنوان مثال از دستورات camera.listFiles یا camera.takePicture . سه مورد خاص وجود دارد:
      • لیست فقط شامل رشته "همه" است: تمام فایل های دوربین را حذف کنید.
      • لیست فقط شامل رشته "تصویر" است: تمام تصاویر موجود در دوربین را حذف کنید.
      • لیست فقط شامل رشته "ویدئو" است: تمام ویدیوهای موجود در دوربین را حذف کنید.

نتایج

  • fileUrls: آدرس فایل‌هایی که با موفقیت حذف نشده‌اند. لطفاً توجه داشته باشید که این زمانی اتفاق می‌افتد که همه URLهای موجود در fileUrls معتبر باشند اما دوربین نتواند برخی از آنها را حذف کند. اگر هر یک از URL ها نامعتبر است، کد خطا invalidParameterValue باید بدون حذف هیچ فایلی برگردانده شود. این در سطح 2 API اضافه شد.

خطاها

  • missingParameter: fileUri مشخص نشده است.
  • invalidParameterName: نام پارامتر ورودی شناسایی نشده است.
  • invalidParameterValue: نام پارامتر ورودی شناسایی می شود، اما مقدار آن نامعتبر است. به عنوان مثال، fileUri در سطح API 1 وجود ندارد یا هر URL در fileUrls در سطح API 2 وجود ندارد.

دستور I/O

ورودی فرمان (سطح API 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
خروجی فرمان (سطح API 1) 
none
خروجی فرمان (خطا) (سطح API 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
ورودی فرمان (سطح API 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
خروجی فرمان (سطح 2 API) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
خروجی فرمان (خطا) (سطح API 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}