ターゲットの生成
このセクションでは、以前に作成したモデルの .pvz ファイルを使用してターゲットを生成します。これらのターゲットは、複数のエクスペリエンスで再使用できます。この例では、ユースケースをより迅速に移動できる標準モデルターゲットを使用しますが、必要に応じて、より強力なアドバンスモデルターゲットまたはオンプレミスのアドバンスモデルターゲットをご自由にお使いください。
ほとんどの場合、リクエストの構造は
Vuforia Engine SDK API の定義に依存します。Studio 固有のガイダンスについては、
Experience Service の
API ドキュメントを参照してください。
1. 設定したビューで、モデルターゲットのサイズと方向が考慮されていることを確認してください。検出とトラッキングのパフォーマンスを最適化するために、明確で認識しやすい角度からモデル全体が完全に見えるビューを少なくとも 1 つ作成します。以下のいずれかの方法を使用して、API でターゲットを生成します。
|
方法
|
手順
|
|
Postman
|
POST /ExperienceService/products/v1/target
{
"name": "Quadcopter Base",
"targetType": "standard",
"targetSdk": "10.9",
"models": [
{
"name": "Quadcopter Base SMT",
"modelId": <Model-Id>, //take the UUID that the Post Model API returned in the last step
"optimizeTrackingFor": "LOW_FEATURE_OBJECTS",
"automaticColoring": "auto",
"upVector": [0.0, 1.0, 0.0],
"views": [
{
"name": "viewpoint_0000",
"layout": "landscape",
"guideViewPosition": {
"translation": [0.19104722142219543,
0.19300971925258636,
0.2014508694410324],
"rotation": [-0.23911770032491195,
0.36964383294987413,
0.09904579601423466,
0.892399065690545]
}
}
]
}
]
}
|
|
Curl コマンドを使用
|
curl --location 'https://<yourESURL>/ExperienceService/products/v1/target' \
--header 'X-Requested-With: any' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"name": "quadcopter base",
"targetType": "standard",
"targetSdk": "10.9",
"models": [
{
"name": "Quadcopter Base SMT",
"modelId": "yourModelUUID",
"optimizeTrackingFor": "LOW_FEATURE_OBJECTS",
"automaticColoring": "auto",
"upVector": [0.0,1.0,0.0],
"views": [
{
"name": "viewpoint_0000",
"layout": "landscape",
"guideViewPosition": {
"translation": [0.19104722142219543,
0.19300971925258636,
0.2014508694410324],
"rotation": [-0.23911770032491195,
0.36964383294987413,
0.09904579601423466,
0.892399065690545]
}
}
]
}
]
}
'
|
2. 応答は次のようになります。
{
"targetId": "<targetId>", // Optional. Only sent in case when job to create Target is accepted.
}
3. 次のいずれかの方法を使用して、モデルターゲット生成のステータスを取得します。
|
方法
|
手順
|
|
Postman
|
GET /ExperienceService/products/v1/target/status/<targetId>
|
|
Curl コマンドを使用
|
curl --location 'http://<yourESURL>/ExperienceService/products/v1/target/status/<yourTargetUUID>' \
--header 'Authorization: ••••••'
|
4. 応答は次のようになります。
{
"simplifiedStatus": "queued|inProgress|completed|failed|deleted|toBeCancelled|toBeDeleted", // Dataset's current status
}
5. 手順 1 から手順 4 を繰り返して、Quadcopter Updated モデルの標準モデルターゲットを生成します。リクエストの modelId を必ず更新してください。