Communitygithub.com

モバイルファースト3D

ヘビーな3D/WebGLサイト向けの専用スマホ・タブレット体験 — デバイスプロファイル検出、軽量レンダリング設定とテクスチャセット、被写体(環のある惑星や銀河など)がクリップされない縦向きカメラフレーミング、ボトムシート、メニューシート、セーフエリア、タッチ動作、短いスクロールを提供します。3Dサイト構築時や「モバイルで切れてる/きれいに見えない/重い/見苦しい」と言われたときに常に使用してください。

モバイルファースト3D とは?

このスキルは、3D/WebGLサイトをモバイルデバイス向けに最適化するための包括的なガイドラインを提供します。従来の「デスクトップを小さくしただけ」のアプローチではなく、専用のプロファイルを構築し、`html.mobile` という単一のクラスで切り替えることを基本とします。具体的には、タッチ操作や画面サイズに基づくデバイス検出、画質とパフォーマンスのバランスを取ったレンダリング設定(DPR制限、テクスチャセットの軽量化など)、縦向きでの被写体クリッピングを防ぐカメラフレーミング(視野角計算、被写体距離調整、フレーム内配置)、ボトムシートやフルスクリーンメニューといったモバイルUIの標準パターン、セーフエリアへの対応、そして慣性スクロールに合わせた短いページ構成をカバーします。また、デスクトップのエミュレーションだけでは不十分であり、実機テストを推奨する姿勢も示しています。このスキールは主にClaude CodeやCursorなどのAIエージェントがコード生成やアドバイスを行う際の知識ベースとして利用されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/mobile-first-3d

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

モバイルファースト3D は何をしますか?

スマートフォンは小さなデスクトップではありません。1つのクラス html.mobile で切り替わる別個のプロファイルを構築してください。

1. 検出

const MOBILE = qs.get('m') === '1' || (qs.get('m') !== '0' &&
  (matchMedia('(pointer: coarse)').matches || Math.min(innerWidth, innerHeight) < 600));
document.documentElement.classList.toggle('mobile', MOBILE);

?m=1 / ?m=0 で強制指定も可能 — デスクトップのエミュレーションモードでテストするために必須です。

2. レンダリングプロファイル

設定デスクトップスマートフォン
DPR上限 / 最大ピクセル数1.5 / 3.2 MP1.25 / 1.0 MP
測地線分割数220150
ボリュームサンプル数3624
スカイベイクサイズ768 / 512384 / 256
テクスチャセットtextures/hd (~6 MB)textures/m (~1.2 MB)
マウスパララックス / 見回しオンオフ(タッチのみ。エミュレーターはマウスイベントを送信します)

3. 縦向きフレーミング(「切れてる」バグのほとんどはここから発生します)

  • 縦向きでの水平FOVは非常に小さい: tan(hFOV/2) = tan(vFOV/2)·アスペクト比 (52°でアスペクト比0.46の場合、約0.22)。
  • 各被写体からの距離 = max(R·距離倍率·1.25, 可視半径·7.6)。可視半径には環も含まれます(土星≈2.35R、天王星≈1.8R)。
  • 被写体を狙い、ビュー全体を約0.21rad下に傾けて、被写体がテキストシートより上の画面上部3分の1に配置されるようにします。(ターゲットをオフセットすると、カメラが動いたときに横にずれてしまいます。)
  • 照明はより正面寄り(約45°位相差)に:サイドから当たる半面暗い惑星は小さな画面で「クリップされている」ように見えます。
  • コンテンツ保持中は照準を固定(ターゲット接線ゼロ) — 中心からずれてドリフトしないようにします。
  • 数値で検証:フレームをレンダリングし、被写体を横切る行で readPixels を実行し、照らされた範囲が幅の5〜95%内にあることを確認します。

4. レイアウト

  • パネル → ボトムシート: left:0; right:0; bottom:0; max-height:60vh; overflow:auto、 グラデーション背景、padding-bottom: calc(54px + env(safe-area-inset-bottom))。
  • タイトル clamp(34px, 10vw, 52px);ヒーロー名は2行に分割。
  • ナビ → ハンバーガー+44pxセリフリンク付き全画面ぼかしシート。
  • 装飾的なレールを非表示に;ラベルを短く(名前のみ);ランディングのスクロールヒントが競合する場合は非表示に。
  • スクロールを短く:イントロ約320vh、ジャーニー約2600vh(スマートフォンは慣性で速くスクロールします)。
  • viewport-fit=cover、100svh のスティッキーステージ、320pxで水平オーバーフローしない。

5. テストマトリクス(エミュレーションだけでは不十分ですが、最低限の基準です)

375×812と390×844の縦向き、412×915のAndroid、768×1024のタブレット。すべてのコンテンツビートで: 被写体がシートの上に完全に表示され中央に配置されていること、テキストが読めること、ノッチやホームバーの下に何も隠れていないこと。 実機テストが行われていない場合は、その旨をユーザーに正直に伝えてください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル