immersive-web は何をしますか?
最高の映画やゲームのように感じられ、普通のページのように読み込まれ、誰も取り残さない、3D、シェーダー、スクロール駆動の体験を構築する方法。
このスキルは一つのレイヤーです。 ui-craftスキル(同じプラグイン)は、通常のインターフェースデザイン(レイアウト、階層、タイポグラフィ、色、コンポーネント、フォーム、状態)を担当します。これらにはそちらを使用し、ここで繰り返さないでください。このスキルは、その上にレイヤー(シーン、ライト、マテリアル、シェーダー、カメラ、スクロール、映画的なモーション)を追加します。両方とも同じテーマトークンを読み取るため、一つのテーマがページとシーンの両方を駆動します(references/theme-bridge.md)。
正直な限界。 あなたはシーンを演出し、照明を当て、カメラを動かし、シェーダーを書き、モデルを組み込むことができます。しかし、何もないところから映画品質の3Dアートを彫刻することはできません。シンプルなジオメトリ、シェーダー、タイポグラフィ、ライトから構成するか、チームが提供するモデルを使用してください。対象を粗く描いたものでごまかしてはいけません。
1. 9つの厳格なルール
一つでも破れば、どんなに見栄えが良くても、その作業は完了したとは言えません。
- コンテンツファースト。 見出し、コピー、リンク、ボタンは実際のHTMLであり、スクリプトが実行される前に読める状態でなければなりません。シーンはその上に追加され、なくなっても損失はありません。ページの単語をキャンバスに描き込まないでください。CSSで
opacity: 0にしてスクリプトが表示するのを待つ状態にコンテンツを隠さないでください。 - すべてのエフェクトに3つの状態。 フル、動きを抑えた状態(静止フレームまたは短いフェード:
prefers-reduced-motion、およびネイティブアプリではOS設定)、GPUなし(WebGLまたはWebGPUがない、失敗した、またはコンテキストが失われた場合に表示するポスター画像またはCSS/SVGアート)。最初に2つのフォールバックを設計してください。これらは最初に読み込まれるものでもあります。フォールバックは同じ絵柄で、より静かなものです:同じ被写体を同じアングルから(シーン自体から作られたポスター)、データシーンの場合は同じデータをフラットに描画したものです。空のボックス、単純なグラデーション、「画像準備中」は失敗です。 - スピード予算を構築前に決定する(§4)。 ページのテキストが最初にペイントされ、その後エンジンが読み込まれます。スマートフォンでは、シーンのコストはコンテンツよりも小さくなければなりません。
- ページごとに一つの代表的な瞬間を設け、それを印象的にする。 一つのシーン、一つのアイデア、完全にやり遂げること。他のすべては控えめにします。あらゆる場所にエフェクトがあると、テンプレートのように見え、ユーザーを疲れさせます。抑制はエフェクトの数を制限するのであって、強さを制限するわけではありません。その一つの瞬間は、このプロダクトに属するイベントであるべきです(やかんが傾く、目が慣れるにつれて空が星で満たされるなど)、誰かが友人に説明したくなるほど大胆に演出します。スクロールするだけで回転するだけのオブジェクトは瞬間ではありません。
- 決してスクロールを奪わない。 ブラウザがスクロールします。あなたは位置を読み取るだけです。速度や方向の変更、ホイールの乗っ取り、偽のスクロールバーは禁止です。
position: stickyで固定し、短く保ち、スキップする方法を提供してください。 - テキストとシーンが同じ場所を共有してはならない。 どのスクロール位置でも、テキストは被写体の横または独自の表面上にあり、決してその上に重なってはいけません。シーン上に配置されたナビゲーションとボタンには、スリムまたはサーフェスが必要です。最初のスクロール位置だけでなく、すべてのスクロール位置のスクリーンショットを確認してください。
- キーボードとスクリーンリーダーは、すべての実際の要素に到達できる。 タブオーダーは読み取り順序に従います。装飾的なキャンバスは
aria-hidden="true"とします。意味のあるキャンバスには、その横にテキストによる代替手段が必要です。シーンをドラッグしてできることは、ボタンでもできるようにしてください。 - モーションは停止し、サウンドは待機し、何もフラッシュしない。 アンビエントモーションは5秒以内に落ち着くか、表示された一時停止コントロールが必要です。サウンドは要求されるまでオフにします。1秒間に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は稀です。
-
それを実行できる最も軽量なツールを選ぶ。
ニーズ 使用するもの コスト リビール、パララックスフリーのスクロールエフェクト、ページトランジション CSSのみ:スクロール駆動アニメーション、 position: sticky、View Transitions0 KB フラットな生きているテクスチャ、線、フィールド、2Dフィギュア Canvas 2D、SVG、または単一の三角形上の1つのフラグメントシェーダー(生のWebGL、ライブラリなし) 2-5 KB ユーザーが回せる1つの3Dモデルを表示 <model-viewer>約250 KB、遅延読み込み 実際のシーン:複数のオブジェクト、ライト、動くカメラ three.js(Reactアプリ:React Three Fiber)を動的な import()で読み込み150-180 KB gzip、遅延読み込み CSSで表現できないスクロールに紐づくタイムライン GSAP ScrollTrigger(フリー、オープンソースではありません:読み込んで、コピーしないこと)またはMotion 25-45 KB 最新のGPU機能 WebGPUを、常にWebGLパスの上位互換として、単独では使用しない - スムーズスクロールライブラリをデフォルトで追加しないでください。概要で要求された場合、動きを抑えた状態では自動的にオフになる必要があります。
-
没入型概要を作成する(ui-craftデザイン概要に追加)、コードの前に:
レベル: 2 シグネチャー(テーマは --immersive: 2) スタック: プレーンなHTML + three.js、遅延読み込み 代表的な瞬間(ターンテーブルではなくイベント):ビート3でやかんが傾き、細い流れが注ぎ出され、その線を維持する シーン: ページ背景上の光のプールの中にある1つのつや消しセラミックのやかん、左上からの柔らかいキーライト、暖かいリム テキストエリア: デスクトップでは左列のコピー、スマートフォンでは固定シーンの下、やかんがそれを横切ることは決してない カメラ: 35mm風、やや上から、決して自分から動かない テンポ: 穏やか(--dur-slow 400ms) ビート(レベル3のみ):1 やかん全体 - 2 注ぎ口、クローズアップ - 3 注ぐ - 4 テーブル上のセット 動きを抑えた状態:ビートごとに1つの静止レンダリング、クロスフェード GPUなし:同じシーン、同じアングルのポスター 予算:テキストが最初にペイント、エンジンはその後、スマートフォンでシーンは1.5 MB未満、タッチデバイスではピクセル比1.5 -
この順序で構築する。 (a) ui-craftを使用して、シーンの場所にポスターまたはCSSフォールバックを配置した、プレーンなHTMLと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を実行します。これにより、ページが5つの方法(デスクトップ、スマートフォン、動きを抑えた状態、WebGLなし、JavaScriptなし)で読み込まれ、重さ、ドローコール、ピクセル比、ネイティブスクロール、一時停止を測定し、スクリーンショットを保存します。アプリウィンドウ(Electron、Tauri、サインイン済みWebアプリ)の場合は、--appを追加してJavaScriptなしテストをスキップします。すべてのスクリーンショットを開いてください。 失敗したものを修正します。特に注意深く見るべき3つ:スクロールの中間(テキストが被写体を横切っていないか?)、スマートフォンの中間(シーンとテキストが一つの画面に収まり、空の帯がないか?)、そして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 |
| テクスチャ | 1024 px、ヒーローのみ2048 px、GPUメモリ用にKTX2 | 2048 px、クローズアップのみ4096 px |
| ピクセル比 | 上限1.5、低速時は1に低下 | 上限2 |
| フレームあたりのドローコール * | 100未満 | 300未満 |
| リアルタイムライト | 1基のキーライト(+環境)、1024のシャドウマップ1枚、またはベイク/ブラブシャドウ | 1-3基、シャドウマップは最大2048 |
| ポストプロセッシングパス | 0-1 | 1-3 |
| フレーム時間 | 60 fps安定、30を下回る前に品質を低下 | 60 fps |
| スクロールストーリー | 3-5ビート、各100-150vh、固定ランは5画面未満*、スキップリンク | 同左 |
| プリローダー | なし、ページは1-2秒で読めるようになり、シーンは準備ができたときにフェードイン | 同左 |
2048 pxのテクスチャは、ファイルサイズに関係なく、KTX2でない限り、展開されると約22 MBのビデオメモリを消費します。詳細と品質低下の順序:references/performance.md。
5. すべてのレイヤーを駆動する一つのテーマ
- トークンから色を読み取ります(
--bg、--surface、--accent、--accent-soft、--text、--border...)、シェーダーやマテリアルに16進数をハードコードしないでください。assets/theme-bridge.jsのreadTheme()は、ライティング計算用に線形RGB、フラット描画用にsRGBとしてそれぞれを返し、watchTheme()はライト/ダークの切り替え時に再読み取りします。 - シーンはページ背景の上に配置されます:透明なキャンバス、または
--bgと等しいクリアカラー。目に見える長方形、2つ目の背景色はありません。 - アクセントカラーは3Dでも稀に使用します:1つのオブジェクト、1つのライト、1つの線。ほとんどはニュートラルです。
- テーマのシェイプが引き継がれます:角の半径はベベルとエッジ半径になり、奥行きスタイルはシャドウスタイルになります(ヘアライン:細いアウトライン、ほとんど影なし;ソフト:広く柔らかいコンタクトシャドウ;クリスプ:よりタイトで光沢がある;リップ:ハードなオフセットエッジ;フラット:なし)。
- モーショントークンがテンポを設定します:
--dur-*と--ease-outがカメラ移動とスクロールイージングを形成します(ブリッジ内のbezier())、そのため「インスタント」なツールと「スロー」な高級ハウスが同じコードで異なる動きをします。バウンスは、テーマのカーブがオーバーシュートする場合のみ使用します。 - タイポグラフィはHTMLのまま
--font-displayと--font-sansで、キャンバスの上または横に配置されます。
6. クラフト、簡潔に
シーンとカメラ(references/scene-camera.md)
- 1つの被写体、1つの明確なシルエット、多くの静かなスペース。まずスマートフォンの縦長のフレームに合わせて構成します。
- 長いレンズ(画角20-35度)はオブジェクトを引き立てます。広角は歪みます。カメラはゆっくりと、そして理由があって動くか、またはまったく動きません。
- オンデマンドでレンダリングします。変化していないシーンは何も描画しません。
ライトとマテリアル(references/materials-lighting.md)
- 上部からの1つのキーライト(UIと同じ単一光源)、柔らかなフィル、被写体を背景から分離するリム。ライトは決して純白ではなく、影は決して純黒ではありません。
- 被写体を地面に設置します:柔らかなコンタクトシャドウ、さもなければ浮いて見えます。
- 何かを判断する前にカラースペースを設定してください。暗すぎる、または色あせて見えるのは、ライティングの問題ではなく、カラースペースのミスです。
- シーンが静的な場合は、ライトをテクスチャに焼き付けます。それは最もコストの低いライトです。
シェーダー(references/shaders.md)
- シェーダーは、仕事を持つマテリアル、ライト、またはテクスチャです。壁紙ではありません。
- テーマカラーから2〜4色のパレットを、OKLabで混合して中間色をクリーンに保ちます。虹色は禁止です。
- ソフトグラデーションのバンディングを隠すために2〜4%のグレインを追加します。スマートフォンではフラグメント処理を軽く保ちます(テクスチャ読み取りは少なく、長いループは避ける)。
スクロールストーリーテリング(references/scroll-storytelling.md)
- 各ビートは、実際のテキストの一行を持つ一つのアイデアです。ビートに言うべきことがなければ、削除してください。
- テキストは通常にスクロールし、シーンは(スティッキーで)静止し、それに合わせて変化します。時間ではなく位置をスクラブします。
- 動きを抑えた状態では、フィルムをスライドに変換します:ビートごとに1つの静止フレーム。
映画的なモーション(references/cinematic-motion.md)
- アイデア間はカットまたはディゾルブ、アイデア内で移動します。重要なものをホールドします。イージングは演技です:装飾ではなく、重みです。
- インターフェースモーションはui-craftのタイミング(100-300 ms)を維持します。シーンとカメラの移動は600-1200 msかかります。ページトランジションは200-500 ms、URL、戻るボタン、フォーカスは機能し続けます。
Blenderからブラウザへ(references/blender-pipeline.md)
- Principled BSDFのみを使用し、残りはベイクし、GLB形式でエクスポートし、その後圧縮します:
gltf-transform optimize、meshoptまたはDraco、KTX2テクスチャ。ファイルを
…
[翻訳のため一部省略されました]