What is Early Access?
Early access allows us to share upcoming, sometimes experimental features, for developers to try prior to general availability.
Early Access Features
Current SDK applications do not support Views. This early access period is focused on re-enabling Views.
How To / Migration Guides
Handling View Changes
When changing Views, additional assets associated with a space (Tags, Labels, etc) will change.
The data provided through any of the SDK’s
data collections, or
getData functions only report the runtime set of data, i.e. the set of objects currently visible in the space. Showcase does not load data nor keep data in memory for objects that are in other Views than the currently active one.
For example, a Tag with an id of “foo” will not necessarily continue to exist in
Tag.data if the View is changed.
Make sure to be reactive to data changes. If not already using them, see Using Collections.
To know when the View has changed, subscribe to the View.current state.
To opt-out of Views entirely, add a
sdkviews=0 URL parameter or attribute.
<matterport-viewer m="..." application-key="..." sdkviews="0" />
Known Issues and Limitations
- There are no operations to add new Views or Layers through the SDK
- There is no way to change the current View or active Layers through the SDK
- There is no way to add or edit objects only within a specific View
Until we build proper support for Views, all transient edits will be re-applied as a new View is selected. For example, after adding a Tag with an id “bar”, when the current View changes, the Tag will be removed as the View is unloaded but then recreated when the new View’s data is loaded. The id of the Tag will be preserved (“bar”) to make it easy to continue operating on it if needed.