ar - recognitionmapping Function

Use this function to map the recognition format from the AR application to IoT CS device/application pairs. The function enables you to map an image or object to a specific IoT record.

The function expects major/minor integer pairs to identify the recognition. These pairs are defined in the AR application’s AR assets.

Construct a JSON payload that maps the major/minor pairs as they are defined in the AR assets of the iOS app. The length of this file depends on how many recognition items you have configured in the AR app.


{
    "items": [
        {
            "major": 1,
            "minor": 1,
            "deviceId": "B47C0F65-F1D7-4642-9694-E00B9500C63D",
            "applicationId": "0-AB"
        },
        {
            "major": 2,
            "minor": 1,
            "deviceId": "B47C0F65-F1D7-4642-9694-E00B9500C63D",
            "applicationId": "0-AB"
        },
        {
            "major": 3,
            "minor": 1,
            "deviceId": "DA99E3EB-3743-437C-94F4-DEB77C91723F",
            "applicationId": "0-AB"
        },
        {
            "major": 3,
            "minor": 2,
            "deviceId": "DA99E3EB-3743-437C-94F4-DEB77C91723F",
            "applicationId": "0-AB"
        },
        {
            "major": 4,
            "minor": 1,
            "deviceId": "N/A",
            "applicationId": "N/A"
        },
        {
            "major": 5,
            "minor": 1,
            "deviceId": "D2C22D16-A77F-4B56-A1DF-B44771F4A0E1",
            "applicationId": "0-AB"
        },
        {
            "major": 6,
            "minor": 1,
            "deviceId": "744BC778-F2E4-4626-9FD6-086714E77BE1",
            "applicationId": "0-AB"
        }
    ]
}

Once your array is finished, minify and escape the JSON payload into a string.

"{\"items\":[{\"major\":1,\"minor\":1,\"deviceId\":\"B47C0F65-F1D7-4642-9694-E00B9500C63D\",\"applicationId\":\"0-AB\"},{\"major\":2,\"minor\":1,\"deviceId\":\"B47C0F65-F1D7-4642-9694-E00B9500C63D\",\"applicationId\":\"0-AB\"},{\"major\":3,\"minor\":1,\"deviceId\":\"DA99E3EB-3743-437C-94F4-DEB77C91723F\",\"applicationId\":\"0-AB\"},{\"major\":3,\"minor\":2,\"deviceId\":\"DA99E3EB-3743-437C-94F4-DEB77C91723F\",\"applicationId\":\"0-AB\"},{\"major\":4,\"minor\":1,\"deviceId\":\"N/A\",\"applicationId\":\"N/A\"},{\"major\":5,\"minor\":1,\"deviceId\":\"D2C22D16-A77F-4B56-A1DF-B44771F4A0E1\",\"applicationId\":\"0-AB\"},{\"major\":6,\"minor\":1,\"deviceId\":\"744BC778-F2E4-4626-9FD6-086714E77BE1\",\"applicationId\":\"0-AB\"}]}"

Run the following F(n) command to set the configuration.

fn config f ar-accelerator ar-recognitionmapping mapping "{\"items\":[{\"major\":1,\"minor\":1,\"deviceId\":\"B47C0F65-F1D7-4642-9694-E00B9500C63D\",\"applicationId\":\"0-AB\"},{\"major\":2,\"minor\":1,\"deviceId\":\"B47C0F65-F1D7-4642-9694-E00B9500C63D\",\"applicationId\":\"0-AB\"},{\"major\":3,\"minor\":1,\"deviceId\":\"DA99E3EB-3743-437C-94F4-DEB77C91723F\",\"applicationId\":\"0-AB\"},{\"major\":3,\"minor\":2,\"deviceId\":\"DA99E3EB-3743-437C-94F4-DEB77C91723F\",\"applicationId\":\"0-AB\"},{\"major\":4,\"minor\":1,\"deviceId\":\"N/A\",\"applicationId\":\"N/A\"},{\"major\":5,\"minor\":1,\"deviceId\":\"D2C22D16-A77F-4B56-A1DF-B44771F4A0E1\",\"applicationId\":\"0-AB\"},{\"major\":6,\"minor\":1,\"deviceId\":\"744BC778-F2E4-4626-9FD6-086714E77BE1\",\"applicationId\":\"0-AB\"}]}"

Test the configuration is correct by running invoke:

echo -n '{"major":1,"minor":1}' | fn invoke ar-accelerator ar-recognitionmapping

The expected return result is a JSON object with the variables set above nested in a service object.

{"items":[{"major":1,"minor":1,"deviceId":"B47C0F65-F1D7-4642-9694-E00B9500C63D","applicationId":"0-AB"}]}