Spatial Workplace for iOS

Basic actions

Pairing the app with the server (first-time use) 

When opening Spatial Workplace mobile app for the first time, you need to pair it with the right server instance. This ensures the correct syncing of the necessary data.

1. Enter the company link provided by your administrator.
2. Enter the domain name provided by your administrator.
3. Tap on Confirm.

Signing in to the app

After pairing, you will be directed to the Single-Sign-on page in a web browser.

To sign in:

1. Enter the username and password provided by your administrator.
2. Tap on Sign In.

Signing out of the app

1. In the top-right corner, tap on the Settings button.
2. Tap on Logout.
3. Tap on Ok!.

Changing the paired server

Re-pairing the app after logging out is possible by entering your credentials manually for alternative licenses and permissions.

To change the server you have paired previously:

1. Sign out of the app.
2. Tap on Edit Configuration.
3. Enter the new company link and domain name provided by your administrator.
4. Tap on Confirm.

User interface

Status bar

The status bar is located at the very top of the Spatial Workplace mobile app. It informs you about the overall status of your device. You can see the connection status, search for tasks and templates, and access the app settings.

Navigation section

The navigation section is located at the very bottom of the Spatial Workplace mobile app. It gives you access to the Task List and Templates.

Task List screen

The Task List shows all the tasks assigned to the user. Here you can download and execute tasks.

1. Status bar
2. Task List screen
3. Navigation section

Templates screen

The Templates lists all the assigned templates to the user. Here you can download and execute templates.

Tasks

Tasks are used to assign workflows to the users. When you tap on a task, you can view the details such as planned date, by whom it is created by, and tags etc. From there, you can start a task simply by tapping on the Start Task button.

Alternatively, open a specific workflow using your device's camera:

1. Open Frontline Command Center.
2. Go to Tasks and find the workflow to open on the device.
3. Click on Print QR Code.
4. Point the camera of your device to the QR code. 

⇒ By opening the link, the application opens automatically and runs the selected workflow.

Note: If the user is not assigned to the selected workflow, the application will open the main menu.

Anchored content:

3D Model view

The 3D model view, on the other hand, gives the user the possibility to see and handle the workflow in a virtual environment that is independent of the physical world. There is no necessity for a Scene State node or a hologram to be visible at a certain step for the user to be able to go to the 3D view.

To open and close the model view, select Show in 3D on the Workflow Menu. This option is available for all pins that contain at least one hologram or have scene states visible.

After a part of the hologram has been hidden, the eye toggle appears on the top right of the screen. Tap on it to unhide the part.

Positioning workflow content

Later on, you need to perform specific actions depending on the spatial reference (markers, or object tracker) used in the workflow.

Workflows with markers

After finishing the surronding scanning, the marker scanner appears. On the top, the marker IDs are activated to start the workflow. The device's camera will open in the background and the user can focus on the chosen marker to display the first pin.

Workflows with object tracker

After finishing the surronding scanning, the hologram of the initial pose of the object appears. The device camera opens in the background and the user can position the object inside the outline until loading is completed.

Changing the initial pose: To change the initial pose of the object, change the position of the object tracker in relation to the model inside your Spatial Editor project.

Workflow with model placement

After opening the workflow, the camera of the device opens in the background and users can move their device around to find a flat surface (e.g., a floor or a table). Recognized surfaces will be marked with white dots.

To adjust the position and rotation of the model:

1. Tap on the screen to position the model on this surface.
2. Pinch your fingers on the model to zoom in and out.
3. Tap over the model and move your finger around to rotate it.
4. Tap outside the model, on a free surface, to reposition it.

It is also possible to reposition and rotate the model during the execution of the workflow. Users can rotate the model, rescale it with pinching in/out, and move it up and down with a three-finger hold. The degree values and percentage of scale are visible while making adjustments.

Note: Readjustments are possible only if the model has been made visible with a scene state node in the workflow with proper adjustments. Please see this page about how to make models visible using scene states.

Restart tracking

If the content drifts from its correct placement during the workflow, the user can reposition the workflow and reset its spatial reference. On the workflow menu, select the Reposition Workflow option. The user is prompted to reset the spatial reference of the workflow (e.g., rescan the marker) and then the workflow continues with the previous step. 

Templates

Templates are used to assign workflows to the users. From there, you can start a task simply by tapping on the template. 

Alternatively, open a specific workflow using your device's camera:

1. Open Frontline Command Center.
2. Go to Templates and find the workflow to open on the device.
3. Click on Print QR Code.
4. Point the camera of your device to the QR code. 

⇒ By opening the link, the application opens automatically and runs the selected workflow..

Note: The application will open on the main menu if the user is not assigned to the selected workflow.

The process for workflow navigation, AR overlay view, 3D model view, controlling the model inside the 3D model view, positioning workflow content, workflows with markers, workflows with object tracker, workflows with model placement, and restart tracking are the same as Tasks. For these details, please refer to the Tasks section above.

Custom theme applied

Custom Themes allow the user to customize the theme and appearance of Frontline Spatial Workplace application. Custom themes are configured in Frontline Command Center, for more information, please visit our Custom Themes page.