immersive-web은(는) 무엇을 하나요?
최고의 영화와 게임 같은 느낌을 주면서도 일반 페이지처럼 로드되고 누구도 소외시키지 않는 3D, 셰이더 및 스크롤 중심 경험을 구축하는 방법.
이 스킬은 하나의 레이어입니다. ui-craft 스킬(동일한 플러그인)은 레이아웃, 계층, 타이포그래피, 색상, 컴포넌트, 폼, 상태 등 일반적인 인터페이스 디자인을 담당합니다. 모든 UI 작업에는 이 스킬을 사용하고 여기서 반복하지 마십시오. 이 스킬은 그 위에 장면, 조명, 재질, 셰이더, 카메라, 스크롤 및 시네마틱 모션 레이어를 추가합니다. 두 스킬 모두 동일한 테마 토큰을 읽으므로 하나의 테마가 페이지와 장면을 모두 제어합니다 (references/theme-bridge.md 참조).
정직한 한계. 장면을 연출하고, 조명을 비추고, 카메라를 움직이고, 셰이더를 작성하고, 모델을 연결할 수 있습니다. 하지만 무에서 필름 수준의 3D 아트를 조각할 수는 없습니다. 단순한 지오메트리, 셰이더, 타이포그래피 및 조명으로 구성하거나 팀이 제공하는 모델을 사용하십시오. 주제를 조잡하게 그려서 속이려 하지 마십시오.
1. 아홉 가지 엄격한 규칙
하나라도 어기면 아무리 멋져 보여도 작업이 완료된 것이 아닙니다.
- 콘텐츠 우선. 제목, 본문, 링크 및 버튼은 실제 HTML이며, 스크립트가 실행되기 전에 읽을 수 있어야 합니다. 장면은 그 위에 추가되며 사라져도 손실이 없습니다. 페이지의 단어를 캔버스에 절대 그리지 마십시오. 스크립트가 표시할 때까지 기다리며 CSS에서
opacity: 0로 콘텐츠를 숨기지 마십시오. - 모든 효과에 대한 세 가지 상태. 전체; 동작 감소 (정지 프레임 또는 짧은 페이드:
prefers-reduced-motion, 기본 앱의 OS 설정); GPU 없음 (WebGL 또는 WebGPU가 없거나, 실패하거나, 컨텍스트가 손실되었을 때 표시되는 포스터 이미지 또는 CSS/SVG 아트). 먼저 두 가지 대체 수단을 디자인하십시오. 그것들이 또한 가장 먼저 로드됩니다. 대체 수단은 동일한 그림을 더 조용하게 표현한 것입니다: 동일한 각도에서 동일한 주제 (장면 자체에서 만든 포스터), 데이터 장면의 경우 동일한 데이터를 평면으로 그린 것입니다. 빈 상자, 단순한 그라데이션 또는 "이미지 준비 중"은 실패입니다. - 속도 예산, 구축 전에 결정 (§4). 페이지 텍스트가 먼저 칠해집니다. 엔진은 그 후에 로드됩니다. 휴대폰에서는 장면이 콘텐츠보다 비용이 적게 듭니다.
- 페이지당 하나의 시그니처 모먼트, 그리고 그것을 돋보이게 만드십시오. 하나의 장면, 하나의 아이디어, 완벽하게 완료하십시오. 다른 모든 것은 조용히 유지하십시오. 모든 곳에 효과가 있으면 템플릿처럼 보이고 사람들을 지치게 합니다. 절제는 효과의 수를 제한할 뿐 강도는 제한하지 않습니다: 하나의 모먼트는 이 제품에 속하는 이벤트여야 합니다 (주전자가 따르고; 눈이 적응함에 따라 하늘이 별들로 가득 차는 등), 누군가가 친구에게 설명할 수 있을 만큼 과감하게 연출되어야 합니다. 스크롤할 때만 돌아가는 객체는 모먼트가 아닙니다.
- 절대 스크롤을 가로채지 마십시오. 브라우저가 스크롤합니다. 당신은 위치만 읽습니다. 변경된 속도나 방향, 휠 하이재킹, 가짜 스크롤바는 없습니다.
position: sticky로 고정하고, 짧게 유지하며, 건너뛸 수 있는 방법을 제공하십시오. - 텍스트와 장면은 절대 같은 공간을 공유하지 마십시오. 모든 스크롤 위치에서 텍스트는 주제 옆이나 자체 표면 위에 있어야 하며, 절대 그 위에 겹쳐져서는 안 됩니다. 장면 위에 배치된 내비게이션과 버튼은 스크림 또는 표면을 확보하십시오. 첫 번째뿐만 아니라 모든 스크롤 스크린샷을 확인하십시오.
- 키보드와 스크린 리더는 모든 실제 요소에 접근할 수 있습니다. 탭 순서는 읽기 순서를 따릅니다. 장식용 캔버스는
aria-hidden="true"입니다. 의미 있는 캔버스는 옆에 텍스트 대체 수단이 있습니다. 장면을 드래그하여 할 수 있는 모든 것은 버튼으로도 할 수 있어야 합니다. - 모션은 안정되고, 사운드는 기다리며, 어떤 것도 깜빡이지 않습니다. 주변 모션은 5초 이내에 안정되거나 눈에 보이는 일시 정지 컨트롤이 있어야 합니다. 사운드는 요청하기 전까지 꺼져 있습니다. 초당 3회 이상 깜빡이지 마십시오. 화면 밖이나 숨겨진 탭에서 실행되지 않습니다.
- 독창적이고 라이선스를 준수하십시오. 장르의 언어를 배우십시오. 제품의 외관, 모델, 캐릭터, 로고 또는 사운드를 절대 복사하지 마십시오. 직접 만들었거나 명확한 라이선스가 있는 자산만 사용하십시오 (Poly Haven 및 ambientCG와 같은 CC0 라이브러리는 안전합니다). 각 자산을 기록하십시오.
2. 워크플로우 (매번 수행)
-
구축하기 전에 살펴보십시오. 테마를 찾으십시오:
theme.css,DESIGN.md(ui-craft Studio에서), 토큰, Tailwind 구성, 브랜드 색상.--immersive와 브리핑의 "Immersive and motion" 섹션(있는 경우)을 읽으십시오: 이는 소유자가 선택한 강도를 나타냅니다. 스택(일반 HTML, React, Vue, 앱 셸)과 이미 제공된 3D 자산을 확인하십시오. 테마가 전혀 없으면 먼저 ui-craft를 사용하여 방향을 선택하십시오. -
§3의 사다리에서 수준을 선택하십시오. 테마에 명시되어 있으면 그것을 따르십시오. 그렇지 않으면 아이디어를 전달할 수 있는 가장 낮은 수준을 선택하십시오. 레벨 3은 드뭅니다.
-
작업을 수행할 수 있는 가장 가벼운 도구를 선택하십시오.
필요사항 사용 도구 비용 시현, parallax 없는 스크롤 효과, 페이지 전환 CSS 전용: 스크롤 기반 애니메이션, position: sticky, View Transitions0 KB 평평한 생동감 있는 텍스처, 선, 필드, 2D 도형 Canvas 2D 또는 SVG, 또는 단일 삼각형의 하나의 프래그먼트 셰이더 (라이브러리 없는 raw WebGL) 2-5 KB 사용자가 돌릴 수 있는 하나의 3D 모델 표시 <model-viewer>약 250 KB, 지연 로딩 실제 장면: 여러 객체, 조명, 움직이는 카메라 three.js (React 앱: React Three Fiber), 동적 import()로 로드150-180 KB gzip, 지연 로딩 CSS로 표현할 수 없는 스크롤에 연결된 타임라인 GSAP ScrollTrigger (무료, 오픈소스 아님: 로드하고 복사하지 마십시오) 또는 Motion 25-45 KB 최신 GPU 기능 WebGL 경로 위의 업그레이드로서 WebGPU, 단독으로는 절대 사용하지 않음 - 부드러운 스크롤 라이브러리를 기본으로 추가하지 마십시오. 브리핑에서 요구하는 경우, 동작 감소 설정에서 자체적으로 꺼져야 합니다.
-
몰입형 브리핑을 작성하십시오 (코드 작성 전에 ui-craft 디자인 브리핑에 추가):
Level: 2 signature (테마 says --immersive: 2) Stack: 일반 HTML + three.js, 지연 로딩 Signature moment (턴테이블이 아닌 이벤트): beat 3에서 주전자가 기울어지고 얇은 물줄기가 흘러내리며 선을 유지합니다. Scene: 페이지 배경 위 빛 웅덩이 속의 무광 세라믹 주전자 하나; 왼쪽 위에서 부드러운 키 라이트, 따뜻한 림 Text lane: 데스크톱에서는 왼쪽 열의 복사본, 휴대폰에서는 고정된 장면 아래; 주전자는 절대 이를 가로지르지 않음 Camera: 35mm 스타일, 약간 위에서, 자체적으로 절대 움직이지 않음 Tempo: 부드럽게 (--dur-slow 400ms) Beats (레벨 3 전용): 1 전체 주전자 - 2 주둥이, 근접 - 3 따르기 - 4 탁자 위 세트 Reduced motion: 비트당 하나의 정지 렌더, 크로스페이드 No GPU: 동일한 장면의 포스터, 동일한 각도 Budget: 텍스트가 먼저 칠해짐; 엔진은 그 후; 휴대폰에서 장면 1.5 MB 미만; 터치 장치에서 픽셀 비율 1.5 -
이 순서대로 구축하십시오. (a) ui-craft를 사용한 일반 HTML 및 CSS로 된 전체 페이지, 장면 자리에는 포스터 또는 CSS 대체 수단. 이미 좋은 페이지여야 합니다. (b) 장면 셸:
assets/scene-shell.js는 지연 시작, 정지 프레임, 대체 수단, 오프 스크린 일시 정지, 픽셀 비율 제한, 컨텍스트 손실 복구를 제공합니다. (c) 테마 브리지:assets/theme-bridge.js는 색상, 반경 및 템포가 토큰에서 오도록 합니다. (d) 장면 자체, 가장 단순한 형태로. (e) 모션 및 스크롤. (f) 폴리싱: 조명, 재질, 그레인, 타이밍.assets/starter.html은 (a)-(c)가 완료된 작업 페이지입니다. 자리 표시자 장면을 교체하십시오. -
확인한 다음 살펴보십시오.
node <skill-dir>/scripts/immersive-check.mjs page.html을 실행하십시오. 다섯 가지 방식(데스크톱, 휴대폰, 동작 감소, WebGL 없음, JavaScript 없음)으로 페이지를 로드하고, 무게, 드로우 콜, 픽셀 비율, 네이티브 스크롤 및 일시 정지를 측정하고 스크린샷을 저장합니다. 앱 창(Electron, Tauri, 로그인된 웹 앱)의 경우--app를 추가하여 JavaScript 없음 테스트를 건너뜁니다. 모든 스크린샷을 여십시오. 실패한 것을 수정하십시오. 세 가지를 가장 주의 깊게 살펴보십시오: 스크롤 중간(텍스트가 주제를 가로지르고 있습니까?), 휴대폰 중간(장면과 텍스트가 하나의 화면에 함께 있고 빈 띠가 없습니까?), WebGL 없는 것(동일한 그림입니까, 아니면 구멍입니까?). 장면 자체에서 포스터를 만드십시오:--poster hero-poster.png는 데스크톱 패스 (--scheme light또는dark가 테마를 선택)에서 장면의 박스를 저장하여 대체 이미지로 사용할 준비가 됩니다. 그런 다음 ui-craft의ui-audit.mjs를 실행하여 대비, 탭 대상 및 타이포그래피를 확인하고, 데스크톱만큼 엄격하게 휴대폰을 평가하십시오. 최종 패스:references/accessibility-fallbacks.md체크리스트.
3. 몰입 사다리
모든 제품은 하나의 단계에 있습니다. 테마는 --immersive: 0-3으로 이를 전달할 수 있습니다. 16개의 ui-craft 방향 각각은 기본값을 설정합니다 (references/theme-bridge.md 참조).
| 수준 | 설명 | 적합한 경우 | 적합하지 않은 경우 |
|---|---|---|---|
| 0 정적 | 3D, 셰이더 또는 스크롤 효과 없음. 일반적인 인터페이스 모션만 | 금융 도구, 관리, 정부, 건강 양식, 복잡한 대시보드, 하루 종일 사용하는 모든 것 | - |
| 1 악센트 | 하나의 조용한 생동감 있는 디테일: 재질, 느린 셰이더 텍스처, 뷰 전환. 몇 초 후에 멈춤. 스크롤 기반 장면 없음 | SaaS 앱, 문서, 대부분의 제품 UI, 데스크톱 및 모바일 앱 | 사람들이 불안해하거나 서두르는 작업 |
| 2 시그니처 | 하나의 히어로 모먼트: 포인터나 첫 번째 스크롤에 반응하는 객체 또는 셰이더. 그 후 일반 페이지 | 랜딩 페이지, 제품 페이지, 포트폴리오, 온보딩, 런치 스크린 | 사람들이 매일 다시 방문하는 페이지 |
| 3 스토리 | 하나의 지속적인 장면과 함께 3-5개의 비트로 구성된 스크롤 기반 시퀀스 | 런칭, 캠페인, 에디토리얼 기능, 박물관 및 브랜드 스토리 | 앱, 체크아웃, 작업이 있는 모든 것 |
사다리의 규칙: 수준은 목표가 아닌 상한선입니다. 빈도가 낮춥니다: 사람이 화면을 더 자주 볼수록 수준은 낮아집니다. 작업이 낮춥니다: 누군가가 지불, 서명 또는 문제를 해결하는 곳에서는 레벨 0을 사용하십시오. 확실하지 않을 때는 한 단계 낮추고 더 잘 완성하십시오.
4. 예산
작업 목표. 측정하십시오; 추측하지 마십시오. *표시된 숫자는 게시된 제한이 아닌 합리적인 기본값입니다.
| 항목 | 휴대폰 | 데스크톱 |
|---|---|---|
| Largest Contentful Paint (텍스트 또는 포스터여야 하며 캔버스가 아님) | 2.5초 이하 | 2.5초 이하 |
| 첫 페인트 전에 요청된 스크립트 | 압축 시 170 KB 미만 | 동일 |
| 엔진 (three.js 약 180 KB gzip) | 첫 페인트 후, 동적 import(), 장면이 뷰포트 근처에 있을 때만 | 동일 |
| 첫 장면 페이로드: 엔진 + 모델 + 텍스처 * | 1.5 MB 미만 | 4 MB 미만 |
| 히어로 모델 (GLB, 압축) * | 2 MB 미만, 20-60k 삼각형 | 5 MB 미만, 최대 100k |
| 텍스처 | 1024px; 히어로에만 2048; GPU 메모리용 KTX2 | 2048; 클로즈업에만 4096 |
| 픽셀 비율 | 1.5 제한, 느리면 1로 낮춤 | 2 제한 |
| 프레임당 드로우 콜 * | 100 미만 | 300 미만 |
| 실시간 조명 | 1 키 (+ 환경); 1024의 그림자 맵 1개 또는 베이크드/블롭 섀도우 | 1-3; 그림자 맵 최대 2048 |
| 후처리 패스 | 0-1 | 1-3 |
| 프레임 시간 | 60fps 안정; 30 미만으로 떨어지기 전에 품질 낮춤 | 60fps |
| 스크롤 스토리 | 3-5 비트, 각 100-150vh, 고정 실행 5화면 미만 *, 스킵 링크 | 동일 |
| 프리로더 | 없음; 페이지는 1-2초 내에 읽을 수 있고 장면은 준비되면 페이드 인 | 동일 |
2048px 텍스처는 파일 크기와 관계없이 압축 해제 시 약 22MB의 비디오 메모리를 소비합니다 (KTX2가 아닌 경우). 세부 사항 및 단계별 낮춤 순서: references/performance.md.
5. 하나의 테마가 모든 레이어를 제어합니다
- 토큰에서 색상을 읽으십시오 (
--bg,--surface,--accent,--accent-soft,--text,--border...), 셰이더나 재질에 헥스 코드를 하드코딩하지 마십시오.assets/theme-bridge.js의readTheme()는 조명 계산용 선형 RGB와 평면 그리기용 sRGB로 각각 반환하고,watchTheme()는 라이트/다크 전환 시 다시 읽습니다. - 장면은 페이지 배경 위에 있습니다: 투명 캔버스 또는
--bg와 동일한 투명 색상. 보이는 사각형이나 두 번째 배경색이 없습니다. - 악센트는 3D에서도 드물게 유지됩니다: 하나의 객체, 하나의 조명, 하나의 선. 대부분 중성입니다.
- 테마의 형태가 전달됩니다: 코너 반경은 베벨과 가장자리 반경이 되고; 깊이 스타일은 그림자 스타일이 됩니다 (헤어라인: 얇은 외곽선, 거의 그림자 없음; 소프트: 넓고 부드러운 접촉 그림자; 크리스프: 더 타이트하고 광택; 립: 하드 오프셋 에지; 플랫: 없음).
- 모션 토큰이 템포를 설정합니다:
--dur-*와--ease-out은 카메라 이동과 스크롤 이징(브리지의bezier())을 형성하여 "즉각적인" 도구와 "느린" 고급스러운 하우스가 동일한 코드로 다르게 움직입니다. 테마의 곡선이 오버슈트하는 경우에만 바운스합니다. - 타입은
--font-display및--font-sans의 HTML로 유지되며 캔버스 위나 옆에 배치됩니다.
6. 간략한 제작 기술
장면 및 카메라 (references/scene-camera.md)
- 하나의 주제, 하나의 명확한 실루엣, 많은 조용한 공간. 먼저 휴대폰의 세로 프레임에 맞게 구성하십시오.
- 긴 렌즈(시야각 20-35도)는 객체를 돋보이게 합니다. 광각은 왜곡시킵니다. 카메라는 천천히 그리고 이유가 있을 때만 움직이거나 전혀 움직이지 않습니다.
- 필요할 때만 렌더링하십시오. 변경되지 않는 장면은 아무것도 그리지 않습니다.
조명 및 재질 (references/materials-lighting.md)
- 위에서 하나의 키 라이트(UI와 동일한 단일 광원), 부드러운 필 라이트, 주제를 배경에서 분리하는 림 라이트. 조명은 절대 순수한 흰색이 아닙니다. 그림자는 절대 순수한 검정색이 아닙니다.
- 주제를 바닥에 고정시키십시오: 부드러운 접촉 그림자, 그렇지 않으면 떠 있습니다.
- 무엇이든 판단하기 전에 색 공간을 설정하십시오. 너무 어둡거나 흐릿한 것은 조명 문제가 아니라 색 공간 문제입니다.
- 장면이 정적일 때 텍스처에 빛을 베이크하십시오. 가장 저렴한 조명입니다.
셰이더 (references/shaders.md)
- 셰이더는 역할이 있는 재질, 조명 또는 텍스처입니다. 배경 화면이 아닙니다.
- 2-4개의 테마 색상으로 구성된 팔레트, OKLab에서 혼합하여 중간이 깨끗하게 유지되도록 합니다. 무지개는 없습니다.
- 부드러운 그라데이션의 밴딩을 숨기기 위해 2-4%의 그레인을 추가하십시오. 휴대폰에서 프래그먼트 작업을 저렴하게 유지하십시오: 적은 텍스처 읽기, 긴 루프 없음.
스크롤 스토리텔링 (references/scroll-storytelling.md)
- 각 비트는 실제 텍스트 한 줄이 있는 하나의 아이디어입니다. 비트에 할 말이 없으면 삭제하십시오.
- 텍스트는 정상적으로 스크롤됩니다. 장면은 고정되어(sticky) 함께 변경됩니다. 시간이 아닌 위치를 스크러빙합니다.
- 동작 감소는 영화를 슬라이드로 바꿉니다: 비트당 하나의 정지 프레임.
시네마틱 모션 (references/cinematic-motion.md)
- 아이디어 간에는 컷 또는 디졸브, 하나의 아이디어 내에서는 이동. 중요한 것에 머무르십시오. 이징은 연기입니다: 무게, 장식이 아닙니다.
- 인터페이스 모션은 ui-craft의 타이밍(100-300ms)을 유지합니다. 장면 및 카메라 이동은 600-1200ms가 소요됩니다. 페이지 전환은 200-500ms이며 URL, 뒤로 가기 버튼 및 포커스는 계속 작동합니다.
Blender에서 브라우저로 (references/blender-pipeline.md)
- Principled BSDF만 사용하고 나머지는 베이크하고 GLB로 내보낸 다음 압축하십시오:
gltf-transform optimize, meshopt 또는 Draco, KTX2 텍스처. 파일을 검사하십시오...