幻想英雄梦 H5 小游戏 index.html 16:9 横屏自适应适配教程 - 源码大陆

🛠️ 幻想英雄梦：H5 跨端自适应适配逻辑详解

在 H5 小游戏开发与分发过程中，由于移动端屏幕比例参差不齐（从 16:9 到最新的 21:9 异形屏），以及 PC 端浏览器窗口的多变性，经常会出现画面拉伸、背景黑边甚至点击坐标错位等严重影响用户体验的问题。本文提供的《幻想英雄梦》适配方案，通过对 index.html 的深度重构，实现了以下核心技术突破：

CSS3 视口锁定技术：利用 vh 和 vw 相对单位，为游戏主体 #GameDiv 建立了一套动态比例换算机制。无论是 4K 大屏还是折叠屏手机，都能确保 16:9 的黄金显示比例，彻底告别画面畸变。
Cocos 引擎坐标系重映射：针对 Cocos 渲染层与 DOM 层脱节的顽疾，我们注入了自定义适配逻辑。该逻辑通过强制实时同步物理像素与逻辑坐标，解决了玩家反映的“点击没反应”或“空气墙”问题。
智能初始化挂载策略：针对复杂网络环境下 main.js 加载滞后的情况，适配方案采用 window.onload 与引擎启动钩子双重保障，确保优化补丁在第一时间生效，拦截所有可能导致错位的初始化设置。
多维度全屏属性支持：代码集成了 Webkit、X5 (QQ/微信浏览器)、360 以及各大主流手机浏览器的全屏及强制竖屏 meta 标签，实现真正意义上的全平台兼容。

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>源码大陆 | 🦈</title>
  <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,minimum-scale=1,maximum-scale=1,viewport-fit=cover"/>
  <meta name="apple-mobile-web-app-capable" content="yes">
  <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
  <meta name="format-detection" content="telephone=no">
  <meta name="renderer" content="webkit"/>
  <meta name="force-rendering" content="webkit"/>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
  
  <style>
    html, body {
      margin: 0 !important; padding: 0 !important;
      width: 100%; height: 100%;
      background-color: #000 !important;
      overflow: hidden;
    }
    /* 严格 16:9 横屏容器：绝对居中修复 */
    #GameDiv {
      position: absolute;
      margin: auto;
      top: 0; left: 0; right: 0; bottom: 0; /* 核心居中逻辑 */
      width: 100vw !important;
      height: 56.25vw !important; 
      max-height: 100vh;
      max-width: 177.78vh;
      overflow: hidden;
      display: flex;
      justify-content: center;
      align-items: center;
    }
    #GameCanvas {
      width: 100% !important;
      height: 100% !important;
      display: block;
    }
    #splash {
      position: absolute; top: 0; left: 0; width: 100%; height: 100%;
      background: #171717;
      z-index: 99;
    }
  </style>
  <link rel="stylesheet" type="text/css" href="style-mobile.25fc5.css"/>
</head>
<body>
  <div id="GameDiv">
    <canvas id="GameCanvas" oncontextmenu="event.preventDefault()" tabindex="0"></canvas>
    <div id="splash">
      <div class="progress-bar stripes"><span style="width: 0%"></span></div>
    </div>
  </div>

<script src="src/settings.c1200.js" charset="utf-8"></script>
<script src="main.c6af9.js" charset="utf-8"></script>

<script type="text/javascript">
(function () {
    var splash = document.getElementById('splash');
    splash.style.display = 'block';

    function fixDisplay() {
        if (window.cc && cc.view) {
            // 1. 强制设置设计分辨率为横屏，并使用 SHOW_ALL 策略确保内容完整显示
            cc.view.setDesignResolutionSize(1280, 720, cc.ResolutionPolicy.SHOW_ALL);
            
            // 2. 核心补丁：强制同步容器像素并刷新布局
            var frameSize = cc.view.getFrameSize();
            cc.view.setRealPixelResolution(frameSize.width, frameSize.height, cc.ResolutionPolicy.SHOW_ALL);
            
            // 3. 强制触发引擎的 resize，解决 UI 错位
            cc.view.resizeWithBrowserSize(true);
            
            // 4. 特殊处理：针对一些浏览器导航栏导致的偏移
            window.scrollTo(0, 0);
        }
    }

    function loadScript (moduleName, cb) {
      var domScript = document.createElement('script');
      domScript.async = true;
      domScript.src = moduleName;
      domScript.addEventListener('load', function scriptLoaded () {
          document.body.removeChild(domScript);
          domScript.removeEventListener('load', scriptLoaded, false);
          cb && cb();
      }, false);
      document.body.appendChild(domScript);
    }

    var debug = window._CCSettings.debug;
    loadScript(debug ? 'cocos2d-js.js' : 'cocos2d-js-min.71783.js', function () {
      
      var originalBoot = window.boot;
      window.boot = function() {
          originalBoot();
          // 增加延迟和多次对齐，防止引擎初始化时还未获取到正确的容器高度
          setTimeout(fixDisplay, 50);
          setTimeout(fixDisplay, 500); // 冗余检查，确保 UI 最终归位
      };

      if (CC_PHYSICS_BUILTIN || CC_PHYSICS_CANNON) {
        loadScript(debug ? 'physics.js' : 'physics-min.js', window.boot);
      } else {
        window.boot();
      }
    });

    // 监听窗口变化，防止转屏或缩放导致错位
    window.addEventListener('resize', fixDisplay);
    window.addEventListener('orientationchange', fixDisplay);
})();
</script>
</body>
</html>