ウェイファインダー
このウィジェットの機能
ウェイファインダーウィジェットを使用すると、ユーザーをモデルの特定の部分または環境内の場所に誘導する際に役立つウェイポイントを配置できます。注意を促したり、ユーザーをモデル上の位置に誘導したり、環境内に配置したりする場合は、ウェイファインダーを使用します。
動作中のウィジェット
ウィジェットがどのように表示されるか、以下に例を示します。
|
使用時に必要な最小ステップ
|
|
1. 「モデル」ウィジェットをドラッグして、キャンバス上にドロップします。
2. 「リソース」フィールドで、既存の CAD ファイルを選択するか、新しい CAD ファイルを追加するか、表示する CAD ファイルの URL を入力します。
3. キャンバスでモデルを目的の場所に配置します。
4. 「ウェイファインダー」ウィジェットをドラッグして、キャンバス上にドロップします。
5. 「ウェイファインダー」ウィジェットに次のプロパティが設定されていることを確認します。
◦ 「イベント半径 (m)」 - この例では、このプロパティは 0.5 に設定されています。
◦ 「ウェイファインダー表示境界 (m)」 - この例では、このプロパティは 1 に設定されています。
◦ 「自動アドバンス」 - このチェックボックスがオンになっていることを確認します。
|
|
「自動アドバンス」を有効にすると、「出発」イベントの使用が無効になります。
|
◦ 「有効」 - このチェックボックスがオンになっていることを確認します。 6. 「ウェイポイントを追加」アイコン (  ) をドラッグして、モデル上の位置にドロップします。 7. ウェイポイントを配置した後で、「わかりやすい名前」を変更することでラベルを更新できます。 8. ウェイポイントをさらに追加します。 9. モデル上にすべてのウェイポイントを作成した後、必要に応じてプロジェクトツリーで順序を変更できます。ユーザーは、プロジェクトツリーに表示されるウェイポイントの順序で、ウェイポイントに誘導されます。 10. エクスペリエンスをパブリッシュしてから、Vuforia View で表示します。最初のウェイポイントが表示されます。 |
このウィジェット固有のプロパティ、サービス、イベント、操作
ウェイポイントを配置した後で、ウェイポイントを選択して独自のプロパティとイベントを表示できます。詳細については、
ウェイポイントを参照してください。
一般的なウィジェットのプロパティ、サービス、イベントのリストについては、
共通のウィジェットプロパティ、サービス、イベントを参照してください。
次のテーブルに、このウィジェット固有のプロパティ、サービス、イベントを示します。
|
プロパティ名
|
JavaScript プロパティ
|
説明
|
|
リボンの色
|
ribbonColor
|
ウェイポイントのリボンに使用する色を選択します。
• オレンジ (デフォルト)
• 赤
• 緑
• 青
• 黄
• 黒
• 白
• マゼンタ
• ターコイズ
|
|
モデルまたは周囲とコントラストを成す色を選択します。
|
|
|
イベント半径 (m)
|
eventRadius
|
デフォルトでは、このプロパティは 0.5 に設定されます。
ユーザーがウェイポイントの周囲にイベント半径を入力すると、ウェイポイントに到達/ウェイポイントを出発し、「到着」または「出発」イベントがトリガーされます。このプロパティは、特定のウェイポイントの「イベント半径 (m)」によって上書きできます。
|
|
ウェイファインダー表示境界 (m)
|
wayfinderDisplayBoundary
|
デフォルトでは、このプロパティは 2 に設定されます。
0 より大きい値を入力すると、レチクルおよびリボンは非表示になります。この動作を回避するには、「ウェイファインダー表示境界 (m)」を 0 に設定します。このプロパティは、特定のウェイポイントの「ウェイファインダー表示境界 (m)」プロパティで上書きできます。
|
|
自動アドバンス
|
autoAdvance
|
このプロパティはデフォルトで選択されています。有効にした場合、ユーザーがウェイポイントのカットオフ半径に達すると、ウェイファインダーはナビゲーションを次のウェイポイントへ自動的に移動します。
|
|
ループ
|
looping
|
最後のウェイポイントが表示されると、配列の最初のウェイポイントに戻ります。
|
|
リボンを表示
|
showRibbon
|
このプロパティはデフォルトで選択されています。有効にした場合、デザインタイムおよびランタイムで、ウェイファインダーリボンが表示されます。
|
|
ウェイポイントを表示
|
showWaypoints
|
このプロパティはデフォルトで選択されています。有効にした場合、デザインタイムおよびランタイムで、ウェイポイントが表示されます。
|
|
ラベルを表示
|
showLabels
|
このプロパティはデフォルトで選択されています。有効にした場合、デザインタイムおよびランタイムで、ラベルが表示されます。
|
|
ラベルを手前に表示
|
labelsOnTop
|
このプロパティはデフォルトではオフになっています。有効にした場合、ラベルは別のオブジェクトの上に表示され、非表示にはなりません。
|
|
有効
|
|
このプロパティにより、ランタイムにウェイファインダーのオンとオフが切り替わります。これには、表示、イベントのログ、イベントトリガー、およびサービスが含まれます。
|
|
レチクルを表示
|
showReticle
|
このプロパティはデフォルトではオフになっています。有効にした場合、ランタイムにレチクルが画面の中央に表示されます。
|
|
ウェイポイントデータ
|
waypointsData
|
インデックスがゼロであるウェイポイントの配列。
|
|
選択したウェイポイントのインデックス
|
selectedWaypointIndex
|
現在選択されているウェイポイントのインデックス。
|
|
選択したウェイポイントデータ
|
selectedWaypointData
|
現在選択されているウェイポイントのオブジェクト。
|
|
サービス名
|
JavaScript サービス
|
説明
|
|
次
|
next
|
ナビゲーションは次のウェイポイントまで進みます。
|
|
前
|
previous
|
ナビゲーションは前のウェイポイントに戻ります。
|
|
イベント名
|
JavaScript イベント
|
説明
|
|
到着
|
arrived
|
ユーザーがウェイポイントのカットオフ半径に達したときにトリガーされます。
|
|
出発
|
departed
|
ユーザーがウェイポイントのカットオフ半径を離れるときにトリガーされます。
|
