CGTrader から Mixed Reality コントロールに 3D モデルを読み込む (プレビュー)

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

重要

これはプレビュー機能です。

プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

独自の 3D モデルを作成せずに、Mixed Reality の 3D コンテンツを使用してアプリを作成したいですか ? CGTrader コネクタ を使用して、CGTrader からキャンバス アプリに 3D コンテンツをインポートします。 CGTrader は、何千もの無料およびプレミアム 3D モデルのライブラリを提供しています。 アプリ内のモデルを参照してロードし、3D object コントロールと View in 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 object コントロールか View in MR コントロールに直接ロードする

  1. CGTrader の Web サイト でモデルを見つけて選択します。

  2. サポートされているファイル タイプとモデル ID に注意してください。

    CGTrader.com 上の 3D オブジェクトのファイル タイプとモデル ID のスクリーンショット。

  3. Power Apps Studio で、3D object または View in MR のコントロールをアプリ スクリーンに追加します。

  4. コントロールの Source プロパティを CGTrader.GetModel(model_id, "file_type") に設定します。これは model_id が選択したモデルの ID で、file_type はサポートされているファイル タイプのひとつです。

    CGTrader モデルに設定された Source プロパティと共に表示される、Microsoft Power Apps Studio で作成中の 3D object コントロールのスクリーンショット。

コネクタのアクション

次のテーブルに、最も一般的な 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()

参照