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, 썸네일_높이)로 설정합니다. includeThumb이 true (아래)인 경우에만 필요합니다.
  • continuationToken: (선택사항) 문자열 유형의 불투명 연속 토큰으로, 이전 listImages 호출에서 반환되었으며 다음 이미지를 검색하는 데 사용됩니다. 첫 번째 listImages 호출에서는 이 매개변수를 생략합니다. 참고: 토큰을 생성하는 알고리즘은 카메라에 있습니다.
  • includeThumb: (선택사항) 기본값은 true입니다. 결과에서 썸네일 이미지를 생략하려면 false를 사용합니다.

결과

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

오류

  • missingParameter: 필수 매개변수가 지정되지 않았습니다. 예를 들어 entryCount는 지정되지 않습니다.
  • invalidParameterName: 입력 매개변수 이름은 다음과 같습니다. 인식할 수 없습니다.
  • invalidParameterValue: 입력 매개변수 이름은 인식되었지만 값이 잘못되었습니다. 예를 들어 continuationToken이(가) 존재하지 않고 범위를 벗어났습니다. 데이터 유형이 올바르지 않거나 includeThumb의 데이터 유형이 올바르지 않습니다. includeThumb가 다음과 같을 때 maxSize의 데이터 유형이 잘못됨 true를 반환합니다.

명령어 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."
    }
}