MRE v0.13.0 - Mesh assets and automatic colliders

This is a breaking change! Clients running 0.12 or earlier (e.g. AltspaceVR before 3.2.23) will not connect to MREs using this SDK version.

New Features

• Manage meshes independent from actors. Use methods like AssetContainer.createSphereMesh and AssetContainer.loadGltf to generate new mesh assets, and assign them to actors via the new meshId appearance property: actor.appearance.mesh = mesh.
  • As a result, Actor.CreateFromGltf and Actor.CreatePrimitive now take as their first argument an AssetContainer instead of a Context. The primitive mesh and glTF assets will be added to the given container. Their implementation has changed under the hood to use prefabs and meshes, but the high-level behavior should be the same.
  • Both of these load new assets. If you want to use the same mesh for multiple actors (recommended), create the mesh explicitly and use Actor.Create.
• Create colliders that match the mesh easily by setting your actor's collider shape to auto: { collider: { geometry: { shape: 'auto' } } } or actor.setCollider('auto').
• Added a capsule collider shape.
• Actor.CreateEmpty has been renamed simply Actor.Create. The old name is still available for now but deprecated.

MRE v0.12.4

Bug Fixes

• Git no longer has to be installed to npm install (#420)
• Asset patches returned from load calls are now merged back into the asset (#418, #421)

MRE v0.12.2

Bug Fixes

• Grab synchronization (#416)
• User IP address on Azure hosting (#417)

Regressions

• NPM package installation will fail unless Git is installed (fixed in 0.12.4)

MRE v0.12.1 - New Video Player, Asset Unloading, Fewer Promises

This is a breaking change! Clients running 0.11 or earlier (e.g. AltspaceVR before 3.2.13) will not connect to MREs using this SDK version.

New Features

• Reorganized the Asset system so it doesn't go through a single AssetManager property on the context anymore. Instead, create a new AssetContainer instance and use its create/load functions. These containers can also now be unloaded, freeing up client memory. (#384)
• Video players are now treated just like sound clips, going through the asset system and played from actors. The altspacevr-extras video player will continue to work. (#372)

Bug Fixes

• Fix late-joining sync of active sounds and videos. (#388)
• Fix race condition with actor state updates during loading (#386)
• Add video player volume control (#253)

Code Cleanup

• Actor/asset creation calls no longer return a promise. Instead, they immediately return the actor/asset they were creating. That actor/asset has a created promise property that resolves when the client confirms successful creation. (#381, #384)

MRE v0.11.2 - Welcome back!

This is the first stable release since the MRE team's two-month hiatus, and we're excited to get it to you!

This is a breaking change! MRE client versions older than 0.11 will no longer function.

New Features

• Collision and trigger events for colliders (#313)
• User-exclusive actors (#314)
• New simpler event model for ButtonBehaviors (#319)
• Add an isKinematic property to rigid bodies (#346)
• Lerp transform updates when an actor is grabbed (#350)

Bug Fixes

• Fix NPM-identified vulnerabilities (#302 #347)
• Fix glTF-created actor synchronization (#304)
• Fix asset update synchronization (#354 #359)
• Maintain app/local transform synchronization (#361)
• Fix "freeze" when actors fail to create (#378)
• Change message timeout infrastructure so long loads don't stall the app (#379)

Documentation

• Update deployment instructions to set ngrok baseUrl (#356)
• Add VSCode Azure deployment steps (#353)

Code Cleanup

• Change the way subscriptions get sent to clients (#333)
• Change indentation from spaces to tabs (#368)
• Add Dockerfile to spin up functional tests (#365)

MRE v0.10.1 - Grabbable flag and app-space transforms

New Features

• Grabbable actors - Actors marked as grabbable (and with a collider) can be manipulated naturally (with 6DOF controllers only for now)
• App-space transforms - Actor transforms have been split into local and application space (relative to application). Previously, transforms were local-only (relative to parent). This is a breaking change.

MRE v0.9.3 - User Masking

New Features

• Added "user masking": a new concept where users and actors can be assigned zero or more "groups", and an actor will only be visible to a user if they have at least one group in common with the actor. See the user masking functional test for an example.

MRE v0.8.0 - Stability, performance, Visibility flag

New Features

Visibility flag

Internal Changes and fixes

New synchronization method makes joining much faster
Fix possible perf issues if using MRE sound API

MRE v0.7.3 - Attachments, Audio, Colliders, new functional test menu

New Features

Added Avatar attachments API
Added Sound API
Added Set collider API
Added user properties to show host APIs
Support material alpha blending and cutout

Internal Changes and fixes

LookAtComponent is now synchronized properly
Cleaned up functional test framework
Improved synchronization for rigid bodies
Numerous networking fixes, improved stability, and minor API changes

MRE v0.6.3 - Asset APIs, sync fixes, more functional tests

New features

AssetManager.createMaterial, createTexture, ready (#172)
Add support for texture manipulation on material assets (#164)
Generate UVs for planes and inner spheres (microsoft/mixed-reality-extension-unity#23)

Internal Changes and fixes

Start the app context after the app is instantiated. (#163)
Fix animation sync (#180)
Improvements to client join process (#155)
Remove position and rotation fields from rigid body.
Remove BufferedEventEmitter (#156)
New version compatibility scheme (#157)
Big cleanup of message handling in the multi-peer adapter (#147)
Fix reparenting (microsoft/mixed-reality-extension-unity#20)

Functional Tests

Add light-test, and related changes (#173)
Add reparenting functional test (#165)
Simplify interpolation-test (#159)
Sort the functional test menu.
display on-screen error if functional test fails/throws exception. (#151)