製品
* 
このウィジェットは、Vuforia Studio および Experience Service の 10.0.0 以降でのみ使用できます。
このウィジェットの機能
製品ウィジェットを使用すると、コードを記述せずに、モデルやモデルターゲットなどの再使用可能なアセットを読み込むことができます。製品 API を使用して、以前に Experience Service にアップロードおよび生成された製品固有のデータが自動的に取得されるので、ダイナミックコンテンツをエクスペリエンスに簡単に統合できます。詳細については、Vuforia Studio 製品 APIを参照してください。
このウィジェットを使用するケース
「製品」ウィジェットは、Experience Service からモデルとモデルターゲットを動的にロードする任意のエクスペリエンスで使用できます。「製品」ウィジェットを「モデル」ウィジェットおよび「動的ターゲット」ウィジェットに接続するだけで、取得したアセットがランタイムでシームレスにロードされます。スクリプトを作成する必要はありません。
このウィジェットを使用する場合、エクスペリエンスは定義済みのロジックに従います。
モデルが簡略化されている場合、エクスペリエンスは精度が「中」のバージョンを自動的に読み込みます。
複数のモデルターゲットが使用可能な場合、エクスペリエンスは、アドバンス、オンプレミスのアドバンス、標準の順で、使用可能な最高精度のロードを優先します。同じ精度レベルに複数のバージョンが存在する場合は、最新バージョンが自動的に選択されます。
ステップバイステップのチュートリアルについては、ユースケース: アセットの動的なロードと比較を参照してください。
このウィジェット固有のプロパティ、サービス、イベント、操作
一般的なウィジェットのプロパティ、サービス、イベントのリストについては、共通のウィジェットプロパティ、サービス、イベントを参照してください。
* 
実行中の Experience Service のバージョンが不明な場合は、管理者にお問い合わせください。
プロパティ名
JavaScript
タイプ
説明
製品 ID
productID
string
製品の製品 ID。
バージョン
version
string
製品のバージョンを指定します。1 つの製品に複数のバージョンが存在する可能性があります。バージョンが指定されていない場合、使用可能な最新バージョンがデフォルトで使用されます。
* 
「最新」とは、最も新しく作成されたバージョンを指し、最も大きいバージョン番号を持つ必要はありません。
モデル
modelUri
string
製品のモデルリソース URL。(.pvz ファイル)
ターゲット
targetUri
string
製品のターゲットリソース URL。(.dat ファイル)
* 
製品ウィジェットは、製品 ID とオプションのバージョンに基づいて製品データをロードおよび表示するために使用されます。製品 ID とバージョンの両方を指定した場合、ウィジェットはその特定のバージョンの製品をロードします。製品 ID のみを指定してバージョンを空白のままにした場合、ウィジェットは製品の最新バージョンを自動的にロードします。
イベント
JavaScript
説明
製品ロード済み
productLoaded
製品関連の URL が正常に取得されるとトリガーされます。モデルが完全にロードされたタイミングを検出するには、「モデルターゲット」ウィジェットの modelLoaded イベントを使用します。
製品が失敗
productFailed
製品のロードに失敗したときにトリガーされます。
* 
指定した製品 ID、または製品 ID とバージョンの組み合わせが見つからない場合は、Product Failed イベントがトリガーされます。このイベントは、ユーザーインタフェースにエラーメッセージを自動的に表示しません。エクスペリエンスの作成者には、このイベントを処理し、エクスペリエンスに必要なエラー通知やフォールバック動作を作成する責任があります。これにより、不足している製品データをどのようにユーザーに伝えるかを完全に制御できます。
ユースケースの例
次のユースケースを参照してください。
これは役に立ちましたか?