通过

将 3D 模型从 CGTrader 加载到混合现实控件中（预览版）

[本文为预发布文档，可能会发生变化。]

重要提示

这是一项预览功能。

预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前已经可用，以便客户可以抢先体验并提供反馈。

是否想要用混合现实 3D 内容生成应用而不必创建自己的 3D 模型？ 使用 CGTrader 连接器从 CGTrader 中将 3D 内容导入到您的画布应用。 CGTrader 提供了一个包含数千个免费和付费 3D 模型的库。 在您的应用内浏览并加载模型，然后将它们与 3D 对象 和 在 MR 中查看 控件配合使用。

该连接器提供无代码的替代方法来使用 CGTrader API。 使用操作，应用会向 CGTrader API 发送请求并获取模型数据。 有关详细信息，请参阅连接器概述。

先决条件

在 https://www.cgtrader.com/developers 申请一个 API 密钥（OAuth 客户端 ID 和客户端密钥）。 确保将 API 密钥存储在安全的位置。

创建 CGTrader 连接

在接收 API 密钥后，您将需要在 Power Apps 中创建 CGTrader 连接。 在此示例中，我们将在 Power Apps 主页上创建连接。 您还可以在 Power Apps Studio 中编辑应用时创建连接。

小费

连接是连接器的实例。 您可以创建多个具有不同配置的连接。

  1. 登录到 Power Apps。

  2. 在导航栏中，选择数据>连接>新建连接。

    Power Apps 数据连接窗口截图。

  3. 搜索并选择 CGTrader (预览)。

    选择 CGTrader 时 Power Apps 连接搜索结果的截图。

  4. 输入从 CGTrader 收到的客户端 ID 和客户端密码。

    CGTrader 连接器帐户窗口的屏幕截图。

CGTrader 连接现在已列在连接页面上。

向画布应用添加 CGTrader 连接

  1. 编辑或创建画布应用。

  2. 在导航栏中，选择数据>添加数据。 搜索并选择 CGTrader。

    显示 CGTrader 搜索结果的 Microsoft Power Apps Studio 数据源面板截图。

  3. 选择您之前创建的连接。

将 CGTrader 模型直接加载到“3D 对象”或“在 MR 中查看”控件中

  1. 在 CGTrader 网站上查找并选择模型。

  2. 请注意支持的文件类型和模型 ID。

    CGTrader.com 上 3D 对象的文件类型和模型 ID 的屏幕截图。

  3. 在 Power Apps Studio 中，将 3D 对象 或 在 MR 中查看 控件添加到应用屏幕中。

  4. 将控件的 Source 属性设置为 CGTrader.GetModel(model_id, "file_type")，其中 model_id 是您选择的模型的 ID，file_type 是支持的文件类型之一。

    Microsoft Power Apps Studio 中正在构建的 3D 对象控件截图，显示其源属性设置为 CGTrader 模型。

连接器操作

下表列出了最常见的 CGTrader 连接器操作和示例。 有关所有连接器操作、其参数和返回类型的列表，请参阅 CGTrader 连接器参考。

操作​​ 说明 示例
GetModel 下载具有给定模型 ID 和文件类型的 3D 模型。 CGTrader.GetModel(model_id, "file_type")
GetModelInfo 获取有关具有给定模型 ID 的 3D 对象的信息。 CGTrader.GetModelInfo(model_id)
SearchModels 根据给定筛选器从 CGTrader 中搜索模型。 考虑将此操作绑定到库中的项。 CGTrader.SearchModels({keywords:"keywords",extensions:"file_types"}).Models
GetCategories 获取可用的类别名称和模型 ID。 CGTrader.GetCategories()

另请参见