Chapter 2: Testing Your Experience

cd my-iwsdk-app  # Replace with your actual project name

npm install

npm run dev

  VITE v7.1.4  ready in 1234 ms

  ➜  Local:   https://localhost:5173/
  ➜  Network: https://192.168.1.100:5173/
  ➜  press h + enter to show help

npx iwsdk dev status

1. Put on your headset and navigate to the browser app
2. Find your computer’s IP address in the Vite dev server output (look for the “Network” URL)
   • Example output: ➜ Network: https://192.168.1.100:5173/
   • npx iwsdk dev status also reports the current runtime URL
3. Enter the development URL in your headset’s browser using the reported network host and port, for example https://192.168.1.100:5173
4. Accept the certificate warning (this is normal for local development with self-signed certificates)
5. Click “Enter XR” when the page loads

1. Connect your headset to your computer via USB cable
2. Enable developer mode on your headset (check your device’s documentation for instructions)
3. Set up port forwarding:
   • Open Chrome on your computer and navigate to chrome://inspect/#devices
   • Your headset should appear under “Remote Target”
   • Click “Port forwarding...” in Chrome DevTools
   • Add a rule to forward the port shown in the Local URL from your computer to your headset
4. Access the local server on your headset by entering the forwarded URL, for example https://localhost:5173
5. Accept the certificate warning and click “Enter XR” when the page loads

{
  "dev": {
    "emulator": {
      "device": "metaQuest3"
    }
  }
}

import { iwsdkDev } from '@iwsdk/vite-plugin-dev';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [iwsdkDev()],
});

1. Click the Play mode button (the circle-play icon) to lock the pointer. Move the mouse to look around. Press Escape to leave play mode.
2. Hold Left Shift while using W, A, S, and D to move the emulated headset through the scene. Use Left Shift + ArrowUp/ArrowDown to adjust height. These keys continue to drive their controller thumbsticks while Left Shift is held, so the default XR starter moves both the emulated headset and the player. If you need isolated headset free-flight, use the controller gear buttons to remap the thumbstick keys first.
3. Without Left Shift, W/A/S/D drive the left thumbstick. The arrow keys drive the right thumbstick.
4. In play mode, left mouse is the right-controller trigger/select and right mouse is the right-controller grip/squeeze. The starter plant’s DistanceGrabbable uses trigger/select; near-field OneHandGrabbable and TwoHandsGrabbable interactions use grip/squeeze.
5. Outside play mode, click a controller’s Trig or Grip value for a momentary press. Use the adjacent pin button to latch that value until you release it. Open the gear button to inspect or remap keyboard bindings.
6. To move the starter plant, leave play mode, latch Trig, and drag the controller’s transform handle in the scene. Use Grip instead when testing a near-field grabbable. Click the handle to switch between translation and rotation, then release the latch to drop the object.
7. Use Toggle input mode in the toolbar to switch between controllers and hands. Use Reset device transforms to return the headset and inputs to their default pose.

{
  "$schema": "./node_modules/@iwsdk/core/dist/schemas/iwsdk-project.v1.schema.json",
  "version": "iwsdk.project.v1",
  "scene": "./public/scenes/main.iwsdk.scene.json",
  "world": {
    "xr": {
      "mode": "vr",
      "features": {
        "handTracking": { "required": true },
        "gazeTracking": true
      }
    },
    "features": {
      "fieldOfViewMask": true
    }
  }
}

• Move the pointer to aim the gaze ray.
• Hold the left mouse button to pinch with the selected commit hand.
• Drag while holding the left mouse button to move that hand.
• Use the mouse wheel while pinching to move the hand in depth.
• Drag with the right mouse button to rotate the emulated headset.
• Press Space to reset the commit hand’s transform.

"features": {
  "fieldOfViewMask": true
}