IRS を使用したエクスペリエンスのマッピング

IRS では、エクスペリエンスにマッピングされるモデルテンプレートの複数のコンフィギュレーションに対してスケーラブルになるように、コンフィギュレーションを作成できます。これらのマッピングは、コマンドラインインタフェース (CLI) を Experience Service と接続するために cURL を使用して作成されます。このセクションでは、エクスペリエンスをマッピングするプロセスについて説明します。

3. 選択した CLI を開きます。このユースケースでは、コマンドプロンプトを使用しました。curl.exe ファイルを保存したディレクトリに移動します。たとえば、C:\installations などです。

4. CLI で、mappings と入力します。これにより、ユーザー名、パスワード、および Experience Service のログイン資格証明を設定する mappings.bat ファイルが実行されます。

セキュリティを確保するために、以下のイメージではパスワードが非表示になっています。

次に、cURL を使用して Experience Service にアクセスし、Experience Service に関連付けられているすべてのエクスペリエンスを検索します。リストには、パブリッシュされたすべてのエクスペリエンスが表示されます。

5. 次に、Vuforia Studio からのパブリッシュ時に作成されたプロパティを編集できるように、実行中のマッピングの結果を独自の .bat ファイルに保存します。新規の .bat ファイルを作成するには、次のコマンドを使用します。

作成したプロジェクトを検索します。ほとんどの場合、これはファイルの最後にあります。マッピングの value プロパティを調べて次のようになっているものを見つけることにより、パブリッシュしたエクスペリエンスのマッピングを見つけることができます。

プロパティ	説明
id	マッピングの ID 番号。
key	エクスペリエンスに関連付けられている ThingMark。
value	エクスペリエンスの URL。URL のフォーマットは、path/page.html?parameters です。path/page.html の部分はエクスペリエンス名です。パラメータはその値でマッピングされます。この場合、expId は 1 の値を持つ独自のパラメータであり、vumark は %7B%7Bvuforia:vumark%7D%7D の値を持つ独自のパラメータです。これらのパラメータは、ほかのコンフィギュレーションが作成されると更新されます。
resourcetype	エクスペリエンスが関連付けられているリソースのタイプ。
title	Vuforia Studio の「情報」セクションに入力したエクスペリエンスのタイトル。
createstamp	作成するマッピングのタイムスタンプ。
requires	トラッキング要件を設定します。
description	プロジェクトの説明 (作成した場合)。
projectversion	プロジェクトのバージョン。

最終的には、このコードを 1 行のテキストとして保持する必要がありますが、以下の .bat ファイル内の JSON のフォーマットは読みやすくするために編集されています。

10. 次に、新しいパラメータを value プロパティに追加する必要があります。これらのパラメータは、前のセクションでクワッドコプターモデルの色とモデルに対して作成したものと同じになり、エクスペリエンスの設定に使用されます。このユースケースでは、新しいテンプレートに curriculum という名前を付けますが、別の名前を付けることもできます。value プロパティを変更して、次のコードを含めます。

このパターンは、&name=value というフォーマットの URL にエンコードされたクエリーパラメータです。上記の例では、name は color 、value は {{curriculum.color}} です。二重括弧は、内側の値が評価されることを示します。この場合、(urn.)curriculum.color の値を求めています。これは IRS に追加されます。

コマンドインタプリタによって誤って解釈される可能性のある文字がいくつかあるため、情報が正しく解釈されるように、これらの文字を置換する必要があります。メモ帳などのエディタを開き、次の文字をサーチして置換します。

置換前...	置換後...
"	\"
%	%%
&	^&

curl -u %uname%:%passwd% -H "Content-Type: application/json" -H "X-Requested-With: XMLHttpRequest" -k -d "{ \"key\":\" urn:curriculum:template:202\", \"value\":\"projects/scalingdigitaltwinexperiences202/index.html?expId=1^&color=^%7B^%7Bcurriculum:color^%7D^%7D^&model=^%7B^%7Bcurriculum:model^%7D^%7D\", \"resourcetype\":\"Experience\",\"title\" : { \"en\":\"ScalingDigitalTwinExperiences202\" }, \"requires\" : [ \"AR-tracking\",\"w320dp\" ], \"description\":{ \"en\":\"Curriculum demo\" } }" %server%/ExperienceService/id-resolution/mappings

16. mappings コマンドを実行して、新しいマッピングが Experience Service テンプレートに追加されていることを確認します。マッピングリストの最後に新しいマッピングが表示されます。

17. テンプレートがエクスペリエンスにマッピングされた後、コンフィギュレーションを特定のプロパティにマッピングする必要があります。これらのプロパティは、クワッドコプターのモデルと色に対して作成したテンプレートのパラメータを設定するために使用されます。最初のコンフィギュレーションには config 1 という名前が付きます。

a. 以下のコードを使用して、最初のコンフィギュレーションパラメータ (color パラメータ) を設定します。color パラメータは、Vuforia Studio で以前に作成したアプリケーションパラメータと対話するので、最初の手順で作成したすべての色をパラメータ入力として使用できます。この例では、モデルの色を紫色に設定しています。

curl -u %uname%:%passwd% -H "Content-Type: application/json" -H "X-Requested-With: XMLHttpRequest" -k -d "{\"key\": \"urn:curriculum:config:1\", \"value\": \"urn:curriculum:color:purple\"}" %server%/ExperienceService/id-resolution/mappings

b. 次に、color パラメータをマッピングしたときと同じ方法で model パラメータをマッピングします。ここでは、2 つ目のクワッドコプターモデルオプションにマッピングするモデルパラメータとして 2 を使用します。2 つのマッピングを使用すると、urn:curriculum:config:1 キーが次の両方の値にマッピングされるようになります。

curl -u %uname%:%passwd% -H "Content-Type: application/json" -H "X-Requested-With: XMLHttpRequest" -k -d "{\"key\": \"urn:curriculum:config:1\", \"value\": \"urn:curriculum:model:2\"}" %server%/ExperienceService/id-resolution/mappings

18. コンフィギュレーションとそのパラメータが作成された後、コンフィギュレーションをテンプレートに戻してマッピングする必要があります。以前は、urn:curriculum:template:202 をそのテンプレートとしてエクスペリエンスにマッピングしました。今回は、urn:curriculum:config:1 を urn:curriculum:template:202 に戻してマッピングします。

curl -u %uname%:%passwd% -H "Content-Type: application/json" -H "X-Requested-With: XMLHttpRequest" -k -d "{\"key\": \"urn:curriculum:config:1\", \"value\": \"urn:curriculum:template:202\"}" %server%/ExperienceService/id-resolution/mappings

19. コンフィギュレーションをマッピングする最後の手順は、ユーザーが作成したコンフィギュレーションに、ユーザーの ThingMark をマッピングすることです。この特定の ThingMark をスキャンするたびに、モデルの一意のコンフィギュレーションが表示されます。

該当する場合は、特定の ThingMark インスタンスを入力する必要があります。

curl -u %uname%:%passwd% -H "Content-Type: application/json" -H "X-Requested-With: XMLHttpRequest" -k -d "{\"key\": \"urn:vuforia:vumark:YOURTHINGMARK\", \"value\": \"urn:curriculum:config:1\"}" %server%/ExperienceService/id-resolution/mappings

これによって、その ThingMark に割り当てられているすべての解決がテキスト形式になります。color=^%7B^%7Bcurriculum:color^%7D^%7D^&model=^%7B^%7Bcurriculum:model^%7D^%7D の代わりに color=purple&model=2 が表示された場合、このマッピングは正常に追加されています。モデルパラメータは、当初 URL に含まれていたプレースホルダー変数を置き換える必要があります。

2. 次に、Vuforia View を開き、urn:curriculum:config:1 に割り当てた ThingMark をスキャンします。作成したクワッドコプターのコンフィギュレーションが表示された場合は、IRS を使用して最初のコンフィギュレーションが正常に追加されています。

3. 1 つのコンフィギュレーションが正常に作成されたので、作成したカリキュラムテンプレートを使用して、config:2 と config:3 という名前の 2 つのコンフィギュレーションをさらに作成します。コンフィギュレーションは、同じ ThingMark または別の ThingMark のいずれかに追加できます。次のマッピングを自分で作成してみてください。

ScalingDigitalTwinExperiences202.bat という名前の未完成の .bat ファイルが GitHub にあります。この .bat を実行することで、3 つの異なるコンフィギュレーションについて手順 11-17 のすべてのマッピングを実行できます。mappings.bat および resolve.bat ファイルは、GitHub にもあります。ファイルを実行する前に、ユーザー名、パスワード、サーバー、および ThingMark 番号を追加し、該当する場合はプロジェクト名を編集する必要があります。別のファイルを保存したディレクトリ内で CLI に ScalingDigitalTwinExperiences202 と入力して、ファイルを実行します。

最終結果は 3 つのコンフィギュレーションです。ThingMark (1) は、コンフィギュレーションにマッピングされ、(2) は、パス上のさまざまなプロパティ/値をテンプレート (3) に集めます。これにより、変数 (色、モデル) が収集された値に置き換えられます。結果は、変数入力が解決されたエクスペリエンスです。この例では、ThingMark は、赤のモデル 1 のアイテムであるフィギュレーション 2 にマッピングされます。最後のエクスペリエンスは、赤のクワッドコプターを示しています。