Load models from CGTrader into mixed reality controls (preview)

[This article is pre-release documentation and is subject to change.]

Important

  • This is a preview feature.
  • Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.

Microsoft Power Platform offers the CGTrader connector for connecting with CGTrader, a large source of free and premium (paid) 3D content with thousands of models. Content from CGTrader can be browsed and loaded from inside a canvas app, and then used within the View in 3D and View in MR controls.

This connector acts as a proxy to the CGTrader APIs. It provides actions that allow users to make requests to the CGTrader API and retrieve model data. More information: Connectors overview

Connecting to an existing 3D content database allows you to build apps with mixed reality without having to create your own 3D models.

Request access from CGTrader

CGTrader connector links to your CGTrader account, allowing you access to 3D models available to your CGTrader account, including purchased content.

To request access, contact CGTrader for Developers. CGTrader will review your information and contact you with an OAuth 2.0 API Key in the form of a Client ID and Client Secret.

Note

Ensure you store the API key (Client ID and Client Secret) received from CGTrader in a secure location.

Create a new CGTrader connector

Follow these steps to create a new CGTrader connector after you receive your CGTrader API key.

  1. Sign in to Power Apps.

  2. Select Dataverse from the left-pane.

  3. Select Connections.

  4. Select + New connection.

  5. Search for and select CGTrader (preview).

    Screenshot of the connections search result.

  6. Enter the Client ID and Client Secret received from CGTrader.

    Screenshot of the new connection panel.

A new CGTrader connection is now listed on the Connections page.

Screenshot of the Connections page.

Add the connector to your canvas app

  1. Edit an existing canvas app, or create a blank canvas app.

  2. Select Data from the left-pane.

  3. Select Add data.

  4. Search for and select CGTrader.

    Screenshot of the Data Source panel searching for CGTrader.

  5. Select the connection that you created earlier.

    Screenshot of the Data Source panel when selecting a CGTrader connection instance

You can now bind your controls to the CGTrader connector actions, and browse and load models from CGTrader inside your app.

Tip

A connection is an instance of a connector. You can have multiple connections with different configurations. You can also create new connections from within Power Apps Studio when adding the connector by selecting + Add a connection.

Load CGTrader models directly into View in 3D or View in MR

After adding a CGTrader connection to your app, you can load models directly into your app with the following steps.

  1. Find the model you want in your app from the CGTrader website.

  2. Select the model, and then note the Model ID and the supported file types.

    The model ID listed on the CGTrader model page.

  3. Open your app in Power Apps Studio.

  4. Select and drag a View in 3D or View in MR control to the canvas screen.

    Insert the View in 3D or View in MR control into the app.

  5. Set the Source property of the control (View in 3D/View in MR) to CGTrader.GetModel(model_id, "file_type"), where model_id is the ID of your selected model, and file_type is one of the supported file types.

    The View in 3D control with a source from CGTrader.

Connector actions

The below table lists the most common actions and examples. For a complete list of all connector actions, their parameters, and return types, go to the CGTrader connector reference.

Action Description Example
GetModel Downloads a model with the given ID and file type. CGTrader.GetModel(_model_id_, _"file_type"_)
GetModelInfo Gets the info of a model with the given ID. CGTrader.GetModelInfo(_model_id_)
SearchModels Searches for models from CGTrader based on the given filters. Consider binding the items in a Gallery to this action. CGTrader.SearchModels({keywords:"_keywords_",extensions:"_file_types_"}).Models
GetCategories Gets the available category names and IDs. CGTrader.GetCategories()

See also