モバイルファースト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 MP | 1.25 / 1.0 MP |
| 測地線分割数 | 220 | 150 |
| ボリュームサンプル数 | 36 | 24 |
| スカイベイクサイズ | 768 / 512 | 384 / 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のタブレット。すべてのコンテンツビートで: 被写体がシートの上に完全に表示され中央に配置されていること、テキストが読めること、ノッチやホームバーの下に何も隠れていないこと。 実機テストが行われていない場合は、その旨をユーザーに正直に伝えてください。