# 검사한 구조로 Motion과 내보내기 준비하기 [색인](/llms.txt) · [구조 검사](/docs/agents/tasks/inspection.md) · [브라우저 API](/docs/agents/api.md) 먼저 원본 문서·공정 단계·구조를 검증하고, 그 다음 카메라·표시 상태·시간을 작성합니다. 애니메이션이 자연스럽다는 사실은 구조나 물리적 변화가 맞다는 증거가 아닙니다. ## 지원 경로 | 작업 | 현재 경로 | 제공하지 않는 계약 | | --- | --- | --- | | Motion 장면·상태 작성과 재생 | 앱에서 Motion이 제공되고 운영자 접근 권한이 있을 때 | 모든 일반 계정에 자동 제공되는 기능 아님 | | 프레임 계획 JSON | 사용 가능한 활성 Motion UI의 내보내기 | 동영상 파일·실제 렌더 완료가 아님 | | Motion 작성 파일 읽기·쓰기 | 활성 Motion에 더해 개발 모드 필요 | 임의 프로젝트·격자·재료에 파일을 적용하는 기능 아님 | | Blender 패키지 | 개발 모드에서 실제 앱 프레임을 수집하는 경로 | 카메라 계획만으로 계산 구조를 새로 생성하는 기능 아님 | | 단면 SVG 등 뷰어 내보내기 | 해당 뷰에서 제공되는 앱 UI, 접근 조건에 따름 | 숫자 배열만으로 최종 화면 검증을 대신하지 않음 | | 브라우저 API 1.0 | 공정 계산과 수치 단면까지 | Motion·영상·SVG 내보내기 메서드 없음 | | 연결된 MCP | 계산·단면·구조 검사의 텍스트 결과 | 미리보기 이미지·Motion·영상 생성 도구 없음 | 내부 `MotionController` 함수를 공개 콘솔 API로 호출하는 예제를 만들지 마세요. 별도 Blender 제작 도구를 실행하려면 해당 런타임과 검증 경로가 준비되어 있어야 합니다. 이 안내는 Blender 설치나 원격 발행을 실행하지 않습니다. ## 작성 순서 1. 최종 문서와 단계 ID를 고정하고 중요한 중간·최종 구조를 검사합니다. 예전 리비전의 영상 계획을 새 구조의 증거로 사용하지 마세요. 2. Motion이 활성화된 UI에서 장면과 시작·끝 상태를 기록합니다. 상태에는 공정 위치, 카메라와 표시 조건이 포함됩니다. 원본의 이름·노트는 보존합니다. 3. 안전 영역과 화면 비율을 정한 뒤 재생을 확인합니다. 상태 간 시간은 증가해야 하며 장면의 시작·끝 상대 시간은 0과 1입니다. 4. 계획 JSON, 작성 파일, 실제 프레임을 담은 Blender 패키지를 목적에 맞게 구분해 내보냅니다. 작성 파일은 현재 원본과 일치할 때만 가져오며, 교체 전 백업을 보존합니다. 5. 최종 제작물에서는 프레임 누락, 잘림, 가려진 구조, 부적절한 투명도, 단면·카메라 변화와 설명 문구를 확인합니다. 코드 테스트나 패키지 생성만으로 시각 검사 PASS를 선언하지 마세요. Motion 작성 파일의 원본 검사는 프로젝트 ID, 공정, 도메인, 마스크, 재료, 해상도, ALD 엔진 모드가 일치하는지 확인합니다. 잘못된 카메라·시간·스냅샷이나 작업 도중 바뀐 프로젝트는 거부합니다. 허용된 작성 파일 가져오기는 원본 공정 문서를 바꾸는 우회 경로가 아닙니다. Blender 패키지 수집 중 프로젝트·문서·원본·개발 권한·뷰포트·화면비가 바뀌거나 취소되면 불완전 결과를 완성품으로 내보내지 않습니다. 렌더링에 필요한 구조·재료·카메라를 포함한 패키지와 이미 인코딩된 MP4/WebM은 다른 산출물입니다. ## 실행 비교: 일치하는 작성 파일과 바뀐 원본 저장소 루트에서 설치된 Node.js와 프로젝트 의존성으로 실행합니다. Blender나 브라우저를 열지 않고 실제 작성 파일 검증기·컨트롤러와 SVG payload 생성기를 검사합니다. ```powershell node dev/src/features/motion/__tests__/motion-authoring-file.verify.mjs node dev/src/features/rendering/__tests__/viewer-export-service.verify.mjs ``` | 비교 | 기대 결과 | | --- | --- | | 같은 공정·마스크·재료·격자 | 작성 파일 왕복 성공, 입력 파일 불변 | | 프로젝트/공정/재료/마스크/해상도 변경 | 원본 불일치로 거부 | | 카메라·상태 시간 변조 | 잘못된 상태로 거부 | | 개발 모드 아님·재생/복원 중·늦은 붙여넣기 | 변경과 백업 부작용 없이 거부 | | 유효한 작성 교체 | 이전 작성 파일 백업 후 교체; 원본 공정 유지 | | 단면 SVG 출력 옵션 비교 | 배경·범례·재료색·Connection 선택 상태가 payload에 반영 | 첫 검증의 카메라·구조는 작은 합성 입력입니다. 두 번째 검증도 파일 내용의 계약을 확인하며 실제 GPU 화면이나 동영상 품질을 검증하지 않습니다. 실제 결과물을 전달할 때는 최종 파일과 그 파일에서 검사한 범위를 따로 명시하세요. 근거: `MotionController.isAvailable`, `MotionAuthoringFile.js`, `MotionCompiler.js`, `MotionBlenderPackage.js`, `ViewerExportService.js`, 위의 두 실행 검증 파일.