你做好了 VR 作品,怎么让头显打开它、并且确认它真的进了 VR? 这一页把三件事讲完:怎么起服务 → 怎么让头显连上 → 怎么判断是环境问题还是你的代码问题。
navigator.xr。
https://、http://localhost、http://127.0.0.1 算安全上下文;
你电脑的局域网 IP(http://192.168.x.x)不算。
所以用局域网 IP 打开自己的页面时,看不到"进入 VR"按钮、控制台里 navigator.xr 是 undefined——
那不是你的代码写错了,是环境不满足。先按下面 A 或 C 把它变成安全上下文,再 debug。
本目录下的 serve.bat /
serve.ps1 是一个
零依赖的静态服务器(只用 Windows 自带的 PowerShell,不需要 Python、不需要 Node、不需要管理员)。
serve.bat 和 serve.ps1 下到你自己的电脑上(右键 → 另存为,或找老师要);serve.bat。窗口里会打印两个地址,这个窗口不要关。============================================================
VR 作品 · 本机服务器已启动
------------------------------------------------------------
根目录 : D:\我的VR作品
端口 : 8080
头显里打开(USB 转发 / 安全上下文):
http://127.0.0.1:8080/
头显里打开(同一 Wi-Fi,需先在头显浏览器加白名单):
http://192.168.x.x:8080/
============================================================
想换目录或端口:serve.bat "D:\我的VR作品" 8081
(也可以直接建个快捷方式,省得每次敲)。
| 通路 | 怎么做 | 什么时候用 |
|---|---|---|
| A · USB 直连 安全上下文 ✅ |
1)数据线连头显,头显里点「允许 USB 调试」(需先开开发者模式); 2)电脑另开一个窗口执行: adb reverse tcp:8080 tcp:80803)头显浏览器打开 http://127.0.0.1:8080/。头显里的 127.0.0.1 会被转到你的电脑上,所以既是安全上下文、又完全不走网络。 |
课堂、教室网络差、要最稳的效果 |
| B · 交到课程站点 安全上下文 ✅ |
把作品文件夹交给老师,放到课程站点的 /assets/vr-2026/student/<学号>/,
头显直接打开 https://站点/.../student/学号/。 |
要交作业、要让同学和老师都能看 |
| C · 局域网 + 白名单 要一次配置 |
1)头显与电脑连同一个 Wi-Fi; 2)头显浏览器打开 chrome://flags/#unsafely-treat-insecure-origin-as-secure;3)把 http://你的电脑IP:8080 填进去,设为 Enabled,重启浏览器;4)再打开 http://你的电脑IP:8080/。电脑 IP 一变就要重填。 |
自己反复调试、不想插线 |
这是最容易浪费时间的一步。规矩很简单:先用一个你确定没问题的页面确认环境,再回头改自己的代码。
../check/index.html)navigator.xr /
immersive-vr / WebGL / 输入设备 / 能不能真的进 VR;vr-probe.js)在你的页面里加一行就够:
<script src="vr-probe.js"></script>
页面右上角会出现一个小面板,实时显示:四项 WebXR 前提、FPS、DrawCall、三角面、 以及你页面里所有的 JS 报错。改完代码刷新就能看到变化,不用再猜。
immersive-vr 支持 ✅;