camera.listImages

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

매개변수

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

결과

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

오류

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