камера.удалить

Удаляет файл по его URI. Эта команда была изменена на уровне API 2.

Параметры

  • API-уровень 1
    • fileUri: URI файла, который нужно удалить. Производители решают, использовать ли абсолютные или относительные URI. Клиенты могут рассматривать это как непрозрачный идентификатор.
  • API уровня 2
    • fileUrls: список абсолютных URL-адресов файлов, подлежащих удалению с камеры, которые были получены ранее, например, из команд camera.listFiles или camera.takePicture . Есть три особых случая:
      • В списке содержится только строка «все»: удалить все файлы в камере.
      • Список содержит только строку «изображение»: удалить все изображения в камере.
      • В списке содержится только строка «видео»: удалить все видео в камере.

Результаты

  • fileUrls: URL-адреса файлов, которые не были успешно удалены. Обратите внимание, что это происходит, когда все URL-адреса в fileUrls действительны, но камере не удается удалить некоторые из них. Если какой-либо из URL-адресов недействителен, код ошибки invalidParameterValue должен быть возвращен без удаления какого-либо файла. Это было добавлено на уровне API 2.

Ошибки

  • MissingParameter: fileUri не указан.
  • validParameterName: имя входного параметра не распознано.
  • validParameterValue: имя входного параметра распознано, но его значение недопустимо; например, fileUri не существует на уровне API 1, или какой-либо URL-адрес в fileUrls не существует на уровне API 2.

Командный ввод/вывод

Ввод команды (уровень 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"
        ]
    }
}
Вывод команды (уровень API 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Вывод команды (ошибка) (уровень API 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}