Skip to main content

FAQ

Core Concepts​

What does Preview and Streamable mean?

When you upload an asset, Miris first generates a Preview — a lower-fidelity visual representation ready in about 5–10 minutes. Previews let you check lighting, color, and overall appearance before committing a generation credit.

Once you're happy with the preview, you can generate a Streamable Asset — the high-fidelity, streaming-optimized version that works in the Miris player and WebSDK.

What file formats does Miris support?

OpenUSD (Universal Scene Description). If you're exporting from Blender, Maya, Houdini, or other DCCs you can export to OpenUSD. We provide export guides and sample scenes to help you export the highest-fidelity content.

How long does processing take?

Between 30 minutes and 6 hours, depending on asset complexity. Processing is asynchronous so you don't need to keep the browser open — you'll receive an email notification when your asset is ready. Previews are much faster, typically 5–10 minutes.

What happens to my source files?

Your original source files are retained securely. Miris processes them into a proprietary streaming-optimized format, but the originals are not modified or deleted. You always maintain ownership of your content.

Streaming & Viewing​

How do I start streaming?

The primary way to stream is with the Miris WebSDK. Install the SDK, create a viewer key in the portal, and drop a component into your React, Vue, or JS app. The SDK integrates directly with three.js as its runtime.

What is player.miris.com? How does it relate to the WebSDK?

player.miris.com is Miris's hosted viewer — a ready-made way to view and share your streamable assets via a direct link with no code required.

The WebSDK is for developers who want to embed Miris streaming into their own applications with full control over the scene, camera, lighting, and interaction.

Both use the same underlying streaming technology. The player is a viewing and quick-share tool; the SDK is the build-it-yourself tool.

Does the viewer work on mobile?

Yes. The Miris viewer adapts to any device — desktop, tablet, mobile, and XR headsets. Quality adjusts automatically.

Is there a way to change quality?

There is no manual quality setting. Miris handles 3D streaming quality automatically based on platform, network conditions, and device specifications to provide the best possible experience for each viewer.

Troubleshooting​

Why does my asset look so dark?

If you are using an HDRI as your primary light source, refer to our HDRI lighting guide for setting the correct light intensity in Blender.

If your scene does not have a light source, the Miris service will automatically set up a default Image-Based Light for you.

What happens if I don't put any lights in my scene?

If your scene does not have a light source, the Miris service will automatically set up a default Image-Based Light for you.

Why can't I see my asset in my three.js application?

A few common causes:

  • Light intensity. Miris adds a default light, but if you've configured your own lighting with very low intensity values, the asset may appear invisible or nearly black. See our HDRI lighting guide for recommended intensity settings.
  • Camera and asset overlap at the origin. Miris assets load at the origin (0, 0, 0). If your camera is also at the origin, you'll be inside the asset and see nothing. Move your camera back (e.g. camera.position.set(0, 1, 5)) or reposition the asset using <mirisAsset>.position.set(x, y, z).
  • Viewer key issues. Make sure your viewer key is valid and correctly configured in the SDK initialization. See viewer key management.

Beta & Credits​

What are the beta limits?

During public beta:

  • Unlimited uploads
  • 5 high-fidelity processing credits per month
  • 1,000 stream views per account before watermarking
  • 10 GB maximum file size per asset
What if I run out of credits?

During public beta, you receive 5 high-fidelity generation credits per month. If you've used all your credits, you can still upload assets and generate Previews — you just won't be able to create new Streamable Assets until credits renew at the beginning of the month.

If you need additional credits, reach out to us at support@miris.com.

Is there a way to turn off watermarking?

During beta, streams are watermarked after 1,000 views per account. There is currently no way to remove the watermark within the beta plan.

Watermark-free streaming will be available on paid tiers after beta. If your use case requires earlier access to unwatermarked streams, contact us to discuss options.