Associate objects, logos, or text with dashboards in the Splunk AR mobile app

You can register assets using object, logo, or text detection in the Splunk AR app.

Splunk AR distinguishes assets that have the same object, logo, text by using the asset location. Define the asset location with beacons or geofences.

To learn more about this recognition method, see About Splunk AR About Splunk AR text, logo, and image detection.

Prerequisites

Complete the following before using object, logo, or text detection to register assets in Splunk AR:

• Your device is running iOS 13.0 or higher.
• Register your device to a Splunk Platform instance that has Splunk Secure Gateway and the Splunk App for AR installed. See Register your mobile device to a Splunk instance.
• Have the right Splunk AR user permissions Configure Splunk AR roles and permissions.
• Have Splunk compatible dashboards on your Splunk Enterprise instance. See Visualization support in the Splunk Secure Gateway Release Notes manual for more information about compatible visualizations.
• If you're registering an asset with a logo or image, have then logo or image saved on your device. The image should be cropped tightly fit the logo.
• Create or have an existing deployment for your assets. See Associate assets with dashboards in the Splunk App for AR in the Install and Use Splunk App for Splunk AR manual to learn how to create one.
• Set up a location identifier. See Set up and use beacons and Set up and use geofences to learn how in the Splunk AR app. or an admin can complete this when creating a deployment in the Splunk App for AR.

Set up 3D object detection

If you're associating data with a 3D object, scan the object first to get a 3D image capture so that Splunk AR can easily recognize it.

Here's how to set up 3D object detection in Splunk AR:

1. In the Splunk AR camera view, tap the ellipses icon.
2. Tap Set up Object Detection.
3. Tap the 3D Object tab.
4. Tap + New.
5. Tap Continue.
6. Follow the prompts to complete capturing the object.
7. Label the capture.
8. Select a deployment for the object.
9. Tap Continue.
10. Tap Try It Out to test your object detection now, or tap Not Now to try it later.

Text detection best practices

Make sure the text string is on a flat surface that's at least 10 inches wide.

If you register multiple assets using text strings that contain the same string of characters, and the assets are located close to each other, Splunk AR might have issues identifying the workspace when repeated text is within camera view. For example, if one text string reads "Hello World," and another text string within camera view reads "The World Goes Round," the text "World" might interfere with loading the workspace.

To avoid this, try the one following workarounds:

• Use unique text strings for assets that are located close to each other.
• Move the text strings further apart so that only one at a time is within view of the Splunk AR camera.
• If you're using beacons, lower the beacon broadcasting power to prevent overlap in the detection area.

Steps

To register an asset using object, logos, or text detection, associate the asset with a text string, logo, or 3D object. Then, configure the asset location with a beacon or geofence so Splunk AR can distinguish the text or logo from others.

1. In the Splunk AR camera view, tap the ellipses icon.
2. Tap Assets.
3. Tap Register.
4. Tap Object Detection.
5. Enter a string for text detection or select an image for logo detection.
   The text character limit is 100 characters.
   
   1. If you selected an image, crop the image to the size of the logo. Use the slider to indicate the actual width of the logo in the real world. For best results, measure the exact width of the logo.
6. Enter an asset name.
7. Select an existing AR workspace or create an AR workspace.
8. Configure the asset location.
   1. Select Beacon or Geofence.
   2. Select an existing beacon or geofence, or create a new one.
9. Select Save Asset.

When a Splunk AR user scans the text or logo, Splunk AR uses the text or logo as a visual anchor for augmented reality visualizations. The beacon or geofence distinguishes the text or logo by using the location to retrieve the correct data for that asset.