camera.listImages

카메라의 모든 이미지를 나열합니다. 이 명령어는 API 수준 2에서 지원 중단되었습니다. 대신 camera.listFiles를 사용하세요.

카메라가 요청된 매개변수를 지원하지 않으면 카메라는 하드웨어에서 사용할 수 있는 최대 기능을 반환해야 합니다. 예를 들어 드물지만 {entryCount: 500, maxSize: 2000}과 같은 요청이 있을 수 있습니다. 응답은 오류를 발생시키는 대신 카메라에서 지원하는 최대 기능(예: {entryCount: 100, maxSize: 200})을 기반으로 해야 합니다. 다른 모든 경우에는 오류를 발생시키세요. 예를 들어 요청이 {entryCount: 500, maxSize: -500}인 경우 maxSize이 음수이므로 invalidParameterValue 오류가 발생합니다.

매개변수

  • entryCount: 원하는 항목 수입니다.
  • maxSize: 썸네일 이미지의 최대 크기입니다. max(thumbnail_width, hidden_height)입니다. includeThumb이 true인 경우에만 필요합니다 (아래 참고).
  • continuationToken: (선택사항) 이전 listImages 호출에서 반환한 문자열 유형의 불투명한 연속 토큰으로, 다음 이미지를 검색하는 데 사용됩니다. 처음 listImages 호출에서는 이 매개변수를 생략합니다. 참고: 카메라는 토큰을 생성하는 알고리즘을 담당합니다.
  • includeThumb: (선택사항) 기본값은 true입니다. 결과에서 썸네일 이미지를 생략하려면 false를 사용합니다.

결과

  • entry: 이미지 속성 목록입니다. 각 항목에는 선택사항인 위도와 경도를 제외한 다음 필드가 포함되어야 합니다.
    • name: 이름
    • uri: URI
    • size: 크기(바이트)
    • dateTimeZone: 이미지의 날짜, 시간, 시간대로, YYYY:MM:DD HH:MM:SS+(-)HH:MM 형식입니다. 시간은 24시간 형식을 사용합니다. 날짜와 시간은 빈 문자 1개로 구분됩니다. 시간대가 UTC 시간과 상쇄됩니다.
    • lat: (선택사항) 이미지 캡처 위치의 위도입니다.
    • lng: (선택사항) 이미지 캡처 위치의 경도입니다.
    • width: 이미지 너비
    • height: 이미지 높이
    • thumbnail: 썸네일 이미지의 Base64 인코딩 문자열입니다 (includeThumb == true인 경우).
  • totalEntry: 스토리지의 총 항목 수입니다.
  • continuationToken: (선택사항) 결과가 불완전한 경우에만 설정합니다. incomplete는 마지막 이미지를 포함하지 않는 등록정보를 의미합니다. 나머지 항목을 가져오려면 클라이언트가 토큰으로 listImages 명령어를 다시 호출해야 합니다.

오류

  • missingParameter: 필수 매개변수가 지정되지 않았습니다. 예를 들어 entryCount가 지정되지 않았습니다.
  • invalidParameterName: 입력 매개변수 이름을 인식할 수 없습니다.
  • invalidParameterValue: 입력 매개변수 이름은 인식되지만 그 값이 잘못되었습니다. 예를 들어 includeThumb가 true인 경우 continuationToken가 존재하지 않거나, 범위를 벗어났거나, 데이터 유형이 잘못되었거나, includeThumb의 데이터 유형이 잘못되었거나, maxSize의 데이터 유형이 잘못되었습니다.

명령어 I/O
명령어 입력 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
명령어 결과 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "uri": "image URI",
                "size": image size in bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00"
                "lat": 50.5324
                "lng": -120.2332
                "width": 2000
                "height": 1000
                "thumbnail": "ENCODEDSTRING"
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250,
        "continuationToken": "50"
    }
}
명령어 출력 (오류) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}