JiangNan-DT/README.md
赵豪 040ad8958f V1.4版本
1.完善了画布自适应能力,避免画布过小时显示异常问题
2.增加了main.html测试嵌入孪生index.html效果
2025-10-13 11:21:30 +08:00

2.1 KiB
Raw Permalink Blame History

JiangNan-DT WebGL 前端集成说明

概述

这是一个Unity WebGL项目的构建文件包含了Unity与前端JavaScript的通信接口。

文件结构

JiangNan-DT/
├── index.html          # 主页面文件
├── Build/              # Unity构建资源文件夹
├── TemplateData/       # 模板资源文件夹
├── StreamingAssets/    # Unity流式资源文件夹
└── README.md           # 本说明文档

Unity与前端通信

LocalPoint 方法

index.html 中已预定义了 window.LocalPoint 方法用于接收Unity发送的消息。

方法签名

window.LocalPoint = function(message) {
    // message: string - Unity传递的字符串参数
}

使用示例

当前实现包含:

  1. 控制台日志输出:所有消息都会输出到浏览器控制台
  2. 页面消息展示在页面右上角显示消息提示框3秒后自动消失

自定义业务逻辑

请根据项目需求修改 LocalPoint 方法内的业务逻辑:

window.LocalPoint = function(message) {
    console.log("Unity发送的消息:", message);

    // 示例1发送数据到服务器
    // fetch('/api/unity-message', {
    //     method: 'POST',
    //     headers: { 'Content-Type': 'application/json' },
    //     body: JSON.stringify({ message: message })
    // });

    // 示例2更新页面UI元素
    // document.getElementById('status').textContent = message;

    // 示例3触发自定义事件
    // window.dispatchEvent(new CustomEvent('unity-message', { detail: message }));
};

Unity调用时机

Unity会在以下情况调用 LocalPoint 方法:

  • 点击3D场景中或者右侧列表的定位按钮时

部署说明

  1. 确保所有文件保持相对路径关系
  2. 通过HTTP/HTTPS协议访问不支持file://协议)
  3. 服务器需要支持以下MIME类型
    • .unitywebapplication/octet-stream
    • .jsapplication/javascript
    • .wasmapplication/wasm

注意事项

  • WebGL构建不支持移动设备
  • 需要启用JavaScript