파일 (assets)
설정 화면에서 PDF · PPTX 문서와 PNG · JPEG · WebP · GIF 이미지를 올리고, 어느 화면에서든 그 파일 주소를 읽습니다. 동영상은 여기서 올리지 않습니다(동영상 플레이어).
개인정보 금지
학습자 개인정보가 담긴 파일(얼굴 사진 · 신분증 · 명단 등)은 올리지 마세요. 올린 파일 id는 settings에 저장되고, settings는 학생을 포함한 모든 보는 사람에게 내려갑니다.
// 설정 화면: 올리고 id를 settings에 저장
const controller = new AbortController();
const asset = await sdk.assets.post(input.files[0], {
onProgress: ({ loaded, total }) => (bar.value = loaded / total),
signal: controller.signal, // controller.abort()로 취소
});
await sdk.saveSettings({ ...sdk.material.settings, file: asset.id });
// 학습 화면: id로 서명된 주소 읽기
const file = await sdk.assets.get(sdk.material.settings.file);
if (file) viewer.src = file.url;
올리기 (post)
post(file, { onProgress?, signal? })는 { id, name, size, mime, url }을 돌려줍니다.
- edit 토큰으로 연 설정 화면에서만 됩니다. 다른 화면은
screen_not_supported, 저장 전 업로드의 설정 화면(#edit=1)은draft_not_saved입니다. - 종류는 파일의 MIME 타입, 없으면 확장자로 정합니다.
| 종류 | MIME · 확장자 | 최대 크기 |
|---|---|---|
application/pdf, .pdf | 95MB | |
| PPTX | .pptx | 95MB |
| PNG | image/png, .png | 10MB |
| JPEG | image/jpeg, .jpg · .jpeg | 10MB |
| WebP | image/webp, .webp | 10MB |
| GIF | image/gif, .gif | 10MB |
- SVG를 포함한 그 밖의 파일은
file_invalid_type입니다. - 0바이트이거나 한도를 넘으면 서버에 묻기 전에
file_invalid_size로 거절합니다. - 이미지는 받은 그대로 올립니다. 줄이거나 메타데이터(EXIF · GPS)를 지우려면 올리기 전에 직접 처리하세요.
- 파일은 최대 50MB 블록으로 나누어 보냅니다.
onProgress는 블록 하나를 보낼 때마다, 그리고 올리기가 끝나면loaded === total로 불립니다. 50MB보다 작은 파일은 끝날 때만 불립니다. - 취소하면
post는 signal의 이유(AbortError)로 실패합니다. 지우는 기능은 아직 없습니다.
읽기 (get)
get(id)는 { id, url } 또는 null을 돌려줍니다.
null인 경우:init()전, 화면 버전에 서명된 주소가 없을 때, 이 자료의 파일 id가 아닐 때.- 이름 · 크기 · 형식은 돌려주지 않습니다. 필요하면 올릴 때 받은 값을
settings에 함께 저장합니다.
url이 아니라 id를 저장하세요
id는 서버가 정한 저장 키(assets/{material_id}/{asset_id}.pdf 형식, 이미지는 그 확장자)입니다. url은 화면 주소처럼 만료되므로 settings에는 id를 저장하고, 보여 줄 때마다 get(id)로 주소를 받습니다.