meta/immersive-web-sdk

最近记录的来源活动: 2026年10月22日 23:59

SkillsMP 收录数据更新: 2026年11月9日 14:22

已收集 skills: 28

GitHub 星标: 349
GitHub Forks: 72

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/meta/immersive-web-sdk.

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

<h1 align="center">Immersive Web SDK</h1> <p align="center"> <a href="https://www.npmjs.com/package/@iwsdk/core"><img src="https://badgen.net/npm/v/@iwsdk/core/?icon=npm&color=orange" alt="npm version" /></a> <a href="https://www.npmjs.com/package/@iwsdk/core"><img src="https://badgen.net/npm/dt/@iwsdk/core" alt="npm download" /></a> <a href="https://www.typescriptlang.org/"><img src="https://badgen.net/badge/icon/typescript/?icon=typescript&label=lang" alt="language" /></a> <a href="https://raw.githubusercontent.com/facebook/immersive-web-sdk/main/LICENSE"><img src="https://badgen.net/github/license/facebook/immersive-web-sdk/" alt="license" /></a> </p> <p align="center"><strong>Where every webpage can become a world.</strong></p> The **Immersive Web SDK** makes building immersive web experiences as approachable as traditional web development. It's a complete collection of frameworks and tools built on **Three.js** with a high-performance **Entity Component System**, **developer-first workflow** with one-command setup and built-in emulation, and **production-ready systems** for grab interactions, locomotion, spatial audio, physics, and scene understanding. **Same code, two experiences**: Run immersively in VR/AR headsets and automatically provide mouse-and-keyboard emulation on desktop browsers. No browser extensions, no special setup—anyone with a laptop can develop for the immersive web. ## Getting Started Create a new project with a single command: ```bash npm create @iwsdk@latest ``` Or install into an existing project: ```bash npm install @iwsdk/core three@npm:super-three@0.185.0 ``` Keep the exact `three` alias at the application root and override transitive resolutions so the app and IWSDK share one runtime. npm reads the override from `package.json`: ```json { "dependencies": { "@iwsdk/core": "^1.0.0", "three": "npm:super-three@0.185.0" }, "overrides": { "three": "npm:super-three@0.185.0" } } ``` pnpm 10 and 11 read root overrides from `pnpm-workspace.yaml`: ```yaml packages: - '.' overrides: three: npm:super-three@0.185.0 ``` ## Documentation For guides, concepts, and API reference, visit: **[https://iwsdk.dev](https://iwsdk.dev)** ## Packages | Package | Description | | ---------------------------------------------------- | ------------------------------------------------- | | [@iwsdk/core](./packages/core) | Core SDK with ECS, systems, and WebXR integration | | [@iwsdk/create](./packages/create) | CLI for scaffolding new projects | | [@iwsdk/locomotor](./packages/locomotor) | Locomotion engine for Three.js WebXR | | [@iwsdk/xr-input](./packages/xr-input) | WebXR input system for Three.js | | [@iwsdk/vite-plugin-dev](./packages/vite-plugin-dev) | XR emulation, AI agent tooling, and dev browser | ## Development ```bash # Use the pinned Node major, install dependencies, and build runtime/tooling packages nvm use corepack pnpm@10.18.3 run bootstrap # Build every workspace package, including the generated reference corpus corepack pnpm@10.18.3 run build:all # Build all packages as tgz files (for examples to consume) npm run build:tgz # Type-check every example as a fresh consumer of locally built tgz packages corepack pnpm@10.18.3 run typecheck:examples # Run an example (fresh install from local tgz packages) cd examples/locomotion && npm run fresh:dev # Lint and format corepack pnpm@10.18.3 run lint corepack pnpm@10.18.3 run format # Build a specific package corepack pnpm@10.18.3 --filter @iwsdk/core build ``` `bootstrap` is also the repair command for a partial or stale source build. It uses the lockfile, builds runtime and tooling packages in dependency order, and generates WebXR input profiles from the pinned npm asset package instead of making a separate CDN request. It deliberately leaves out the producer-only `@iwsdk/reference-assets` package. `build:all` includes that package by running its full ingest pipeline, which downloads the pinned embedding model on a fresh machine. Run `corepack pnpm@10.18.3 run doctor` for environment, proxy, and generated-output checks. For a network-restricted checkout whose pnpm store is already warm, use `corepack pnpm@10.18.3 run bootstrap:offline`. Initial dependency installation still needs registry access (and honors standard npm/pnpm proxy configuration), but subsequent profile generation and builds are offline-safe. A directory-linked `@iwsdk/cli` now keeps a stable launcher; if its `dist` is missing, it prints the exact package build command instead of leaving a broken executable link. ### Development Workflow The examples use `file:` dependencies pointing to `.tgz` files built from local packages. This simulates how end-users will consume the packages from npm. 1. **`npm run build:tgz`** - Builds all packages in dependency order and creates `.tgz` archives 2. **`npm run fresh:dev`** (in example) - Cleans `node_modules`, reinstalls from tgz files, and starts dev server This ensures examples always test against the latest local build. `typecheck:examples` applies the same boundary to every TypeScript example: it rebuilds development tarballs, removes each example's ignored install state, installs from those tarballs, and invokes that example's local TypeScript binary. ## License IWSDK is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details. ## Contributing Contributions are welcome! Please review our [Contributing Guidelines](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) before submitting issues or pull requests. ## Developer Terms - [Open Source Terms of Use](https://opensource.fb.com/legal/terms) - [Open Source Privacy Policy](https://opensource.fb.com/legal/privacy)

正在加载仓库 README…

这个仓库中的 skills

职业分类待补全

skill

职业分类

描述

更新

iwsdk-glasses-test

未分类

Test an IWSDK app for Meta VR Glasses — gaze-and-pinch input, the glasses' narrower field of view, and gaze preview on a Quest without eye tracking. Use when the user targets Meta VR Glasses, asks for gaze or eye-tracking input, or wants to check that content…

原文语言：英语

2026-10-22

iwsdk-ray

未分类

Verify ray clicks, UIKit selections, and DistanceGrabbable interactions with emulated XR controllers. Use for pointing, selecting, pressing spatial UI, or moving an object through a distance grab.

原文语言：英语

2026-10-22

iwsdk-ui

未分类

Build or modify manifest-backed IWSDK UIKitML with bounded preview, placement, and runtime verification. Use for spatial panels, browser HUDs, UIKitML layout, fonts, editor previews, and runtime element behavior.

原文语言：英语

2026-10-22

iwsdk-dev

未分类

Single entry point for IWSDK development. Invoke first for every IWSDK implementation request. Routes fresh builds to an internal planning playbook and bounded changes to an established app to an internal iteration playbook.

原文语言：英语

2026-10-22

iwsdk-compose-scene

未分类

Compose and review IWSDK scenes from existing manifest assets using scene JSON, placement, scale, contacts, prefabs, patterns, lighting, environment, cameras, and final framing. Does not author geometry or materials; create or repair an individual 3D asset…

原文语言：英语

2026-10-22

test-environment

未分类

Test environment system (authored DomeGradient and IBLGradient, component schemas) against the poke example using the iwsdk CLI.

原文语言：英语

2026-10-22

click-target

未分类

Find and click a target object in XR. Use when testing UI interactions, clicking buttons, or verifying interactable elements work correctly.

原文语言：英语

2026-10-22

test-all

未分类

Parallel test orchestrator. Runs all 9 test suites concurrently via Task sub-agents and the iwsdk CLI. Handles build, example setup, dev servers, agent launch, polling, retries, and result aggregation.

原文语言：英语

2026-10-22

test-grab

未分类

Test grab system (distance grab, one-hand grab, two-hand grab, hand pinch grab) against the grab example using the iwsdk CLI.

原文语言：英语

2026-10-22

test-interactions

未分类

Test XR interactions (ray, poke/touch, dual-mode, hand poke, audio, UI panel) against the poke example using the iwsdk CLI.

原文语言：英语

2026-10-22

xr-mode-test

未分类

Test XR session lifecycle and mode transitions. Use when verifying XR enter/exit behavior, testing mode-dependent features, or debugging session state issues.

原文语言：英语

2026-10-22

iwsdk-dev

未分类

MUST read this skill BEFORE developing VR/MR/desktop 3D applications using IWSDK (Immersive Web SDK). Covers project scaffolding, headless browser setup, CLI tools, reference system, ECS debugging, XR emulation, verification workflows, deployment, and known…

原文语言：英语

2026-10-22

iwsdk-grab

未分类

Use emulated XR controllers or hands to verify proximity grabbing for OneHandGrabbable and TwoHandsGrabbable objects. Use for pick up, move, release, or regression-test requests involving near-hand grab with the squeeze button or a hand pinch.

原文语言：英语

2026-10-22

iwsdk-ui-panel

未分类

Create, place, preview, debug, and connect manifest-backed IWSDK UIKitML assets. Use for spatial panels, browser HUDs, UIKitML layout, fonts, editor previews, or runtime element behavior.

原文语言：英语

2026-09-23

iwsdk-native-xr-test

未分类

Test an IWSDK app in a real Quest immersive session while controlling headset and controller poses through the IWSDK CLI. Use when the user asks to run, automate, or debug an app on a connected Quest rather than in desktop IWER emulation.

原文语言：英语

2026-09-23

test-ecs-core

未分类

Test ECS core functionality (system registration, components, Transform sync, pause/step/resume, system toggle, entity discovery, snapshots) against the poke example using the iwsdk CLI.

原文语言：英语

2026-09-21

test-level

未分类

Test level system (LevelRoot, LevelTag, authored environment, scene hierarchy) against the poke example using the iwsdk CLI.

原文语言：英语

2026-09-21

test-physics

未分类

Test Havok physics system (gravity, rigid bodies, static vs dynamic) against the physics example using the iwsdk CLI.

原文语言：英语

2026-09-21

iwsdk-build-model

未分类

Build or materially repair one reusable IWSDK 3D model as a glTF or deterministic parentless Three.js Object3D, including geometry, surface-relative detail, materials, semantic hierarchy, isolated inspection, and focused refinement. Does not arrange scenes,…

原文语言：英语

2026-09-21

iwsdk-pwa-packaging

未分类

Ship an IWSDK app to Meta Quest and the Horizon Store as a PWA/TWA — both immersive WebXR and 2D windowed panel modes. Use for PWA packaging, web app manifest and icons, auto-enter-XR on launch, bubblewrap APK builds, signing keystores, Digital Asset Links,…

原文语言：英语

2026-09-21

test-audio

未分类

Test audio system (AudioSource loading, playback state, stop, spatial audio) against the audio example using the iwsdk CLI.

原文语言：英语

2026-09-21

test-locomotion

未分类

Test locomotion system (slide, snap turn, teleport, jump) against the locomotion example using the iwsdk CLI.

原文语言：英语

2026-09-21

test-ui

未分类

Test UIKitML asset and ScreenSpace UI behavior against the poke example using the iwsdk CLI.

原文语言：英语

2026-09-21

iwsdk-migrate-0-5

未分类

Migrate an existing IWSDK 0.4.x application to IWSDK 0.5.0. Use when upgrading across the 0.5 boundary, replacing Meta Spatial Editor or GLXF, removing retired Vite plugins, moving UIKitML to runtime-loaded assets, adopting native scene JSON, or resolving 0.5…

原文语言：英语

2026-09-21

iwsdk-debug

未分类

Diagnose and verify real-time IWSDK behavior with bounded ECS pause, query, snapshot, step, and diff loops. Use for physics, animation, collision, interaction, or state bugs that cannot be proven from a screenshot.

原文语言：英语

2026-09-21

iwsdk-depth-occlusion

未分类

Add or repair IWSDK WebXR depth sensing and real-world occlusion in AR. Use for DepthSensingSystem, DepthOccludable, occlusion modes, or passthrough depth troubleshooting.

原文语言：英语

2026-09-21

iwsdk-physics

未分类

Add or repair IWSDK rigid-body simulation, collision shapes, forces, and physics-aware grabbing. Use for gravity, falling, collision, bouncing, kinematic motion, or physics tuning.

原文语言：英语

2026-09-21

iwsdk-hosting

未分类

Publish an IWSDK app to a public HTTPS origin so it can be installed as a PWA and packaged for the Meta Horizon Store. Use when deploying, hosting, or publishing the app, choosing a host, or when a file (web manifest, icons, .well-known/assetlinks.json) must…

原文语言：英语

2026-09-04

已展示 28 / 28 个已收集 Skill。