IWSDK Troubleshooting

• Serve the application over HTTPS.
• Confirm that the browser and device support the requested session mode.
• Check xr.sessionMode in the World.create() options.
• Start the session from a user action when the runtime requires one.

enterXRButton.addEventListener('click', () => world.launchXR());

import { SessionMode, World } from '@iwsdk/core';

const world = await World.create(document.getElementById('scene')!, {
  xr: {
    sessionMode: SessionMode.ImmersiveVR,
    features: { handTracking: true },
  },
});

const world = await World.create(container, {
  level: '/scenes/main.iwsdk.scene.json',
});

const assets = {
  menu: {
    type: AssetType.UIKitML,
    url: '/ui/menu.uikitml',
  },
} satisfies AssetManifest;

• Check the reported source line and column.
• Match element names exactly; they are case-sensitive.
• Use supported elements and properties from the selected component sets.
• Write CSS properties in kebab case.
• Resolve relative media and TTF paths from the .uikitml file’s URL.

rm -rf node_modules/.vite/deps
npm run dev

const world = await World.create(container, {
  level: '/scenes/main.iwsdk.scene.json',
});

• Add RayInteractable for ray and browser-canvas selection.
• Add PokeInteractable for fingertip touch interaction.
• Enable the grabbing feature for grab components.
• Confirm that the target mesh is visible to the pointer intersection path.

entity.addComponent(RayInteractable);
entity.object3D!.addEventListener('click', activateEntity);