動的ターゲット
 |
動的ターゲットは、現在モデルターゲットのみをサポートしています。適切な機能を確保するためには、動的ターゲットを含むビューにアクセスする前にリソース URL を設定する必要があります。最適な使用方法として、アプリケーションパラメータとのバインディングを処理するセカンダリビューを作成することをお勧めします。
|
このウィジェットの機能
動的ターゲットウィジェットを使用すると、ローカルリソースとリモートリソースの両方から、さまざまなターゲットデータセットをロードできます。ユースケースに応じて、ランタイムで必要なターゲットを動的にロードできます。
このウィジェットを使用するケース
ランタイムに動的にロードできるエクスペリエンス内のモデルターゲットを参照する場合や、外部のターゲットリソースを参照する場合は、「動的ターゲット」を使用します。
詳細については、ユースケース: アセットの動的なロードと比較を参照してください。
動的ターゲットとモデルターゲット
モデルターゲットは、エクスペリエンス内で直接モデルターゲットを定義および生成する場合に使用する必要があります。このアプローチは静的なコンフィギュレーションには理想的ですが、アセットの再利用性のために最適化されていません。
事前に生成されたモデルターゲットアセットをロードする必要があるシナリオでは、Experience Service でホストされているか、エクスペリエンスにバンドルされているか、サードパーティのソースから提供されるかにかかわらず、「動的ターゲット」ウィジェットを使用します。このウィジェットはランタイムの柔軟性を重視して設計されており、アセットがすでに準備され、アクセス可能であることを前提としているため、「モデルターゲットエディタ」は含まれていません。
このウィジェット固有のプロパティ、サービス、イベント、操作
一般的なウィジェットのプロパティ、サービス、イベントのリストについては、共通のウィジェットプロパティ、サービス、イベントを参照してください。
|
|
実行中の Experience Service のバージョンが不明な場合は、管理者にお問い合わせください。
|
|
プロパティ名
|
JavaScript
|
タイプ
|
説明
|
||
|---|---|---|---|---|---|
|
リソース
|
src
|
string/resource_url
|
.dat ファイルへの直接 URL。これには、サフィックス .dat を含むファイルへのフルパスを含める必要があります。例: app/resources/Uploaded/mytarget.dat
|
||
|
外部リソース
|
srcType
|
boolean
|
外部リソースを使用する場合は、このチェックボックスをオンにし、URL を入力します。例: https://myserver/mytarget.dat
このプロパティは、「リソース」の datatype を変更し、ローカルプロジェクトファイルのドロップダウンメニューまたは外部リンクの入力フィールドを有効にします。
|
||
|
ターゲットタイプ
|
targetType
|
string
|
リンクされたリソースのターゲットタイプを定義します。このフィールドは編集できず、vuforia-model:// に設定されます。
|
||
|
トラッキング
|
isTracked
|
boolean
|
カメラがターゲットを認識すると有効になります。
|
||
|
固定
|
stationary
|
boolean
|
このチェックボックスは、ターゲットが安定した環境にあり、ユーザーによって移動されない場合に選択します。このチェックボックスをオンにすると、トラッキングのパフォーマンスが向上する場合があります。
|
||
|
ターゲットサイズ
|
size
|
number
|
ターゲットの幅を定義します。これは、ターゲットが CAD データの測定値を使用して生成されているときに、トラッキングがそれより小さいモデルで行われる場合に役立ちます。
|
|
イベント
|
JavaScript
|
説明
|
|---|---|---|
|
トラッキング取得
|
trackingacquired
|
トラッキングを開始したときにトリガーされます。
|
|
トラッキング紛失
|
trackinglost
|
トラッキングが失われたときにトリガーされます。
|
|
ターゲットロード済み
|
targetLoaded
|
ターゲットが完全にロードされたときにトリガーされます。
|
ユースケースの例
ユースケース: アセットの動的なロードと比較を参照してください。
既知の制限
|
制限
|
推奨事項と次善策
|
|---|---|
|
「動的ターゲット」ウィジェットを (場合によっては「製品」ウィジェットと組み合わせて) 使用しているときに、ターゲットのロード中にアプリケーションがバックグラウンドに送信されると、ターゲットのスナップが失敗することがあります。フォアグラウンドに戻ると、エクスペリエンスのトラッキングが正しく再開されない場合があります。
|
推奨事項: 適切なスナップ動作を確実に行うために、ターゲットが完全にロードされるまでアプリケーションに留まります。
次善策: 問題が発生した場合は、Vuforia View でエクスペリエンスを再ロードして機能を復元します。
|