使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-webxr开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
When to use this skill
ALWAYS use this skill when the user mentions:
- Entering VR/AR,
navigator.xr, reference spaces, sessionrequestAnimationFrameloop via renderer VRButton,ARButton,XRButtoncreation patterns from examples- Controller models, hand tracking meshes, estimated real-world lighting probes
IMPORTANT: webxr vs renderers vs camera
| Topic | Skill |
|---|---|
| Enable XR on renderer, sizing | threejs-renderers (basics) + threejs-webxr (session) |
| Desktop projection | threejs-camera |
Trigger phrases include:
- "WebXR", "VRButton", "ARButton", "XRControllerModelFactory", "hand tracking"
- "虚拟现实", "增强现实", "沉浸式"
How to use this skill
- HTTPS requirement and feature detection for XR availability.
- Buttons: use official button factories to create DOM entry points; handle session end.
- Renderer: call
renderer.xr.enabled = truepatterns per docs; prefersetAnimationLoopfor XR loops. - Controllers: attach models via factories; read gamepad axes/buttons carefully with fallbacks.
- Hands: opt-in hand models when runtime supports; performance implications.
- Lighting:
XREstimatedLightfor AR realism—combine with threejs-lights cautiously. - Exit: restore non-XR render loop and resize handling on session end.
See examples/workflow-xr-button.md.
Doc map (official)
| Docs section | Representative links |
|---|---|
| Renderer XR | https://threejs.org/docs/WebXRManager.html |
| Webxr addons | https://threejs.org/docs/VRButton.html |
| Webxr addons | https://threejs.org/docs/ARButton.html |
| Webxr addons | https://threejs.org/docs/XRControllerModelFactory.html |
Scope
- In scope: Documented WebXR manager + listed addons for buttons/controllers/hands/planes.
- Out of scope: Store submission, OpenXR runtime specifics, custom native layers.
Common pitfalls and best practices
- Desktop testing requires XR emulation or hardware; fail gracefully.
- Mismatched reference space causes floor offset—validate stage vs local-floor.
- Heavy post chains may not meet VR frame time—profile aggressively.
Documentation and version
WebXR entry points span Addons → Webxr and renderer `WebXRManager` in three.js docs. Browser and device capabilities vary—answers should cite the official example name and three.js version when possible.
Agent response checklist
When answering under this skill, prefer responses that:
- Link
WebXRManager,VRButton,ARButton, or controller factories as relevant. - Use
setAnimationLooppatterns with threejs-renderers for XR render loops. - Avoid duplicating desktop threejs-camera projection advice for XR eyes.
- Mention reference space choice (local-floor, etc.) at a high level with docs link.
- Flag performance interaction with threejs-postprocessing in VR.
References
- https://threejs.org/docs/WebXRManager.html
- https://threejs.org/docs/VRButton.html
- https://threejs.org/docs/ARButton.html
- https://threejs.org/docs/XRControllerModelFactory.html
Keywords
English: webxr, vr, ar, xr session, controller, hand tracking, three.js
中文: WebXR、VR、AR、VRButton、手柄、手部追踪、沉浸式、three.js