Matterport provides an all-in-one 3D data platform that enables anyone to turn a space into an accurate and immersive digital twin which can be used for designing, building, operating, promoting, and understanding any space.

Matterport scans produce a 3D mesh and 360 panoramas, both of which can be used in the Hyperspace Metaverse Platform allowing participants to co-collaborate in the environments using avatars, audio, video, holograms and chat.

Furthermore Matterport exported environments can be enhanced with 3D and 2D content in Hyperspace to provide richer experiences.

Additionally Matterport embeds can be linked into Hyperspace Metaverse spaces and worlds as popups for more traditional interaction.

Matterport Spaces in Hyperspace

Where to find Matterport SDK Key

Where to find Matterport scene ID

Using Matterport 3D Mesh in the Hyperspace Engine

Enhancements

Branding Images

First person perspective

Embed Matterport Player as a Popup

Import 360 panorama

Matterport Spaces in Hyperspace

From Dashboard Spaces, click Create new space, toggle Advanced on, Select Matterport, and click Create Space.

Hyperspace through its Interoperable Metaverse initiative enables the use of Matterport scenes as Spaces in Hyperspace.

Hyperspace uses the Matterport player in combination with the Hyperspace engine to enhance Matterport with rich capabilities such as:

Multiuser 3D avatars
Video avatars
Chat
Whispers
Announcements
Participants list
Reporting

To use your own Matterport scene in Hyperspace follow these steps

Create new space and select the Matterport template

Launch the space

From the top toolbar select the Pencil+ icon and choose Show items list

In the Show items list

Edit the Scene configuration item
On the Metadata field click the Edit JSON button

Enter your Matterport sdk_key Matterport SDK Key (see instructions on where to find your Matterport SDK key below)
Enter the mid the Matterport Model ID of your scene (see instructions on where to find your Matterport scene ID below)
Click Save

Click the Save item button

Reload the space and the Matterport scene will appear.

Known issues

Can’t use 3D items, Mediabords or Bots from Hyperspace – to use these elements see Matterpak OBJ export for using Matterport meshes in the Hyperspace engine.
3D & video avatars do not rotate
3D & video avatars do not appear in immersive VR view mode
Avatars landing on the same 360 node will be visually overlapping

Where to find Matterport SDK Key

See the Matterport guide here Matterport SDK Key

Visit the Matterport dashboard settings

Choose Settings option from the side menu
Choose the Developer Tools tab

Note you will require Developer Tools Production Access

Scroll down to the SDK Key Management section
Click Add an SDK key
Under Domains click Add
Enter the domain app.hyperspace.mv
Enter the domain app.learnbrite.com
Click the Copy button

Where to find Matterport Model ID

Visit the Matterport dashboard https://my.matterport.com/models

All Spaces
Click the three dots action menu
Choose Share & Invite

Click Copy link

The link will be copied to your clipboard

Example

https://my.matterport.com/show/?m=7ABCDyEFGHe

The highlighted code is the mid or Matterport Model ID

Using Matterport 3D Mesh in the Hyperspace Engine

By exporting the 3D Matterport mesh and using it in the Hyperspace engine you will gain access to all the Hyperspace features. The 3D mesh is just the raw 3D mesh, when importing it it does not utilize the 360 images produced by Matterport, therefore the quality of the experience is not as realistic as using the hybrid Matterport player and Hyperspace engine as described above.

The choice needs to be made between visual quality and feature richness.

Matterport supports export of a scanned 3d mesh in OBJ format.

Take a look at the example here.

Following the blank template guide and storage guide you may use your Matterport scan as a multi participant shared experience in the metaverse.

Choose the property you’d like to export

Choose Downloads
Download the MatterPak

Save the MatterPak zip file to your computer.

Unzip the MatterPak zip file into a local folder.

Upload the unzipped folder to your Hyperspace Storage.

Once uploaded

Navigate into the folder you uploaded
Find the .obj file
Click the globe icon to copy the link to your clipboard

Create a new space using the Blank template

Enter the newly created space

Click the Pencil+ icon in the top right toolbar
Choose Add content

Paste the .obj link from Storage, the Import button will appear automatically
Click the Import button

Wait for the 3D item to load in the space.

By default Matterport scans use a different rotation. Both the rotation and scale will need to be adjusted.

Hover over the newly added 3d scan and click the settings icon.

Set the rotation to

{"x":-1.5708,"y":0,"z":0}

Set the scale to

{"x":1,"y":1,"z":1}

Set sceneryStatic to true

Set freeTeleport to true

Set receiveShadow to true

Click Save item

Note the floor level may not be as expected. After Save item, use the Show advanced transform controls to adjust.

Drag the translate controls vertically and horizontally until your avatar is in the correct position.

Click Stop editing in the top left corner.

Click and hold on the floor to free teleport anywhere you wish.

Enhance the space by adding more hotspots, sitting hotspots and 2D or 3D content.

Invite others to join you in the space.

Enhancements

Branding Images

Consider downloading one of the matterport photos for the Hyperspace splash screen background and thumbnail image in the Hyperspace Dashboard.

First person perspective

The experience can be more upclose if you use the First person camera view.

A user can change this at any time using the Goggles icon.

Third person	First person

The view mode can be set to first person by default in the space’s settings.

Embed Matterport Player as a Popup

In some scenarios you may only want to temporarily view Matterport scenes in an existing Hyperspace scene. In this way you can link 3d items or posters to launch the Matterport player as an overlay which can be interacted with and then dismissed to return to the main 3D scene.

Grab your Matterport embed code and add it to a space

https://support.matterport.com/s/article/Embed-a-Matterport-3D-Model?language=en_US