# 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**](https://softability.gitbook.io/xreach/realwear/realwear-installation)), here are a few voice commands available to you. Saying **`XReach`** will start the application, if you are in **`My Programs`** already. 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

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. 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. 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.

Forgot password and request account options in login form

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

Saying **`Mine`** , **`All`** or **`Read-only`** will change tabs. To access Settings, say **`Settings`** . QR code scanning can be accessed through the command **`QR`** .\ Filter tickets by Groups with the voice command**`Filter`**. \ Refresh the list of tickets by saying**`Refresh`**. \ To search for a specific keyword in tickets, say**`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 `** or **``**. 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:

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.

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.

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.

Quick call view with group selection dropdown on the top of the page

## Ticket Detail View ### Info tab Having now successfully created a ticket, you will see something akin to the image below:

The following voice commands will be valid:\ \&#xNAN;**`Navigate Back`** takes you back to **Ticket List View**\ \&#xNAN;**`Info`** use this to get to the **Ticket Info** tab.\ \&#xNAN;**`Solution`** use this to get to the **Ticket Solution** tab.\ \&#xNAN;**`Media`** use this to get to see the **Attachments** inside the **Ticket**. **`Chat`** use this to get to see the **Ticket Chat**.\ \&#xNAN;**`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`**.

### Solution tab

### **Attachments tab**

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. *E.g.* in the below image the attachment can be viewed by saying **`View`** or **`Select item 1`**.

After opening an image or a PDF - you will see that the **Zoom Level** can be adjusted. ![An Image, ready to be zoomed.](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MOoDPeNa_MQAuwkq_UM%2F-MOoIwtNlq2j3cYNLZu8%2Fimage.png?alt=media\&token=cc1e4d1a-be28-4632-beb0-02b5d4e141ba) After saying **`Zoom Level 3`**, you will see something similar to the below screenshot: ![Zoom Level 3](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MOoDPeNa_MQAuwkq_UM%2F-MOoJCiyiNTgTir8usb9%2Fimage.png?alt=media\&token=87096ff6-f1eb-4531-b338-6f40e1ab656c) 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](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MOoJWRDJfhS3cA8-6k2%2F-MOoJsJZ8mTt41Ay4Gkr%2Fimage.png?alt=media\&token=2851e7db-326a-48ed-a843-2c20930f8f5d) ![Zoom Level 3](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MOoJWRDJfhS3cA8-6k2%2F-MOoJwgRq_J_gwbMw1s1%2Fimage.png?alt=media\&token=dc9975a7-3f7c-4b16-b7cd-0cf912bbbb87) 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](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MifBuYPnBX_9wZlBd4f%2F-MifCQs7e7YzppAXwgI1%2Fscreenshot_1630664945194.png?alt=media\&token=1ad4fd12-162d-4d0b-88c2-8e0459378e3c) 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`**.

In addition to this, you can translate other users' messages or delete your own messages. Choose a message by saying **`Message `** 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.

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.

### 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 `**.

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.

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 **` languages`**.

## 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

General call view. Orange buttons show that chat and media tabs have new items

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](https://4219527844-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MMPaHg7zC9PGFTMjK1L%2F-MOoKOvnoaKNoKZg2_to%2F-MOokWUjpBheAQMv6NfO%2Fscreenshot_1608273567162%20copy.png?alt=media\&token=2c63dae6-ebc7-4001-9bdb-60d6b50b85d0) 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.

During annotation sharing command "Hide annotation" can be used to return to the call view

### 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**.

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"**](https://softability.gitbook.io/xreach/webclient/teleconference-feature) 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`**.

### **Settings**

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.

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: