카메라의 모든 이미지/모든 동영상/모든 이미지 및 동영상을 나열합니다. 시간이 걸릴 수 있습니다. 모든 파일을 나열하라는 요청을 여러 번 실행할 수 있습니다. 이 명령어는 API 수준 2에 추가되었습니다.
카메라가 요청된 매개변수를 지원하지 않는 경우
하드웨어에 사용할 수 있는
최대 용량을 제공합니다 예를 들어, 드물지만
요청: {entryCount: 500, maxSize: 2000} 오류를 발생시키는 대신
응답은 카메라가 지원하는 최대 기능에 기반해야 합니다.
{entryCount: 100, maxSize: 200}). 기타 모든 경우 오류를 발생시키세요.
사례 예를 들어 요청이 {entryCount: 500, maxSize: -500}인 경우
maxSize가 음수이므로 invalidParameterValue 오류가 발생합니다.
매개변수
- fileType: 나열할 파일의 유형으로 다음 중 하나여야 합니다. '이미지', '동영상', '모두'입니다.
- startPosition: (선택사항) 광고를 시작할 첫 번째 파일의 위치입니다. 목록에 반환됩니다. 생략할 경우 시작 위치는 0이며, 생성합니다. 마지막 파일의 위치보다 크면 결과에 오류 응답 대신 빈 항목이 있는 일반 응답을 반환합니다.
- entryCount: 반환할 원하는 항목의 수입니다. 다음에 해당하는 경우 남은 파일 수보다 많은 경우 오류 응답 대신 남은 실제 파일을 표시합니다.
- maxThumbSize: 썸네일 이미지의 최대 크기
max(thumbnail_width, 썸네일_높이)로 설정합니다. 클라이언트가 다음과 같은 경우
null로 설정됩니다. 결과에서 썸네일 이미지를 생략하려고 합니다.
결과
- entries: 이미지 속성의 목록입니다. 각 항목에는 다음 필드가 포함되어야 합니다.
위도와 경도는 예외입니다(선택사항).
<ph type="x-smartling-placeholder">
- </ph>
- name: 파일의 이름입니다.
- fileUrl: 파일의 절대 URL로, 카메라에서 직접 다운로드하는 데 사용할 수 있습니다.
- size: 파일의 크기(바이트)입니다.
- dateTimeZone: 파일의 날짜, 시간, 시간대이며 형식은 다음과 같습니다.
YYYY:MM:DD HH:MM:SS+(-)HH:MM입니다. 시간은 24시간 형식으로 입력합니다. 날짜 및 시간은 빈 문자 1개로 구분됩니다. 시간대는 UTC 시간으로부터의 오프셋입니다. 참고: 동영상 캡처의 종료를 나타냅니다. - lat: (선택사항) 파일 캡처 시점 위치의 위도입니다.
- lng: (선택사항) 파일 캡처 시 위치의 경도입니다.
- width: 이미지 또는 각 동영상 프레임의 너비입니다.
- height: 이미지 또는 각 동영상 프레임의 높이입니다.
- 썸네일: 파일 썸네일 이미지의 Base64 인코딩 문자열입니다 (
maxThumbSize != null인 경우). - isProcessed: 파일이
처리 (예: 병합됨)되거나 미리보기일 뿐입니다. 이는
delayProcessing를 true로 설정하지 않는 한 기본값입니다. 처리된 이미지가 있는 경우 해당하는 미리보기 이미지가 표시되더라도 표시되지 않아야 합니다. 그렇지 않으면 미리보기 이미지를 나열합니다. - previewUrl:
delayProcessing인 경우 기본적으로 빈 문자열이 지정됩니다. 는 지원되지 않거나isProcessed이 false인 경우 또는 미리보기 이미지인 경우입니다. 중간 결과로 생성되지 않은 경우에는 최종 이미지에 해당하는 미리보기 이미지를 반환합니다. 이것은 미리보기 이미지와 최종 이미지 간의 대응 관계를 나타냅니다.
- totalEntries: 총
fileType개 항목 스토리지, 예: fileType이 'image'인 경우 파일에 있는 총 이미지 수입니다. 사용할 수 있습니다
오류
- missingParameter: 필수 매개변수가 지정되지 않았습니다.
예를 들어
entryCount는 지정되지 않습니다. - invalidParameterName: 입력 매개변수 이름은 다음과 같습니다. 인식할 수 없습니다.
- invalidParameterValue: 입력 매개변수 이름이 인식됩니다.
값이 유효하지 않습니다. 예를 들어
entryCount는 음수입니다. 데이터 유형이 올바르지 않습니다.
명령어 I/O | |
|---|---|
| 명령어 입력 | {
"parameters": {
"entryCount": 50,
"maxThumbSize": 100
}
} |
| 명령어 결과 | {
"results": {
"entries": [
{
"name": "abc",
"fileUrl": "file URL",
"size": file size, # of bytes,
"dateTimeZone": "2014:12:27 08:00:00+08:00",
"lat": 50.5324,
"lng": -120.2332,
"width": 2000,
"height": 1000,
"thumbnail": "ENCODEDSTRING",
"isProcessed": true,
"previewUrl": ""
}
...
{
...
}
],
"totalEntries": 250
}
} |
| 명령어 출력 (오류) | {
"error": {
"code": "invalidParameterValue",
"message": "Parameter entryCount is negative."
}
} |