> For the complete documentation index, see [llms.txt](https://softability.gitbook.io/xreach/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://softability.gitbook.io/xreach/realwear/xreach-realwear-voice-commands.md).

# RealWear Voice Commands

After installing **XReach** onto your **RealWear Glasses** (please check [**this documentation for how to install RealWear Explorer, RealWear Companion, and set up your RealWear glasses**](/xreach/realwear/realwear-installation.md)), here are a few voice commands available to you.

Saying **`XReach`** will start the application, if you are in **`My Programs`** already.&#x20;

If you are anywhere other than there, just say **`Navigate Home`**, followed by **`My Programs`** and then **`XReach`**.

## Global Commands

While **XReach** is running, you can always say **`Show Help`** to see any buttons available to you in the view you are currently in.\
\
If a view has additional data, please use the **`Page Down`** and **`Page Up`** voice commands to scroll down and scroll up.

If a function does not have an associated button (such as **`Refresh`**), a numbered circle will be displayed. In this case, you can command it by saying, for example, **`Select Item 1`**.

**`Navigate Back`** will take you to a previous view. **`Navigate Home`** will return you to the RealWear Home screen.

## Login form

<figure><img src="/files/66fiB7zV8Qer1ZHlaSpm" alt=""><figcaption><p>The login form</p></figcaption></figure>

The XReach Login Form will require you to fill in your **Email Address**, **Password** and **Server** to be able to activate the **`Login`** voice command.&#x20;

By using the **RealWear Companion** app on your mobile device ([Android](https://play.google.com/store/apps/details?id=com.realwear.companionapp\&hl=en\&gl=US), [iOS](https://apps.apple.com/us/app/realwear-companion/id1224712680)), you can use the **Remote Keyboard** feature to create the 3 QR-codes required to fill the Email, Password and Server. (Find out more about **RealWear Companion** and QR-codes [here](https://softability.gitbook.io/xreach/realwear/realwear-installation#setting-up-realwear-companion).)

Start by saying **`Email`**, to select the Email address textfield. Position your Mobile device close to the **RealWear Glasses** camera, and state **`Scan Code`**. Your E-Mail Address should now be filled.&#x20;

Say **`Password`** to start inputting your Password - again, use **`Scan Code`** to read the QR-code for your password from your **RealWear Companion** app running on your mobile device. If you are unsure of what the password you input was, just say **`Toggle Password`** to show/hide the password.

The last step is to input your **Server**. Start by saying **`Server`** to select the Server textfield. Again, use **Scan Code** to read in the QR-code content from your **RealWear Companion** app running on your mobile code. You are now ready, and the **`Login`** button has been enabled.

{% hint style="danger" %}
If you don't know which **Server** you should use, please get in touch with **Softability** or your **IT department** for more information.
{% endhint %}

Saying **`Login`** will now log you in, and you will see the **Ticket List View** next.

In case you have trouble logging in or don't yet have an account in the system, you can also use the **`Forgot Password`** and **`Request Account`** commands in login view.

<figure><img src="/files/yRo20xq8kzD3BTq7eNrv" alt=""><figcaption><p>Forgot password and request account options in login form</p></figcaption></figure>

## Ticket List View

From the Ticket List View, the available voice commands are as listed:

<figure><img src="/files/I1KtA4VRinJOA7lkLDAG" alt=""><figcaption></figcaption></figure>

Saying **`Mine`** , **`All`** or **`Read-only`** will change tabs.&#x20;

To access Settings, say **`Settings`** .

QR code scanning can be accessed through the command **`QR`** .\
Filter tickets by Groups with the voice comman&#x64;**`Filter`**. \
Refresh the list of tickets by sayin&#x67;**`Refresh`**. \
To search for a specific keyword in tickets, sa&#x79;**`Search`.**\
To create a new ticket, say **`Create ticket`.**

To make a Quick call, use command **`Quick call`** .\
To scroll up or down, say  **`Page Up`** or **`Page Down`**.\
\
You can enter a ticket by saying **`Select Item <number>`** or **`<ticket id>`**. In the screenshot above, you would select the first ticket by saying **`Select Item 2`** or  **`2934`**.

## Creating a ticket

While in the Ticket List View, you can say **`Create ticket`**, to start the ticket creation process.

Depending on your environment the ticket creation process might differ somewhat. If the environment has enabled guides, the guide options will show after the **`Create ticket`** command has been issued. Guides can be selected by the issue name or item number, e.g. **`Loader issue`** or **`Select item 3`** for the image below:

<figure><img src="/files/ftjeH3vEVaWVp9jpTCuD" alt=""><figcaption><p>Ticket creation through a guide</p></figcaption></figure>

Guide steps can be filled by using command **`Enter text`** or **`Select item 4`**, or if you want to scan a QR/barcode or use text recognition, by using commands **`Start scan`** or **`Text recognition`**. Guide steps can also be translated by command **`Translate`**, and navigation forwards and backwards in the guide happens with the commands **`Next`** and **`Previous`**. After the last step guide will close with the command **`Finish`** after which the **Create ticket form** is presented.

<figure><img src="/files/dWISGBuHSCsEdCnxv7fY" alt=""><figcaption><p>Guide steps filling</p></figcaption></figure>

What you see here differs depending on which environment you are viewing - there might be additional textfields or dropdown menus enabled for a **Ticket**, or not - this depends on the **Environment Configurator** settings.

<figure><img src="/files/rQKnumXPoIX6bgZ3gK2E" alt=""><figcaption><p>Create ticket form</p></figcaption></figure>

In order to increase the usability of the Create / Edit Ticket view with RealWear, you can simply speak the title of the textfield you wish to fill. For instance, say **`Description`** and you are editing the **Description** textfield. Any field that does not have a spoken word available to it, will be shown with the circled numbers, and then you can say, for instance, **`Select Item 5`** to select the fifth item. If you wish to see more textfields (and your environment has more textfields configured), say **`Page Down`**.

**`Save`** will only start working as a voice command when you have filled all the required textfields. The amount of required textfields will vary depending on the environment you are in.

After creating a ticket, you will be transported to the **Ticket View**.

### Quick Call

The **`Quick Call`** command in Ticket List View can be used to contact an expert directly without having to create a ticket first. This command enables you to choose a group and an expert to contact, and creates a ticket where additional information related to the issue at hand can be added to. After the initial call, Quick Call tickets work as any other tickets in the system.

<figure><img src="/files/wgsDaxusRH6e1tW6dsBt" alt=""><figcaption><p>Quick call view with group selection dropdown on the top of the page</p></figcaption></figure>

## Ticket Detail View

### Info tab

Having now successfully created a ticket, you will see something akin to the image below:

<figure><img src="/files/ZolE03JFtsBsqbwH6VB5" alt=""><figcaption><p>Created ticket</p></figcaption></figure>

The following voice commands will be valid:\
**`Navigate Back`** takes you back to **Ticket List View**\
**`Info`** use this to get to the **Ticket Info** tab.\
**`Solution`** use this to get to the **Ticket Solution** tab.\
**`Media`** use this to get to see the **Attachments** inside the **Ticket**.

**`Chat`** use this to get to see the **Ticket Chat**.\
**`Call`** use this to place a call to an **Expert**.

You can either say **`Select Item 1`** or **`More Options`** to open the **Overflow Menu (...)**

Upon opening the **Overflow Menu**, the following voice commands will become available:  **`Edit Ticket`**, **`Assign Expert`**, **`Add Attachment`** and **`Tag User`**.

To close the **Overflow Menu**, say **`Navigate Back`**.

<figure><img src="/files/2ldq2TuTkEkabJ6UMn5c" alt=""><figcaption><p>Overflow menu</p></figcaption></figure>

### Solution tab

<figure><img src="/files/QtBeM05CD3XcYyMYB9JM" alt=""><figcaption><p>Solution tab</p></figcaption></figure>

### **Attachments tab**

<figure><img src="/files/A4bAaIX5M7Ms7VLdEG3z" alt=""><figcaption><p>Ticket attachments tab</p></figcaption></figure>

In the **Media** tab you can view the attachments from that ticket. New files can be added with the following commands:

**`Take photo`** to take a photo with your device and add it to the ticket.

**`Take Video`** to take a video with your device and add it to the ticket.

**`Upload Files`** to upload file(s) from your device and add them to the ticket.

Use commands **`Name`**, **`Date`**, or **`Type`** to order the attachments by given property, and repeat the command to reverse the order. The default sorting when entering the ticket is newest-to-oldest by attachment addition date.

#### Viewing and Zooming Images, videos, and PDFs

If a **Ticket** has **Attachments**, you can view any of them by deciding on which one to view and saying its item number, *e.g.* **`Five`**. As per usual, the global commands **`Page Down`** and **`Page Up`** will work for seeing more rows of attachments. Selecting an attachment wil show a popup with the options for available actions, which can be chosen by stating the action or by item number.&#x20;

*E.g.* in the below image the attachment can be viewed by saying **`View`** or **`Select item 1`**.

<figure><img src="/files/LwugSx7uX8SVTlWMotL6" alt=""><figcaption><p>Attachment actions</p></figcaption></figure>

After opening an image or a PDF - you will see that the **Zoom Level** can be adjusted.

![An Image, ready to be zoomed.](/files/-MOoIwtNlq2j3cYNLZu8)

After saying **`Zoom Level 3`**, you will see something similar to the below screenshot:

![Zoom Level 3](/files/-MOoJCiyiNTgTir8usb9)

You can now use the voice command **`Freeze Window`** to freeze the window - easier to focus on a detail for instance - after which the **`Freeze Window`** command will be visually replaced with the  **`Control Window`** voice command - which frees up your **RealWear Glasses** to rotate and pan around the image.

As always, use the **`Navigate Back`** voice command to get back to the previous view.

A similar example of using **Zoom** would be viewing a PDF - the exact same voice commands apply. Screenshots below:

![PDF View, ready to be Zoomed](/files/-MOoJsJZ8mTt41Ay4Gkr)

![Zoom Level 3](/files/-MOoJwgRq_J_gwbMw1s1)

And, of course, viewing a video uses the native **RealWear Document Viewer** experience to control Video playback:

![Video viewing using the native RealWear Document Viewer](/files/-MifCQs7e7YzppAXwgI1)

Return back to the **Ticket Attachments** view by saying **`Navigate Back`**. Then you can, for instance, start editing a ticket.

### Chat tab

In chat tab you can send messages by saying **`Message`**, inputting your message through voice recognition or Remote keyboard, and send the message with the command **`Send message`**.

<figure><img src="/files/QEEIhenP8WLw79mel4IY" alt=""><figcaption><p>Ticket chat tab</p></figcaption></figure>

In addition to this, you can translate other users' messages or delete your own messages. Choose a message by saying **`Message <number>`** and you'll see a popup with the available actions. By choosing either **Translate** or **Delete** the corresponding action will be carried out.

### Editing a Ticket

When you open the **Overflow Menu** by saying **`More Options`**, you can say **`Edit Ticket`** to start editing a pre-existing ticket.

<figure><img src="/files/fn0sx2r0x6VeFsS4ENNU" alt=""><figcaption><p>Ticket editing view</p></figcaption></figure>

All the previously mentioned voice commands are valid here, too - simply say **`Worksite`** to start editing that field. **`Save`**, **`Navigate Back`** and **`Cancel`** all work as expected.

### **Assigning an Expert**

Say **`Assign Expert`** to see a list of Experts. You can also **`Search`** or **`Refresh`** to find a specific **Expert** or to update your **Expert List**. After selecting a specific **Expert** by saying their item number or name, say **`Save`** to **Assign the Expert** to the ticket.

<figure><img src="/files/VDynaP95SHPp6Ax3tRSL" alt=""><figcaption><p>Expert list view</p></figcaption></figure>

### Changing an Owner

Changing the ticket owner can be done similarly to Assigning the Expert by choosing **Change Owner** once the **Ticket Overhead Menu** has been opened. Commands **`Search`** and **`Filter`** work as expected, and after choosing to filter the users a popup with possible user roles is presented. The role to filter by can then be chosen by command **`Select item <number>`**.

<figure><img src="/files/Yci6Ut6z3YaSSz2rH2kH" alt=""><figcaption></figcaption></figure>

After choosing a user the owner can be changed by saving the choice through the command **`Save`**.

### Tagging a User

Users can be tagged in the ticket by opening the **Ticket overhead menu** and choosing **`Tag User`** and choosing a user from the list similarly to when changing the ticket owner or assigner expert.

### Calling an Expert

Now would be a great time to place a call! Just say **`Call`** to get a list of available **Experts**. The online **Experts** will have a green circle next to their avatar icon.

<figure><img src="/files/jEUZkCQR5DRdbgbFKbCP" alt=""><figcaption><p>User list for making a call</p></figcaption></figure>

You can either state the name of the user, such as f.ex., **`John Smith`**, or say **`Select Item 4`** to call the User with the number 4 next to them. You can, of course, **`Refresh`** the list, or **`Filter`** it accordingly. Any user's language skills can be viewed with the command **`<User name> languages`**.

<figure><img src="/files/Y241EMcmQgVbLXw6yvB2" alt=""><figcaption><p>User's language skills</p></figcaption></figure>

## Call View

While waiting to be connected to an **Expert,** you will see a greyed out feed from your RealWear camera. The available voice commands are **`Mute`** and **`End Call`.**

After establishing a call, the rest of the features are enabled:

### Taking a Photo During Call

<figure><img src="/files/lw7WhYcNkJ5eZJ2xr5Uw" alt=""><figcaption><p>General call view. Orange buttons show that chat and media tabs have new items</p></figcaption></figure>

During a call, you can say **`Take Photo`** to immediately take a photo of what you are seeing with your **RealWear Glasses**.

### View and Zoom an Image Sent During Call

If an **Expert**, during a call, uploads an image or takes a screenshot from your **RealWear Glasses** camera feed, you will see that the **`Show Media`** voice command becomes available.

After saying **`Show Media`**, you will see that the **Zoom Level** is controllable via the same Voice commands (**`Zoom Level 3`**).

![Viewing an annotated image sent to you by the Expert](/files/-MOokWUjpBheAQMv6NfO)

Saying **`Navigate Back`** will take you back to the Attachments view. Saying **`Navigate Back`** will take you back to the call.

If another user in the call chooses to share **Image annotations** in real time, you also have the option to use voice command **`Hide Annotation`** to view the video stream instead.

<figure><img src="/files/kUTMUeGn6hzBOj20sZyA" alt=""><figcaption><p>During annotation sharing command "Hide annotation" can be used to return to the call view</p></figcaption></figure>

### Chat Overlay

If you are in loud circumstances, it might be useful to have the **Expert** assist you by sending you chat messages. The **Chat Overlay** feature is automatically toggled on when you receive new chat messages from the **Expert**.

<figure><img src="/files/6zctf97ll2ClGrowmqOK" alt=""><figcaption><p>Chat overlay: Messages shown on screen</p></figcaption></figure>

During a call, saying **`Toggle Chat`** will disable or enable the **Chat Overlay** for the duration of the call.

### Invite User

The **`Invite User`** voice command is used to start adding additional participants to the call. Find out more from the [**"Teleconference Feature"**](/xreach/webclient/teleconference-feature.md) article.

### Ending the Call

You can end the call by saying **`End Call`**. You are then transported back to the **Ticket List View**.

### Incoming Call

You can accept an incoming call with the voice command **`Accept`** or decline with **`Decline`**.

<figure><img src="/files/1sqXkFPTfPDUWPBKa0Ev" alt=""><figcaption><p>Incoming call popup</p></figcaption></figure>

### **Settings**

<figure><img src="/files/24NIc4Ueln0TmsUZmgZN" alt=""><figcaption><p>App settings</p></figcaption></figure>

The Voice Commands available in **Settings** are as follow:

-**`Preview features`** - use this to test new features if any are available in your environment.

-**`Dark Theme`** - use this to turn the Dark Theme On or Off.\
-**`Change password`** - use this for changing the password of your user account.\
-**`Reset credentials`** - use this for a clean logout where E-Mail, Password and Server are wiped and can be input again.\
-**`About XReach`** - use this to check the version of the Server and the App.\
-**`Logout`** - use this to log your user out - E-Mail, Password and Server will be retained.

### Resetting your credentials

When you say **`Reset credentials`**, the following popup will open.

<figure><img src="/files/lLCAf2CtmIyzT25lu9oL" alt=""><figcaption><p>Reset login details popup</p></figcaption></figure>

As expected, saying **`Cancel`** will Cancel and **`Reset`** will **Reset**.

### QR Scanning

By using the voice command **`QR`** in the Ticket list view, you are taken to a view where you can scan a QR code with your **RealWear Device**. After scanning the code XReach can use the data from that code to either create a new ticket or to search for existing tickets:

<figure><img src="/files/2hmBjRn9vfqfTe25feH3" alt=""><figcaption><p>Actions after scanning a QR code</p></figcaption></figure>
