camera.delete

URI가 지정된 파일을 삭제합니다. 이 명령어는 API 수준 2에서 수정되었습니다.

매개변수

  • API 수준 1
    • fileUri: 삭제할 파일의 URI입니다. 제조업체는 절대 URI를 사용할지 상대 URI를 사용할지 결정합니다. 클라이언트는 이를 불투명 식별자로 취급할 수 있습니다.
  • API 수준 2
    • fileUrls: 카메라에서 삭제할 파일의 절대 URL 목록으로, 이전에 camera.listFiles 또는 camera.takePicture 명령어에서 가져온 값입니다. 다음과 같은 세 가지 특수한 사례가 있습니다.
      • 목록에는 'all' 문자열만 포함됩니다. 카메라의 모든 파일을 삭제합니다.
      • 목록에는 'image' 문자열만 포함됩니다. 카메라의 모든 이미지를 삭제합니다.
      • 목록에는 'video' 문자열만 포함됩니다. 즉, 카메라의 모든 동영상을 삭제합니다.

결과

  • fileUrls: 성공적으로 삭제되지 않은 파일의 URL입니다. 이 문제는 fileUrl의 모든 URL이 유효하지만 카메라에서 일부 URL을 삭제하지 못하는 경우에 발생합니다. 잘못된 URL이 있으면 파일을 삭제하지 않고 오류 코드 invalidParameterValue가 반환되어야 합니다. API 수준 2에 추가되었습니다.

오류

  • missingParameter: fileUri가 지정되지 않았습니다.
  • invalidParameterName: 입력 매개변수 이름을 인식할 수 없습니다.
  • invalidParameterValue: 입력 매개변수 이름은 인식되지만 그 값이 잘못되었습니다. 예를 들어 fileUri가 API 수준 1에 없거나 fileUrl의 URL이 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"
        ]
    }
}
명령어 출력 (API 수준 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
명령어 출력 (오류) (API 수준 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}