# SENAR Online Help ### Welcome to SENAR Online Help # Getting started with SENAR Studio (Instructor) In [SENAR Studio](https://studio.senar.io/), you can download the QR Codes for the collections you have been granted access to, and track how your students are performing with AR simulators. Here's how to get started in 3 easy steps: {% stepper %} {% step %} ## STEP 1: Get your Login You can receive your login information for SENAR Studio in two different ways: * Either your manager will send you your login and password. * Or you will receive an email from SENAR Studio inviting you to set your own password. If you have not received either one, please contact your manager. {% hint style="warning" %} If you get an "Invalid Token" message when creating your password, ask your manager to [reset your password.](/using-senar-studio/senar-studio-troubleshooting#invalid-token) {% endhint %} {% endstep %} {% step %} ## STEP 2: Get your QR Codes QR codes give you access to AR simulators in the SENAR mobile app, and allow you to easily share this access with your students. Your manager may choose to automatically send these QR codes to you by e-mail. Otherwise, you can easily access your QR Codes at any time, as follows: 1. Log in to SENAR Studio and head to "**My Profile**". 2. Click "**DOWNLOAD QR CODE**" on a collection to get a QR Code that you can share with your students.
{% endstep %} {% step %} ## STEP 3: Launch a training session Sharing a collection with your students is simple! Just send them your QR code via email, or display it on your screen if you are leading a distance training session. For example, you can paste the QR code into your Powerpoint presentation. To launch a training session, students open [the SENAR application](https://go.senar.io/app) either on their own device (distance learning) or on the device you provided them (on site training). Then they will proceed as follows: 1. On the SENAR home screen, they tap "**Enter as a Guest**" and scan your code. 2. They fill in their name and organization. 3. You can approve or deny each pending request with one click on the "**Approvals**" page in SENAR Studio. An email from SENAR Studio will also inform you when a student is awaiting your approval.
4. Once approved, the student can download the simulators. 5. The AR training can start! {% endstep %} {% endstepper %} # Getting started with SENAR Studio (Manager) In [SENAR Studio](https://studio.senar.io/), you can create collections of AR simulators, grant access to your instructors and consult analytics. Here's how to get started in 3 easy steps: {% stepper %} {% step %} ## STEP 1: Add Instructors 1. Go to the Users section and click "**ADD USER(S)"**, then select **Add user.**
SENAR Studio
2. Complete a profile for each instructor. They will automatically receive an email inviting them to create their SENAR password. Note: the "**Reference**" field is optional. It offers you an additional sort key in reports. For example, you may want to enter a region or cost center code, depending on what is relevant to your organization. {% hint style="success" %} If you wish to add a large number of instructors, you may prefer to upload them in bulk. Consult [this article](/using-senar-studio/upload-instructors-in-bulk) to learn more about that process. {% endhint %} {% endstep %} {% step %} ## STEP 2: Add Collections 1. Go to the Collections section and click "**ADD A COLLECTION"** 2. Assign a name to the collection. 3. Keep the box "**Needs approval**" checked if you want student access to be granted by the instructors (read more [here.](/using-senar-studio/collections-accessible-upon-approval)) 4. Add simulators by dragging them to the column "Simulators included", or by clicking the green **'+'**
5. Check the box next to the name of each instructor who should have access to the collection. 6. Click **Save** at the bottom of the screen. {% endstep %} {% step %} ## STEP 3: Share QR codes with instructors Each instructor can download their QR Codes from SENAR Studio, under "**My profile**".
You can also provide your instructors with their QR codes yourself. From the "**Instructors"** section of SENAR Studio, you can: * Have an e-mail including the QR codes sent to the instructor. * or Download your instructor's QR codes, to share them your own way. Both options are available by clicking the 3-dot button located at the right end of an instructor's row:
{% endstep %} {% step %} ## STEP 4: Add Managers (optional) If you want coworkers to help you manage your organization, you can add Managers. To do so, simply follow Step 1, and select "**Manager**" from the drop-down list of the user profile. {% endstep %} {% endstepper %} # How to use collection QR codes and how to get them Granting an instructor access to one of your collections automatically generates a QR code, specific to that instructor and that collection. ## How to use a QR Code? To start a training session, students launch the SENAR application either on their own device (distance learning) or on the device you provided them (on site training). 1. The instructor shares his/her collection QR code with the students. 2. On the home screen, students tap "**Enter as a Guest**" and scan the instructor's code. 3. They complete their name and organization. 4. In the case of distance learning, the instructor approves or denies each access from SENAR Studio "**Approvals**" page. 5. Once approved, the student can download the simulators. {% hint style="info" %} NB: if you wish to know the purpose of step #4, please consult [this article](/using-senar-studio/collections-accessible-upon-approval). {% endhint %} ## Where to get QR Codes from? Each instructor can download their QR Codes from SENAR Studio, under "**My profile**".
You can also provide your instructors with their QR codes yourself. From the "**Instructors"** section of SENAR Studio, you can: * Have an e-mail including the QR codes sent to the instructor. * or Download your instructor's QR codes, to share them your own way. Both options are available by clicking the 3-dot button located at the right end of an instructor's row:
{% hint style="success" %} When you create **new** instructors in bulk and grant them access to your collections at the same time, each of them will automatically receive their QR codes by e-mail. {% endhint %} # How to resolve 'Access Denied' in error {% hint style="info" %} If you are a student and you believe that your access to a simulator has been denied by mistake, please contact your instructor and invite them to visit this page. {% endhint %} If access to a collection of simulators has been denied in error, the instructor can easily rectify the student's authorization. To do this: 1. Head to the "**Approvals**" page in SENAR Studio. 2. Select '**Denied'** from the status filter. 3. In the list of denied users, click the green check mark in the row listing the affected student.
# Creating a collection A collection is a set of simulators that you group together in order to easily share them with a group of instructors. ## How to create a collection 1. Go to the Collections section and click "**Add a Collection"**. 2. Assign a name to the collection. 3. Keep the box "**Needs approval**" checked if you want students access to be granted by the instructors ([read more here)](/using-senar-studio/collections-accessible-upon-approval). 4. Add simulators by dragging them to the column "Simulators included", or by clicking the green '**+**'.
5. Check the box next to the name of each instructor who should have access to the collection. 6. Click **Save** at the bottom of the screen. {% hint style="info" %} As soon as a user is granted access to a collection, the corresponding QR code appears in his section "My profile". {% endhint %} ## Assign instructors in bulk to a collection If you wish to authorize a large number of instructors to access a collection, you may prefer a bulk operation. To do so: 1. Create your list of instructors in .csv format (see how to proceed [here](/using-senar-studio/creating-a-list-of-instructors-for-bulk-upload)). 2. Drag and drop your .csv file to the left box, under the list of simulators.
3. Click **Save** at the bottom of the screen. 4. Once the import is completed, all the **new** instructors in your list will automatically receive by email the QR code granting them access to the collection. {% hint style="danger" %} QR codes won't be automatically emailed to instructors who are already present in your Senar database. Please consult [this article](/using-senar-studio/how-to-use-collection-qr-codes-and-how-to-get-them) to learn how to access and share QR codes with these instructors. {% endhint %} # Collections accessible upon approval To prevent misuse of your QR codes, you can add an approval level before trainees can access a collection. This can be particularly useful in the case of distance learning sessions. ## How to set approval on a collection To activate this function, simply check the "**Needs approval**" box next to the collection name.
On the **Collections** page, collections needing approval will display a little padlock in the top right corner:
## Approval Flow When a student fills out the identification form after scanning the QR code for a collection that requires pre-approval: * A message will appear on their device, informing them that their access is pending approval from the instructor. * The instructor will receive an email inviting him/her to approve or deny the student access in SENAR Studio:
* In SENAR Studio, the instructor will grant or deny access by clicking on either the green check or red X button.
* Once the instructor has granted access, an "Access Granted" message will appear on the student's device. The student can then install the simulators of the collection. * If the instructor denies access, the pending user gets an "Access Denied" message and can't access the simulators. In this case, no token is debited from your account. {% hint style="info" %} You cannot withdraw access from a student after you have granted it. But if you have denied access in error, you can reverse your choice ([read more](/using-senar-studio/how-to-resolve-access-denied-in-error)). {% endhint %} # How to assign collections to your instructors ## Assign existing collection(s) to one instructor 1. In the **Users** section, click the instructor's name. 2. Under their Personal information, click the button '**Assign or unassign a collection'**. 3. In the popup window, select the collection(s) you wish to assign by dragging them to the left column or by clicking their green **'+'**
4. Click '**Save**' at the bottom of the popup window. ## Assign an existing collection to several instructors 1. In the **Collections** section, click the name of the collection that you wish to assign. 2. Go to the table "**Authorized users**". It is located either at the right or at the bottom of the page - depending on your screen's width.
3. Check the box next to the name of each instructor who should have access to the collection. 4. Don't forget to click '**Save**', at the very bottom of the screen. {% hint style="success" %} When you create a collection, it is assigned to you by default. \ Its QR Code is automatically available under "My profile". {% endhint %} # Upload instructors in bulk If you wish to add a large number of instructors, it is more convenient to use the bulk creation feature. In this case, we recommend that you create your collections first so you can assign them to your new instructors at the same time. ## STEP 1: Create Collections 1. Go to the Collections section and click "**Add a Collection"** 2. Assign a name to the collection. 3. Keep the box "**Needs approval**" checked if you want students access to be granted by the instructors (read more [here](/using-senar-studio/collections-accessible-upon-approval)). 4. Add simulators by dragging them to the "Simulators included" column, or by clicking the green '**+**'
5. Click **Save** at the bottom of the screen. ## STEP 2: Upload instructors in bulk 1. Create your list of instructors in .csv format. See how to proceed [here.](/using-senar-studio/creating-a-list-of-instructors-for-bulk-upload) 2. Go to the Instructors section and click "**ADD INSTRUCTOR(S)"** then select **Add instructors in bulk.** 3. Drag and drop your .csv file to the box at the top of the popup window.
4. Select the collection(s) you wish to share access to, by dragging them to the "Assigned Collections" column, or by clicking the green **'+'**. 5. Click **Save** at the bottom of the popup window. {% hint style="success" %} If your list includes **new** instructors, they will automatically receive an email with the QR code(s) granting them access to your collection(s). {% endhint %} # Creating a list of instructors (for bulk upload) Bulk uploads allow you to quickly create your user database in SENAR Studio, or to assign/unassign collections to a large number of instructors in one single operation. Here is how to create your user list. ## Case 1: The instructors do not yet exist in SENAR Studio Download [this .csv template.](https://www.dropbox.com/s/zci5z08l3igaqgx/SENAR_instructor_list.csv?dl=0) {% hint style="danger" %} Important: if you use this .cvs file in Excel, don't open it, but **import it** via the "Data" tab. This template uses the comma as a separator. {% endhint %} * **Email, First Name,** **Last Name** and **Country** must be completed for each instructor. * **Country:** only use exact names from [this list.](https://www.dropbox.com/s/uz6n8olbsgx4cds/SENAR_Country_List.pdf?dl=0) * **Reference** and **Password** can be left blank for all/some of the instructors. Even if you leave these columns empty, don't delete them. * **Reference:** this optional field offers you an additional sort key in reports. For example, you may want to enter a region or cost center code - depending on what is relevant to your organization. * **Password:** * A SENAR password must be at least 6 characters long, and contain letters and at least one number. * If you enter passwords for your instructors, don't forget to let them know what they are. * If you leave this field blank, each instructor will automatically receive an email inviting them to create their own password. {% hint style="danger" %} Do not delete, rename or localize column names. Your import file must be saved in .csv format and must use the **comma** as a separator, with no exceptions. {% endhint %} ## Case 2: The instructors already exist in SENAR Studio 1. Go to the **Instructors** section of SENAR Studio. 2. Use the filters to display only the instructors you wish to export. 3. Check the box at the top of the 1st column to select all visible instructors. You can also fine-tune your selection by unchecking the persons you may wish to exclude. 4. Click the down arrow at the top of the 1st column and select **Export**.
5. Check Case 1 above to learn how to use this exported .csv file.\ Important: if you use it in Excel, don't open it but **import it** via the "Data" tab. {% hint style="danger" %} The "Password" field in the .csv will be empty and must be kept as such. Do not delete this field or the re-import will not work. {% endhint %} # Edit instructors in bulk Managing your user database is easy, thanks to bulk editing. ## Update your user list 1. Export the list of instructors you want to update, as explained in Case #2 of [this article](/using-senar-studio/creating-a-list-of-instructors-for-bulk-upload). 2. Edit and save your `.csv` file following the guidelines outlined in Case #1 of the same article. {% hint style="warning" %} Bulk editing does not allow you to change existing users' passwords. {% endhint %} ## Re-import the file 1. In the "I**nstructors**" section of SENAR Studio, click "**Add Instructors(s)**" then choose "**Add users in bulk**". 2. Load your edited .csv file at the top of the popup window. 3. Just below, select the new collections you wish to share with the instructors. If they already have access to all the collections they need, just leave this box unchanged. 4. Click **Save** at the bottom of the screen. Wait for the confirmation message, without leaving the page. Bulk editing can take up to 2 minutes. {% hint style="danger" %} If you assign collections while editing in bulk, the new QR codes will not be automatically emailed to instructors, as is the case when creating a new list in bulk. Please consult [this article](/using-senar-studio/how-to-use-collection-qr-codes-and-how-to-get-them) to learn how to access and share QR codes. {% endhint %} # Tokens & QR Codes To launch a training session that will produce assessment reports, students must scan the QR Code provided by an active SENAR user (Instructor or Manager). This code provides access to all simulators in a defined collection. When a QR code is scanned into the SENAR application: * The student can install the simulators of the collection on their device (provided that the instructor grants them access). * Each simulator of the collection can be used for up to 5 hours over a 12-month period. * A token is debited from the client’s account collection. Users (Instructors and Managers) can download their QR Codes - one per collection in SENAR Studio in the "**My Profile**" section.
Details regarding the tokens used can be tracked in the "**Tokens**" section. *** *** # About Tokens The SENAR application allows students to launch and interact with AR simulators. It requires a valid token, which is triggered by downloading a simulator. ### When is a token debited? 1. **If approval is not needed to access the collection** * The student scans the collection QR code provided by the instructor and fills in the identification form. * The screen displays a list of simulators in the collection, each with a "Download" button. ➜ A token is debited when a simulator is downloaded. 2. **If approval is needed to access the collection** * The student scans the collection QR code and fills in the identification form. * The instructor is invited to grant or deny access in SENAR Studio. * After the instructor grants access to the student, the latter's screen displays a list of simulators in the collection, each with a "Download" button. ➜ A token is debited when a simulator is downloaded. ### How can tokens be tracked? Instructors and Managers can access the token report in the “Tokens” section of [SENAR Studio.](https://studio.senar.io/Tokens) This report displays the total number of tokens used and a list of all students who have downloaded simulators. It can be exported in .csv format. ### How long can a simulator be used? Each simulator can be used for up to 5 hours over a 12-month period. With this Fair Use policy, the student has all the necessary time to practice and acquire the required skills. {% hint style="info" %} The 5 hours of use are counted only when the simulator is in actual use (simulator launched, with the camera view open). {% endhint %} ### Can students change their name during a session? The students no longer have access to the identification form once it has been completed. Therefore, they cannot change their name or organization. ➜ 1 token = 1 download /student. ### What happens when students exit the SENAR application? When students exit the SENAR application, their session remains active. After restarting the app, they don't need to scan the QR code again. {% hint style="info" %} An "Active session" does not mean that a simulator is in actual use, but that a token is valid and the student is still identified in the app. {% endhint %} ### What happens if students exit the training session? When tapping the Exit button, students are clearly warned that this action will end their training session.
Once a session has been ended, a QR code must be scanned to launch a new one. ### What happens if students delete and reinstall the SENAR application? If students reinstall SENAR after removing the application from their device, they will have to scan the QR code again, which will start a new session. As a result, they will be considered to be a new student, even if they enter the same name and organization they used before. Their first session's data is saved in the cloud and remains available in the Analytics reports. # SENAR Studio: Troubleshooting Here are the solutions to the most common issues encountered in the Studio. ### **I get an "*****Email already exists*****" warning even though I don't see this email in my user list**
This message may appear if the user has already created a SENAR account independently but hasn't yet been linked to your Client account. To fix this issue, send the user the QR code from any of your collections and ask them to scan it in the SENAR app. {% hint style="success" %} If users are already logged in, they can open the scanner by tapping the QR Code button at the bottom of the **Library** screen. {% endhint %}
access to scan window
### **A user gets a "*****Invalid Token*****" message when trying to set their password** The password setup email sent by SENAR Studio is only valid for 48 hours. If the user waits too long before clicking the link, they’ll see an "Invalid Token" message when attempting to create their password. To fix this: * In [SENAR Studio](https://studio.senar.io/), go to the **Instructors** tab and open the user's record. * Click the three-dot menu in the upper right corner of the screen. * Click "**Reset password**"— the user will receive a new email with an updated link.
*** *** # Reset QR Codes On rare occasions, you may need to reset a user's QR codes.\ For example, if you notice that a QR code is generating an unusually high number of tokens, it could indicate that it was shared with unintended users. Here is how to proceed: 1. Go to the "**Users"** page. 2. Search for the relevant user and click the three-dot menu at the end of their row. 3. From the drop-down menu, select "**Reset codes",** then confirm in the popup window.
reset codes
{% hint style="danger" %} Please proceed with caution: Once the codes are reset, any previously downloaded or received QR codes will no longer be valid—regardless of the collection. Make sure to inform the user before proceeding. {% endhint %} After resetting, you can click "**Send codes"** (from the same drop-down menu) to email the user their new QR codes. # Getting started with the SENAR app In order to get you started with SENAR application and AR simulators, we have prepared an illustrated manual that you can easily share with your teams, export as a PDF and print. View the manual Discover [here](https://www.senar.io/list-of-collections) our collections of AR simulators. # Compatible Devices Your device requires ARCore (Android) or ARKit (iOS) to experience Augmented Reality with SENAR. Most of the devices manufactured after 2017 are compatible. * **Android:** ARCore is designed to work on a wide variety of qualified Android phones running Android 7.0 (Nougat) and later. A full list of all supported devices [is available on Google website.](https://developers.google.com/ar/devices) * **iOS** Compatible devices:
ios compatible devices
* **iOS devices that DON'T support ARKit:** * iPhone 6 Plus | iPhone 6 | iPhone 5s * iPad Air 2 | iPad mini 4th generation * iPod touch 6th generation # Installing AR simulators ## YOU ARE AN INSTRUCTOR ### **Setting up devices to be used in the classroom** 1. Make sure you have installed the latest version of the SENAR application on each device. 2. Make sure to exit the current training session in between students; otherwise, the Analytics reports won't be usable. It is key for each student to scan your collection QR code and fill out their own identification form. #### **To exit a training session:** **a.** Open the **Menu** by tapping the 'Profile' icon at the top left corner of the Library.
Exit a training session
**b.** Tap the "**Sign out**" button then confirm Exit in the popup window. 3. If you don't have it yet, download your collection QR code from the 'My profile' section in [SENAR Studio.](https://studio.senar.io/) **We recommend quitting and restarting SENAR once a day, as the application checks for simulator updates at each launch.** {% hint style="warning" %} Please note: quitting the application will **not** log you out or end the current student's session. However, it **will** interrupt any ongoing scenario if a simulator is in use. {% endhint %} *** ## YOU ARE A STUDENT Here is how to access a simulator with your own device. 1. Make sure you have installed the latest version of the SENAR application. 2. Launch the app then tap '**Enter as a Guest'** on the sign-in screen.
enter as a guest
3. Scan the collection QR code provided by your instructor.
scan a qr code
4. Fill in the identification form and tap '**Start'**.
5. Once you've been granted access by your instructor, you can install the simulators on your device. 6. Once installation is complete, just tap a simulator to launch it.
Student Library
# Positioning and repositioning a simulator in AR In AR, your device constantly recalculates the position of the simulator based on your movements in the real space. Its sensors must thus be able to recognize the environment at any given time. We recommend that you take the necessary time to properly anchor the simulator in your environment, as poor anchoring may compromise the user experience, resulting in drift, out-of-proportion objects, or a simulator that is sunk in the ground or floating in the air. {% embed url="\_" %} ## Dos and Don'ts In order to get the most of your device sensors, we recommend positioning the simulators in an environment with variations in colors, patterns, or shapes.

Image source: Microsoft

You should avoid positioning a simulator: * in a dark or very sunny place, * facing a window, * along a plain wall, with no recognizable elements, * facing people who are moving around, * on a monochromatic, shiny or reflective floor. In this last case, placing a colorful mat or a simple post-it note on the floor will help anchor the simulator and prevent drift. ## Positioning a simulator Move your device around, aiming it at recognizable items (furniture, window and door frames, decorative items, etc.). **Don't aim only at the floor.** Once the virtual grid has covered the flat surfaces around you, place the white circle anywhere you like **on the virtual grid** and tap the blue check button.
## Repositioning a simulator 1. Tap the 4-direction arrow at the top left corner of the screen.
2. Tap in the center of the arrows and drag with your finger to move the simulator sideways or or back and forth. 3. Tap and drag the white circular arrow to rotate the simulator. 4. Finally, tap the blue check button to confirm the new position.
{% hint style="success" %} In repositioning mode, some simulators can also be rescaled with a two-finger pinch. {% endhint %} # Moving around a simulator The best way to move around inside a simulator is to do it physically, simply **by walking**. This is possible because SENAR AR simulators are anchored in your environment exactly like a real object. When the simulator is very large - sometimes larger than the room in which it is used - it includes a navigation system that allows you to access any area in the scene. In this case, simply tap the floor or one of the arrows displayed on it to move in that direction.
# Hiding the real-world environment Large simulators include a "Background" mode that can be activated or deactivated at will. The background completely hides the user's real-world environment. This feature is particularly helpful in the following cases: * The simulator is larger than the room in which it is used. * The real environment is very crowded. * Other students practicing nearby are disturbing the user's visual field. Background can be activated or deactivated by tapping on the wall icon at the top of the screen:
# Avoiding blocking situations The help button is useful for unlocking students when they spend too much time looking for the correct answer. When activated, it displays a pulsing circle on the object or answer to be selected. When students give a correct answer after activating the help button they don't earn any points. Help can be activated by tapping on the lightbulb icon at the top of the screen:
{% hint style="info" %} Some simulators do not include a help button but automatically highlight the correct object/answer after a set period of time, or after one or two wrong answers. {% endhint %} # SENAR App: Troubleshooting Here are the solutions to the most frequently encountered problems within the application. ## **I can't find SENAR in Google Play** * Make sure the spell checker hasn't changed "Senar" to "Sonar". * If you are using a VPN, turn it off temporarily. * Make sure your device is compatible [by checking this page.](/using-the-senar-app-and-ar-simulators/compatible-devices) * If your device is managed by an MDM (Mobile Device Management) solution, contact your administrator. ## **I can't find the 'Scan a QR code' function** * **User signed out:** This function is available by tapping '**Enter as a Guest'** on the sign-in screen. * **User signed in:** Don't sign out! To scan a new QR code, just tap the QR Code icon at the bottom of the Library screen. If you can't see this button, update the application.
## **The simulator appears out of proportion or seems to be floating in the air** The simulator is no longer anchored to the ground due to a lack or excess of light, or due to reflections in the room or on the floor. Exit the scenario and restart it. If the problem persists, exit and restart the simulator. Read our tips on the best way to position / reposition a simulator [in this article.](/using-the-senar-app-and-ar-simulators/positioning-and-repositioning-a-simulator-in-ar) ## **The simulator doesn't appear after the camera view opens** Make sure that you have the latest version of the SENAR application installed. ## **The simulator is slow to appear** On newer mobiles, AR simulators usually appear in less than 10 seconds. On older devices, the experience may take several minutes to start. Simulators must first be decompressed - something older processors do much less efficiently. A percentage shows the progress of the decompression. ## **The simulator is about one inch high** Check that you have the latest version of iOS or Android. ## **Reality is not visible behind the simulator** This can happen on some phone models when the battery is less than 20% charged. Just recharge the battery and the AR experiences should return to normal. ## **My device crashes when I launch a simulator** This can happen on some phone models when the battery is less than 20% charged. Just recharge the battery and the AR experiences should return to normal. ## **My device is slow or freezing** This can happen on some phone models when the battery is less than 20% charged. Just recharge the battery and the AR experiences should return to normal. ## **I get a black screen when launching a simulator** Make sure that SENAR has permission to use the camera. Go to Settings -> Apps & notifications -> App info -> SENAR -> Permissions -> Camera; and select "Allow". ## **Pinch to zoom doesn't work in AR** SENAR AR simulators are designed to be as close as possible to what users would experience in real life. They are anchored in your environment exactly like a real object. Therefore, to examine an area more closely, you don't pinch it like you would an image; you have to get physically close to it. Interacting with virtual elements as if they were real and being able to move around them increases students' knowledge retention by activating their spatial and muscle memories. {% hint style="success" %} Want to know more about how AR works? Get our White Paper [here.](https://cdn.prod.website-files.com/616961eb7f7803d254c4cc02/61e6c1ef3bd357aa0d4ec8a9_White_Paper_Mobile_AR_SENAR.pdf) {% endhint %} ## **The simulator does not react when I try to interact with it** Make sure that the hand holding your device is not in contact with the screen at any point. ## **When trying to position a simulator, I get the message 'App update required'** We regularly improve our AR simulators. In order to provide you with the best possible experience, popup messages inform you when updated versions of the simulators are available and when an updated version of the application is required to get the most out of each AR experience. ## **A simulator is missing in the Library** Tap on the Refresh arrow at the top right corner of the Library screen (make sure your device has an active Internet connection). If the simulator is still missing, make sure the QR code scanned to start the training session is from the collection containing this simulator - each collection has its own QR code. If you are a student, ask your instructor for the correct QR code. ## **Nothing happens when I aim at the QR code** Sometimes the camera's focus may not be sharp, which hinders the recognition of the QR code. To reset the camera's focus, exit the SENAR app without signing out, then restart it. {% hint style="info" %} Before tapping the QR code icon, make sure that the camera view isn't obstructed (device placed flat on a table, finger in front of the camera...), so as not to hinder the autofocus. {% endhint %} ## **When scanning a QR code, I get the message 'Unknown QR Code'** Try scanning again, varying the distance between the QR code and your device. Scan in a well-lit environment. {% hint style="warning" %} It is normal for this message to appear if the instructor linked to the QR Code has been deactivated by their Manager. {% endhint %} ## **The simulator has an 'access denied' badge** Your access to this simulator has been denied. If you believe this is a mistake, please contact your instructor and invite them to consult [this page.](/using-senar-studio/how-to-resolve-access-denied-in-error) ## **The simulator has a 'simulator expired' badge** You’ve reached your monthly usage limit. You’ll be able to use the simulator again starting on the 1st of next month, within the 5-hour monthly limit ## **I have lost my password to access the SENAR platform.** You can request a password reset by clicking on "**Forgot password?**" [on this page.](https://studio.senar.io/Identity/Account/Login) # Fair Use Policy Our Fair Use policy aims to prevent unauthorized use of the simulators, such as installing a simulator on multiple shared devices using the same account. The rules below apply per user and per simulator: 1. A simulator can be used for 365 days after scanning a QR code. 2. A simulator can be used for a duration of 5 hours. 3. A user account can only be active on one device at a time. When one of these limitations is exceeded, users will get an alert on their device. # Setting up devices to use SENAR in the classroom 1. Make sure that each device is charged and running the latest version of the SENAR application. 2. Exit the current training session in between students. To do so: a. Open the **Menu** by tapping the Profile icon at the top left corner of the Library.
b. Tap the "**Sign out**" button then confirm Exit in the popup window. {% hint style="warning" %} It is key for each student to start their own session, by scanning your collection QR code and filling out their own identification form. Otherwise, the Analytics reports won't be usable. {% endhint %} 3. If you don't have it yet, download your collection QR code from the "My profile" section in [SENAR Studio.](https://studio.senar.io/) It will be ready to be scanned by your students. {% hint style="info" %} We recommend that you quit and restart SENAR every day as the application checks for simulator updates at each launch. Note that quitting the application does not interrupt the current training session. {% endhint %} # Using SENAR with a MDM software When tablets are used in the classroom, they can be locked manually or remotely with a MDM (Mobile Device Management) software so students can directly access the screen where they will scan the QR code. # Share an AR simulator in a video conference There are several options for sharing the screen of your mobile device in a video conference. Here is what we think is the easiest way, regardless of your configuration. ## Before your meeting 1. Install the **SENAR** application on your mobile or tablet device. Then download the simulators that you want to share. 2. On the same device, install the **mobile application** of the video conferencing software you usually use (Microsoft Teams, Zoom, or other). Log in. The idea is then to join the conference from your computer AND from the mobile application. {% hint style="warning" %} Make sure both devices are signed in to the same video conferencing account. {% endhint %} *** ## If you are using Microsoft Teams 1. Join the video conference from your computer. 2. Open Teams on your mobile phone or tablet. You'll see a message at the top of your mobile screen with an option to join the meeting. Tap **Join** to add your phone as a companion device.
Bannière dans Teams
3. Mute your companion device's mic and speaker to avoid causing an echo effect. 4. When you're ready to share the AR simulator: in the meeting controls at the bottom of your mobile screen, select **...** / **Share** / **Share screen**
5. Select **Start broadcast.** 6. Use the AR simulator normally. On your computer, you'll be able to see what you are sharing, just like everyone else in the meeting. 7. When you're finished, tap **Stop broadcast** on your mobile or simply hang up. Your computer will still be connected to the meeting. *** ## If you are using Zoom 1. Join the video conference from your computer. 2. Open Zoom on your mobile phone or tablet and join the conference (you will appear twice). 3. Mute your mobile device's mic and speaker to avoid causing an echo effect. 4. When you're ready to share the AR simulator: in the meeting controls at the bottom of your mobile screen, select **Share Content > Screen > Start Broadcast**
5. Use the AR simulator normally. On your computer, you'll be able to see what you are sharing, just like everyone else in the meeting. 6. When you're finished, tap **Stop share** on your mobile or simply hang up. Your computer will still be connected to the meeting. *** ## If you are using another video conference solution The procedure described above is similar for all video conferencing solutions. # Analytics module The SENAR web Analytics dashboard provides clear insight into identifying profiles and patterns within a group of users. This is particularly helpful when assessing a workforce and making sure the training programs in place are efficient enough to achieve the required levels of performance. To access our analytics module, head to [SENAR Studio](https://studio.senar.io/Analytics) and sign in with the same credentials you've used in the SENAR app. ## Dashboard Features * Use the filters at the top of the dashboard to display the data you are interested in. * Roll over a data set to get more details about it. For example, rolling over a step number on the x-axis will display the name of that step.
* To switch between chart and table view, click the icon at the top right corner of a container.
* In chart view, you can temporarily exclude a data set simply by clicking on its label in the legend (it will then be crossed out).
* In table view, you can sort data by clicking the column labels.
* The **Try** filter shows student progress as they practice. Three tries are displayed: the 1st one, the 2nd one and the last one. If students have run a scenario only once, their first and last tries are the same. * Data export: * To export table data, click the blue link next to the switch button. * To export all of the data from a scenario data, click the CSV Export button at the bottom right corner of the dashboard. To learn more about the analytics export, please consult [this article](/senar-analytics/understanding-the-analytics-export). ## About the calendar * After selecting an instructor and a simulator, the most recently recorded data for this set is automatically displayed. If the dashboard looks empty at first glance, check the Dropout report at the very bottom of the page. * You can only select a range from 1 to 7 days. * The disabled dates (in light gray) have no recorded data.
## About the Dropout report When students do not complete a scenario (ie. they miss the **End of Mission** popup or the **Accident** popup), it is considered a dropout. This graph shows the step at which users have dropped out.
Dropout report
This report is the only one that is not impacted by the **Try** filter. # Understanding the Analytics export Here is the meaning of the different columns that make up the Analytics CSV file: * **Student:** user who completed the form after scanning the QR code in the application * **Organization:** student's employer / school / university... (indicated by the student in the form) * **Simulator:** name of the simulator in the SENAR Library * **Scenario:** name of the scenario inside the simulator * **Step:** name of the step in a scenario * **Errors:** number of errors made by the student at this step * **Time (sec.):** time spent by the student at this step (in seconds) * **Score:** student's score at this step * **Max score:** maximum score that can be achieved at this step * **Dropouts:** number of times the student has dropped out at this step. When students do not complete a scenario (ie. they miss the "End of Mission" popup or the "Accident" popup), it is considered a dropout. * **Reference:** data from the profile of the instructor who has issued the QR code (cost center, region, etc.) * **Date**: Scenario launch date * **Try #:** Try order # Data missing from reports If you expect specific data to appear in the reports and it doesn't, there are a few things you should check. * Carefully check the values of each filter. For example, if the filter **2nd Try** is active, the dashboard will remain empty if the students have made only one try. Also pay close attention to the dates in the last filter. * If the dashboard looks empty at first glance, scroll and check the **Dropout** report at the very bottom of the page. * Make sure the student's device has been able to connect to the internet since the end of their session so the data could be sent to the SENAR server. # Understanding the Token Report The Token Report is only accessible to Managers. Here is the meaning of its different columns: * **Date:** date on which the QR Code was scanned into the SENAR app * **Student Last name / First name / Organization:** information entered by the student in the form after scanning the QR code * **Scanned collection:** collection attached to the QR code * **Instructor:** instructor or manager who issued the QR Code in SENAR Studio * **Scenarios launched:** number of times the student has launched a scenario (a simulator may contain several scenarios). # SENAR API Documentation This document provides technical information for developers working with Senar's data. It includes instructions for: * Authenticating access to the API * Adding users and assigning collections * Accessing user and activity data * Registering webhooks for real-time data notifications Each section includes endpoint examples and JSON responses to guide you. If you're new to Senar or integrating its data into your system, this guide will help you get started smoothly. *** ## 1. Authentication **Method:** POST You need to be authenticated to access Senar's data. Please contact support to obtain your login and password. **Endpoint** `https://studio.senar.io/api/auth/login` **Request Body** ```json5 { "username": "xxx@xxx.com", "password": "*********" } ``` **Response** ```json5 { "Token": "eedx..." } ``` \ The resulting token is used in the rest of the requests to authenticate you. It must be included in the `Authorization` header using the Bearer scheme. **Example:** ```makefile Authorization: Bearer ``` *** ## 2. Add User and Assign Collection **Method:** POST Use this endpoint to add a new user and assign them to a specific collection. **Endpoint** `https://studio.senar.io/integration/data/user_assign` **Request Body** ```json5 { "email": "new.user@example.com", "firstName": "New", "lastName": "User", "password": "Password8", "organization": "NewOrg Inc.", "collectionId": 42 } ``` **Response** ```json5 { "succeed": true, "email": "new.user@example.com", "collectionId": 42, "isNewUser": true } ``` **Notes:** * This endpoint requires authentication (see section 1). * The `collectionId` must reference a valid collection owned by the authenticated user. * To find a collection’s ID , open it in Senar Studio and copy the number at the end of the URL. Example: `https://studio.senar.io/Collections/Edit/42` \ → `42` * To assign multiple collections, repeat the request with a different `collectionId` each time. * The `password` field must comply with Senar’s format requirements: at least 6 characters, containing letters and at least one number. * User information can't be updated or deleted via the API — please use Senar Studio to make changes. *** ## 3. Get Users **Method:** GET Users register via a form available within the Senar application. This endpoint returns all users associated with the authenticated account. **Endpoint** `https://studio.senar.io/integration/data/users` **Sample Response** ```json5 [{ "id": "765fc7cf-312b-469d-8508-0e943a6447c7", "firstName": "Jon", "lastName": "Doe", "email": "jon.doe@my.mail", "language": "en", "accountName": "ACME", "countryName": "USA", "creationDate": "2022-09-07T06:25:23.9014976", "profile": "Instructor" }] ``` *** ## 4. Get Activity Data **Method:** GET An activity represents the data collected when a user completes a scenario. **Endpoint** `https://studio.senar.io/integration/data/activities` **Sample Response** ```json5 [{ "id": 80119, "collectionId": 41, "userId": "b68bfbd8-8f26-427b-a3c9-2d4cec36648b", "traineeId": "b5e3bbbc-0c22-417a-8087-6554afe26400", "firstName": "Natalia", "lastName": "Brown", "company": "Daria", "trainingDate": "2021-03-09T17:37:11.186836", "scenarioId": "S01", "scenarioName": "Scenario 1", "totalPoints": 2900, "totalSec": 622, "totalTries": 1, "simulatorId": 18, "tilts": 0, "totalMaxPoints": 3400, "abandons": 1, "collectionTitle": "Rigging", "simulatorTitle": "Lifting Hardware and Sling Inspection", "userFirstName": "Jon", "userLastName": "Doe", "userEmail": "jon.doe@my.mail", "userCostCenter": "East", "userAccountName": "ACME", "traineeEmail": "guest-b45@senar.io", "traineeProfile": "Guest" }] ``` *** ## 5. Webhook Registration **Method:** POST Use webhooks to receive real-time notifications when new users or activities are recorded. The response returns an ID you can use later to unsubscribe from the webhook if needed. **Endpoint** `https://studio.senar.io/integration/data/webhook_register` **Request Body** ```json5 { "hookUrl": "", "method": "activity", // or "user" "provider": "zapier" } ``` **Response** ```json5 { "id": "" } ``` *** # Create a 3D asset for GuidiGO: Guidelines (EN) ## 1. Modeling in 3D Software (3ds Max) 1. Each model you make in 3D software should have "healthy geometry", which means no overlapping, flipped polys, etc. You should always work with quads, separate polys on smoothing groups, and apply turbosmooth (but you should rasterize it before exporting FBX file for Unity). 2. Unwrapping is preferred when you have model with few materials on it. It is also necessary to unwrap model if you want to bake light on its diffuse texture, or create lightmap. 3. For materialization use standard mental ray material (not V Ray or Corona). Unity supports NORMAL maps, so you should convert your bump map into normal via Photoshop, using different plugins for conversion, which you can find on internet, for free. 4. Number of polys of a model that will hopefully work on Tango is less than a million. This depends on sizes of textures and complexity of a code and animation in project. 5. Always convert your model into editable mesh before exporting it as FBX. 6. Unity is in meters, so set your metrics in meters. ## 2. Animation in 3ds Max Export models from 3ds Max as FBX, in order to import it in Unity. You can import .max file also, but in that case, Unity makes conversion in FBX, and it can cause program to break and go down. In case of animations, FBX is a big downside, since it only exports a few kinds of animations from 3ds Max: * transition, rotation, scale * character animation (bones) * morpher Except morpher, you can't export animations of some other modifier (bend, FFD...). ## 3. Unity 1. **Shaders**: 1. If you are using scanned models with photorealistic or baked textures, use UNLIT shader in Unity. That shader doesn't receive or emit shadows, and looks great with good textures. Most important - there are no bugs with shadows during animation. 2. If you are painting textures by yourself, or you are not baking light, you should use STANDARD shader, since this shader depends on light from project and emits shadows in real time (if you have some animations in project, you should use this shader). 2. **Transparency**: There is a known bug in Unity: it goes crazy if you have two models, one behind another, that are semi-transparent. The program doesn't know what to render first, so you can notice some unrealistic overlapping. Very often you can fix it with code. 3. **Textures** should be as good as possible, regarding quality. 1k textures are minimum. Unity compresses texture bigger than 2k, so you should manually return them back to 4k, for example. 4. **Always create empty game object,** with pivot in 000 000 111, and put your model in its hierarchy. Sometimes, if you do not do that, your model may "fall down". # SENAR Aide en ligne ### Bienvenue dans l'aide en ligne de SENAR. # Démarrer avec SENAR Studio (Instructeur) Dans [SENAR Studio](https://studio.senar.io/), vous pouvez télécharger les QR Codes des collections auxquelles vous avez accès et suivre les performances de vos étudiants avec les simulateurs AR. Voici comment démarrer en 3 étapes simples : {% stepper %} {% step %} ## ÉTAPE 1 : Obtenir votre identifiant Vous pouvez recevoir vos informations de connexion à SENAR Studio de deux manières différentes : * Soit votre responsable vous a envoyé un email avec vos login et mot de passe. * Soit vous avez reçu un email automatique de SENAR Studio, vous invitant à créer votre mot de passe. Si vous n'avez reçu ni l'un ni l'autre, veuillez contacter votre responsable. {% hint style="warning" %} Si vous obtenez un message "Invalid Token" à la création de votre mot de passe, demandez à votre manager de [réinitialiser votre mot de passe](/senar-aide-en-ligne/utiliser-senar-studio/senar-studio-en-cas-de-probleme#invalid-token). {% endhint %} {% endstep %} {% step %} ## ÉTAPE 2 : Obtenir vos QR Codes Les QR codes vous donnent accès aux simulateurs AR dans l'application mobile SENAR et vous permettent de partager cet accès très facilement avec vos étudiants. Selon le choix de votre responsable, ces QR codes ont pu vous être déjà envoyés par e-mail automatique. Dans le cas contraire, vous pouvez retrouver vos QR Codes à tout moment. Voici comment : 1. Connectez vous à SENAR Studio et rendez-vous à la section "**Mon Profil**". 2. Cliquez sur le lien "**EXPORTER LE QR CODE**" d'une collection pour obtenir un QR code partageable avec vos étudiants.
{% endstep %} {% step %} ## ÉTAPE 3 : Démarrer une formation AR Partager une collection avec vos étudiants est très simple. Envoyez-leur votre QR code par email, ou affichez-le sur votre écran si vous animez une formation à distance. Vous pouvez par exemple le coller dans votre présentation Powerpoint. Pour démarrer une formation AR, les étudiants lancent [l'application SENAR](https://go.senar.io/app) sur leur propre mobile (cas d'une formation à distance) ou sur la tablette que vous leur avez fournie (formation sur site). Ensuite : 1. Sur l'écran d'accueil SENAR, ils tapent "**Accès Invité**" et scannent votre code. 2. Ils renseignent leur nom et organisation. 3. Un email automatique vous informe qu'un étudiant est en attente de votre approbation. 4. En un clic, vous pouvez approuver ou refuser chaque accès, depuis la section "**Approbations**" de SENAR Studio.
5. Dès qu'il est approuvé par vos soins, l'étudiant peut installer les simulateurs. 6. La formation AR peut commencer ! {% endstep %} {% endstepper %} # Démarrer avec SENAR Studio (Manager) Dans [SENAR Studio](https://studio.senar.io/), vous pouvez créer des collections de simulateurs AR, les partager avec vos instructeurs et consulter les rapports d'activité des étudiants. Voici comment démarrer en 3 étapes simples : {% stepper %} {% step %} ## ÉTAPE 1 : Ajouter des instructeurs 1. Rendez-vous à la section Utilisateurs et cliquez sur "**AJOUT D'UTILISATEUR(S)".** Sélectionnez **"Ajouter un utilisateur".**
SENAR Studio
2. Complétez un profil pour chacun de vos instructeurs. Ils recevront un email automatique les invitant à créer leur mot de passe SENAR.\ \ Note : le champ "**Reference**" est facultatif. Il vous offre une clé de tri supplémentaire dans les rapports. Vous pouvez y saisir un code région, le numéro d'un centre de coûts, etc. - en fonction de votre organisation. {% hint style="success" %} Si vous souhaitez ajouter un grand nombre d'instructeurs, il est plus pratique de les charger en masse. Consultez [cet article](/senar-aide-en-ligne/utiliser-senar-studio/importer-des-instructeurs-en-masse) pour en savoir plus sur ce processus. {% endhint %} {% endstep %} {% step %} ## ÉTAPE 2: Ajouter des collections 1. Rendez-vous à la section Collections et cliquez sur "**AJOUTER UNE COLLECTION"** 2. Donnez un nom à la collection. 3. Laissez cochée la case "**Sur approbation**" si vous souhaitez que vos instructeurs valident l'accès des étudiants ([en savoir plus](/senar-aide-en-ligne/utiliser-senar-studio/collections-accessibles-sur-approbation)). 4. Ajoutez des simulateurs en les faisant glisser vers la colonne "Simulateurs inclus", ou en cliquant sur leur **'+'** vert.
5. Cochez la case devant le nom de chaque instructeur avec lequel vous souhaitez partager la collection. 6. Cliquez sur **Enregistrer** au bas de l'écran. {% endstep %} {% step %} ## ÉTAPE 3 : Partager les QR codes avec vos instructeurs Chaque instructeur peut télécharger ses QR Codes dans SENAR Studio, à la section "**Mon profil**".
Vous pouvez également leur faire parvenir ces codes vous-même. Depuis la section "**Instructeurs"** de SENAR Studio, vous pouvez en effet : * Déclencher l'envoi d'un e-mail automatique incluant les QR codes de l'instructeur. * ou Télécharger les QR codes de l'instructeur pour les lui envoyer par vous-même. Ces deux options sont disponibles en cliquant sur le bouton à 3 points situé à la fin de chaque ligne "utilisateur" :
{% endstep %} {% step %} ÉTAPE 4 : Ajouter des Managers (facultatif)\ --------------------------------------------------------------------------------------------------------------------------- Si vous souhaitez que des collègues vous aident à gérer votre organisation, vous avez la possibilité d'ajouter des Managers. Pour cela, suivez l'étape 1 en sélectionnant simplement "**Manager**" dans le champ "Profil" de l'utilisateur. {% endstep %} {% endstepper %} # Utiliser et générer des QR codes Accorder à un instructeur l'accès à l'une de vos collections génère automatiquement un code QR, spécifique à cet instructeur et à cette collection. *** ## Comment utiliser un QR Code? Pour démarrer une session de formation, les étudiants lancent l'application SENAR sur leur propre appareil (formation à distance), ou sur l'appareil que vous leur avez fourni (formation présentielle). 1. L'instructeur partage le code QR de sa collection avec les étudiants. 2. Sur l'écran d'accueil, ces derniers tapent sur "**Accès Invité**" et scannent le QR code. 3. Ils renseignent leur nom et celui de leur organisation. 4. Dans le cadre d'une formation à distance, l'instructeur approuve ou refuse chaque accès depuis la page "**Approbations**" de SENAR Studio. 5. Dès qu'un étudiant est approuvé par l'instructeur, il peut installer les simulateurs. {% hint style="info" %} NB: pour connaître l'utilité de l'étape n°4 (Approbations), consultez [cet article.](/senar-aide-en-ligne/utiliser-senar-studio/collections-accessibles-sur-approbation) {% endhint %} *** ## Où trouver les QR Codes ? Chaque instructeur peut télécharger ses QR Codes depuis la section "**Mon profil**" de SENAR Studio.
Vous pouvez également communiquer vous-mêmes leurs QR codes à vos instructeurs. Depuis la section "**Instructeurs**" de SENAR Studio, vous pouvez, au choix : * Déclencher l'envoi d'un e-mail automatique contenant les QR codes sous forme de fichiers image. * Télécharger les QR codes de l'instructeur, pour les lui partager quand et comme vous le souhaitez. Ces deux options sont disponibles en cliquant sur le bouton à 3 points situé à la fin de chaque ligne "utilisateur" :
{% hint style="success" %} Si vous créez des instructeurs en masse et leur donnez accès à vos collections en même temps, chacun reçoit automatiquement ses QR codes par e-mail. {% endhint %} # Comment accorder un accès refusé par erreur {% hint style="warning" %} Vous êtes étudiant et vous pensez que l'accès à un simulateur vous a été refusé par erreur ? Contactez votre instructeur et invitez-le à consulter cette page. {% endhint %} Si l'accès à une collection de simulateurs a été refusé par erreur, l'instructeur peut facilement rectifier l'autorisation du stagiaire. Pour cela : 1. Accédez à la page **Approbations** dans SENAR Studio. 2. Sélectionnez "**Refusé**" dans le filtre de statut. 3. Dans la liste des utilisateurs refusés, cliquez la coche verte sur la ligne de l'étudiant concerné.
# Ajouter une collection Une collection est un ensemble de simulateurs que vous regroupez afin de pouvoir les partager aisément avec un groupe d'instructeurs. *** ## Ajouter une collection 1. Rendez-vous à la section Collections et cliquez sur "**AJOUTER UNE COLLECTION"** 2. Donnez un nom à la collection. 3. Laissez cochée la case "**Sur approbation**" si vous souhaitez que vos instructeurs valident l'accès des étudiants ([en savoir plus](/senar-aide-en-ligne/utiliser-senar-studio/collections-accessibles-sur-approbation)). 4. Ajoutez des simulateurs en les faisant glisser vers la colonne "Simulateurs inclus", ou en cliquant sur leur **'+'** vert.
5. Cochez la case devant le nom de chaque instructeur avec lequel vous souhaitez partager la collection. 6. Cliquez sur **Enregistrer** au bas de l'écran. {% hint style="info" %} Dès que vous partagez une collection avec un instructeur, le QR code correspondant apparaît dans sa section "Mon profil". {% endhint %} *** ## Partager une collection en masse Si vous souhaitez partager une collection avec un grand nombre d'instructeurs, la fonction d'import en masse vous simplifiera grandement la tâche. 1. Créez votre liste d'instructeurs au format .csv ([voir comment procéder ici)](/senar-aide-en-ligne/utiliser-senar-studio/creer-une-liste-dinstructeurs-pour-import-en-masse). 2. Faites glisser ce fichier .csv dans la zone de gauche, sous la liste des simulateurs.
3. Cliquez sur **Enregistrer** au bas de l'écran. 4. Après l'import, tous les **nouveaux** instructeurs de votre liste reçoivent par email automatique le QR code leur permettant d'accéder à la collection. {% hint style="danger" %} Si les instructeurs étaient déjà présents dans votre base SENAR, il n'y a pas d'envoi du QR code par email. Veuillez consulter [cet article](/senar-aide-en-ligne/utiliser-senar-studio/utiliser-et-generer-des-qr-codes) pour savoir où trouver / comment partager des QR codes. {% endhint %} # Collections accessibles sur approbation Pour éviter toute utilisation abusive de vos QR codes, vous pouvez ajouter une étape d'approbation avant que les stagiaires n'accèdent à une collection. Cela peut s'avérer particulièrement utile dans le cadre de formations à distance. *** ## Ajouter une étape d'approbation Pour activer cette fonction, il vous suffit de cocher la case "**Sur approbation**" à droite du nom de la collection.
Sur la page des **Collections**, celles dont l'accès requiert l'approbation d'un instructeur sont identifiables par un petit cadenas, en haut à droite.
## Processus d'approbation Lorsqu'un étudiant complète le formulaire d'identification après avoir scanné le QR code d'une collection sur approbation : * Un message s'affiche sur son mobile, l'informant que son accès est en attente d'approbation par l'instructeur. * L'instructeur reçoit un email l'invitant à approuver ou refuser l'accès de l'étudiant.
* Dans SENAR Studio - section "Étudiants" - l'instructeur autorise ou refuse l'accès en cliquant sur la coche verte ou la croix rouge.
* Dès que l'instructeur autorise l'accès, un message "Accès accordé" apparaît sur le mobile de l'étudiant qui peut alors installer les simulateurs de la collection. * Si l'instructeur refuse l'accès, l'utilisateur en attente reçoit un message "Accès refusé" et ne peut pas accéder aux simulateurs. Dans ce cas, aucun token n'est débité de votre compte. {% hint style="info" %} Vous ne pouvez pas supprimer l'accès à un étudiant après le lui avoir accordé. En revanche, si vous avez refusé un accès par erreur, vous pouvez rectifier votre choix[ (en savoir plus).](/senar-aide-en-ligne/utiliser-senar-studio/comment-accorder-un-acces-refuse-par-erreur) {% endhint %} # Assigner des collections à vos instructeurs ## Assigner une/des collection(s) à 1 instructeur 1. À la section **Utilisateurs**, cliquez sur le nom de l'instructeur. 2. Sous ses Informations personnelles, cliquez sur le bouton '**Assigner ou désassigner une collection'**. 3. Dans le popup, sélectionnez les collections en les faisant glisser vers la colonne de gauche ou en cliquant sur leur **'+'** vert.
4. Cliquez '**Enregistrer**' en bas du popup. ## Assigner une collection à plusieurs instructeurs 1. À la section **Collections,** cliquez sur le nom de la collection à assigner. 2. Repérez la table '**Utilisateurs autorisés**'. Elle se trouve soit à droite, soit en bas de la page, selon la largeur de votre écran.
3. Cochez la case devant le nom de chaque instructeur auquel vous souhaitez assigner la collection. 4. N'oubliez pas de cliquer sur '**Enregistrer'** tout en bas de l'écran. {% hint style="success" %} Lorsque vous créez une collection, elle vous est assignée par défaut. Vous disposez donc automatiquement de son QR code à la section "Mon profil". {% endhint %} # Importer des instructeurs en masse Si vous souhaitez ajouter un grand nombre d'instructeurs, la fonction de création en masse vous simplifie grandement la tâche. Dans ce cas, nous vous recommandons de commencer par créer vos collections. Vous pourrez ainsi les assigner à vos instructeurs en même temps que vous les importez. *** ## ÉTAPE 1 : Créer vos collections 1. Rendez-vous à la section **Collections** et cliquez sur "**AJOUTER UNE COLLECTION"** 2. Donnez un nom à la collection. 3. Laissez cochée la case "**Sur approbation**" si vous souhaitez que vos instructeurs valident l'accès des étudiants ([en savoir plus](/senar-aide-en-ligne/utiliser-senar-studio/collections-accessibles-sur-approbation)). 4. Ajoutez des simulateurs en les faisant glisser vers la colonne "Simulateurs inclus", ou en cliquant sur leur **'+'** vert.
5. Cliquez sur **Enregistrer** au bas de l'écran. ## ÉTAPE 2 : Importer vos instructeurs 1. Créez votre liste d'instructeurs au format .csv. [Voici comment procéder.](/senar-aide-en-ligne/utiliser-senar-studio/creer-une-liste-dinstructeurs-pour-import-en-masse) 2. Rendez-vous à la section "Instructeurs" et cliquez sur "**AJOUT D'INSTRUCTEUR(S)".** Sélectionnez **Ajouter en masse.** 3. Faites glisser votre fichier .csv dans la zone supérieure du popup.
4. Sélectionnez la ou les collection(s) que vous souhaitez partager avec vos instructeurs. Pour cela, faites-les glisser dans la colonne "Collections assignées", ou cliquez sur leur **'+'** vert. 5. Cliquez sur **Enregistrer** au bas du popup. {% hint style="success" %} Si votre liste comporte de **nouveaux** instructeurs, ils recevront automatiquement un email contenant le(s) QR code(s) leur permettant d'accéder à votre/vos collection(s). {% endhint %} # Créer une liste d'instructeurs (pour import en masse) L'import en masse vous permet de créer rapidement votre base d'instructeurs dans SENAR Studio, ou encore d'assigner / dés-assigner des collections à un grand nombre d'instructeurs en une seule opération. Voici comment préparer le fichier de vos instructeurs. *** ## Cas 1 : les instructeurs n'existent pas encore dans SENAR Studio Téléchargez [ce template .csv.](https://www.dropbox.com/s/zci5z08l3igaqgx/SENAR_instructor_list.csv?dl=0) {% hint style="danger" %} Important : si vous utilisez ce fichier .cvs dans Excel, vous ne devez pas l'ouvrir, mais **l'importer**. Pour cela, rendez-vous dans l'onglet "Données" d'Excel. Ce template utilise la virgule en guise de séparateur. {% endhint %} * Les champs **Email, First Name,** **Last Name** et **Country** doivent être complétés pour chaque instructeur. * **Country :** utilisez exclusivement des noms de pays présents dans [cette liste.](https://www.dropbox.com/s/uz6n8olbsgx4cds/SENAR_Country_List.pdf?dl=0) Ne les modifiez pas, ne les traduisez pas. * Les champs **Reference** et **Password** peuvent être laissés vides ; mais même dans ce cas, ne les supprimez pas du fichier. * **Reference :** ce champ facultatif vous offre une clé de tri supplémentaire dans les rapports. Vous pouvez y saisir un code région, le numéro d'un centre de coûts, etc. - en fonction de votre organisation. * **Password :** * Si vous laissez le champ vide, chaque instructeur recevra un email automatique l'invitant à créer son mot de passe. * Si vous attribuez des mots de passe à vos instructeurs, n'oubliez pas de les leur communiquer en parallèle. * Un mot de passe SENAR doit comporter au moins 6 caractères, contenir des lettres et au moins 1 chiffre. {% hint style="danger" %} Vous ne devez ni supprimer, ni renommer, ni traduire les noms des champs. Votre fichier d'import doit impérativement être enregistré au format .csv et doit utiliser **la virgule** en guise de séparateur. {% endhint %} *** ## Cas 2: les instructeurs existent déjà dans SENAR Studio 1. Rendez-vous à la section **Instructeurs**. 2. Servez-vous des filtres pour afficher les instructeurs que vous souhaitez exporter. 3. Cochez la case en haut de la 1ère colonne pour sélectionner l'ensemble des instructeurs visibles. Vous pouvez si nécessaire affiner votre sélection en décochant les personnes à exclure de l'export. 4. Cliquez sur la flèche en haut de la 1ère colonne et choisissez **Exporter**.
5. Consultez le Cas 1, ci-dessus, pour savoir comment utiliser le fichier .csv obtenu. \ Important : si vous utilisez ce fichier .cvs dans Excel, vous ne devez pas l'ouvrir, mais **l'importer** via l'onglet Données. {% hint style="danger" %} Le champ "Password" du .csv exporté sera vide et doit être conservé tel quel. Ne supprimez pas ce champ ou le réimport ne fonctionnera pas. {% endhint %} # Modifier des instructeurs en masse SENAR vous facilite la gestion des instructeurs en vous permettant de les modifier en masse. ## 1. Exportez le fichier des instructeurs 1. À la section "**Instructeurs**" affichez les instructeurs à modifier à l'aide des filtres et /ou du champ de recherche. 2. Cochez la case en haut de la première colonne pour sélectionner tous les instructeurs de la liste. 3. Cliquez sur la flèche adjacente puis sélectionnez "Exporter". ## 2. Éditez le fichier 1. Vous pouvez modifier le fichier CSV dans un tableur ou dans un éditeur de texte - sans supprimer, renommer ou traduire de colonnes. {% hint style="info" %} L'édition en masse n'autorise pas à modifier le mot de passe d'utilisateurs existants. Dans le CSV exporté depuis SENAR Studio, le champ "Password" sera donc vide et doit être conservé tel quel. Ne supprimez pas ce champ ou le réimport ne fonctionnera pas. {% endhint %} 2. Le pays de chaque instructeur doit être strictement identique au nom figurant [dans cette liste.](https://docs.google.com/spreadsheets/d/1ulDPPoVdeJ8KTLwWFdH8mIXzedrVQ9cBJU_xbHlTX-s/edit#gid=1254887630) 3. Une fois édité, enregistrez votre fichier au format CSV, avec valeurs séparées **par des virgules**. {% hint style="warning" %} Si votre tableur impose un point-virgule comme séparateur lors de l'export CSV, ouvrez votre export dans un éditeur de texte et remplacez tous les points-virgules par des virgules à l'aide de la fonction "Rechercher / Remplacer tout". \ Puis sauvez à nouveau le fichier au format CSV. {% endhint %} ## 3. Ré-importez le fichier 1. À la section "Instructeurs", cliquez sur le bouton "Ajout d'instructeurs" puis choisissez "Ajouter en masse". 2. En haut du popup, chargez le fichier CSV de vos instructeurs. 3. Pour leur assigner de nouvelles collections, sélectionnez-les juste en dessous. Si vos instructeurs ont déjà accès à toutes les collections dont ils ont besoin, ne modifiez pas cette zone. 4. Cliquez sur **Enregistrer** et attendez le message de confirmation, sans quitter la page. La modification d'instructeurs en masse peut prendre jusqu'à 2 minutes. {% hint style="danger" %} Quand vous assignez des collections lors d’une **édition** en masse, les QR codes ne sont pas envoyés automatiquement par e-mail, contrairement à une **création** en masse. \ Veillez donc à ce que les instructeurs les téléchargent depuis SENAR Studio, [ou consultez cet article.](/senar-aide-en-ligne/utiliser-senar-studio/utiliser-et-generer-des-qr-codes) {% endhint %} # Tokens & QR Codes Pour lancer une session de formation qui produira des rapports d'évaluation, les étudiants doivent scanner le QR code d'un utilisateur SENAR actif (Instructeur ou Manager). Ce code permet d'accéder à tous les simulateurs d'une collection. Lorsqu'un QR code est scanné au sein de l'application SENAR : * L'étudiant peut installer les simulateurs de la collection sur son mobile (à condition que l'instructeur accepte de lui accorder l'accès). * L'étudiant peut ensuite utiliser chaque simulateur pendant 5 heures sur une période de 12 mois. * Un token est débité de la collection sur le compte du client. Les utilisateurs (Instructeurs et Managers) peuvent télécharger leurs QR Codes - un par collection à la section "**Mon Profil**" de SENAR Studio.
Le détail des tokens consommés peut être suivi à la section "**Tokens**". *** *** # En savoir plus sur les Tokens L'application SENAR permet aux étudiants de s'entraîner et interagir avec des simulateurs AR. Elle nécessite un "token" (jeton) valide, activé par le téléchargement d'un simulateur. ### Quand le token est-il débité ? **1er cas : la collection est accessible sans approbation** 1. L'étudiant scanne le QR code fourni par l'instructeur et complète le formulaire d'identification. 2. L'écran affiche la liste des simulateurs de la collection, chacun avec un bouton "Télécharger". ➜ un token est débité lorsque l'étudiant télécharge un simulateur. **2ème cas :** **la collection est accessible sur approbation** 1. L'étudiant scanne le QR code fourni par l'instructeur et complète le formulaire d'identification. 2. L'instructeur est invité à se rendre sur sa console SENAR Studio pour autoriser ou refuser l'accès de l'étudiant. 3. Si l'accès est accordé, l'écran de l'étudiant affiche la liste des simulateurs de la collection, chacun avec un bouton "Télécharger". ➜ un token est débité lorsque l'étudiant télécharge un simulateur. ### Comment suivre l'utilisation des tokens ? Instructeurs et Managers peuvent suivre la consommation de tokens à la section "Tokens" de [SENAR Studio.](https://studio.senar.io/Tokens) Ce rapport affiche le total des tokens utilisés et la liste de tous les étudiants ayant téléchargé des simulateurs. Il peut être exporté au format .csv. ### Combien de temps un simulateur peut-il être utilisé ? Chaque simulateur peut être utilisé pendant 5 heures sur une période de 12 mois. Grâce à cette politique de *Fair Use*, l'étudiant dispose de tout le temps nécessaire pour pratiquer et acquérir les compétences requises. {% hint style="info" %} Les 5 heures d'utilisation sont décomptées uniquement lorsque le simulateur est en cours d'utilisation effective (simulateur lancé, avec la vue caméra active). {% endhint %} ### L'étudiant peut-il modifier son nom en cours de session ? Une fois le formulaire d'identification complété, l'étudiant n'y a plus accès. Il ne peut donc pas modifier son nom ou son organisation. ➜ 1 token = 1 téléchargement /étudiant. ### Que se passe-t-il lorsque l'étudiant quitte l'application SENAR ? Lorsque l'étudiant quitte l'application SENAR, sa session reste active. Lorsqu'il relance l'application il n'a donc pas à re-scanner le code QR. {% hint style="info" %} Une "session active" ne signifie pas qu'un simulateur est en cours d'utilisation, ni même que l'application SENAR est lancée. Une session reste active tant que le token est valide et que l'étudiant est identifié dans l'application. {% endhint %} ### Que se passe-t-il si l'étudiant quitte la session ? Lorsqu'il tape sur le bouton "Quitter", l'étudiant est clairement averti que cette action mettra fin à sa session.
Lorsqu'une session est terminée, li faut scanner un QR code pour en démarrer une nouvelle. ### Que se passe-t-il si l'étudiant supprime, puis réinstalle l'application SENAR ? Si l'étudiant réinstalle l'application SENAR après l'avoir supprimée de son mobile, il devra à nouveau scanner le QR code, ce qui démarrera une nouvelle session. Il sera considéré comme un homonyme, même s'il saisit le même nom et la même organisation qu'à sa première session. Les données de sa première session sont sauvegardées dans le cloud et restent disponibles dans les rapports Analytics. # SENAR Studio: En cas de problème Voici les solutions aux problèmes les plus fréquemment rencontrés dans le Studio. ### **Une alerte "*****Email already exists*****" s'affiche alors que l'email ne figure pas dans la liste de mes utilisateurs**
Lors de la création d'un utilisateur, ce message peut apparaître si l'utilisateur s'est lui-même inscrit dans l'application SENAR mais n'a pas encore été lié à votre compte client. Pour résoudre ce problème, envoyez à l'utilisateur le QR code de l'une de vos collections et demandez-lui de le scanner dans l'application SENAR. {% hint style="success" %} Si l'utilisateur est déjà connecté à l'application mobile, il peut accéder à la fenêtre de scan en tapant sur le bouton QR code, au bas de l'écran "Bibliothèque" (**Library**). {% endhint %}
access to scan window
### **Un utilisateur voit s'afficher le message "*****Invalid token*****" lorsqu'il tente de créer son mot de passe** L'email envoyé par Senar Studio pour définir un mot de passe a une durée de vie limitée à 48h. Si l'utilisateur tarde trop pour cliquer sur le lien, il obtient un message "Invalid Token" en créant son mot de passe. Pour résoudre ce problème : * Lancez [SENAR Studio](https://studio.senar.io/) et rendez-vous sur l'onglet "Instructeurs". * Ouvrez la fiche de l'utilisateur concerné, puis cliquez sur les 3 petits points dans le coin droit. * Cliquez sur "Réinitialiser mot de passe" : l'instructeur recevra alors un email avec un lien mis à jour.
*** # Réinitialiser des QR Codes Dans de rares occasions, vous pourriez avoir besoin de réinitialiser les QR codes d'un utilisateur. Par exemple, si vous remarquez qu'un QR code génère un nombre anormalement élevé de tokens, cela pourrait indiquer qu'il a été partagé avec des utilisateurs indésirables. Voici comment procéder : 1. Rendez-vous sur la page "**Utilisateurs**". 2. Recherchez l'utilisateur concerné et cliquez sur le menu trois points à la fin de sa ligne. 3. Dans le menu déroulant, sélectionnez "**Réinitialiser les codes**", puis confirmez.
reset codes
{% hint style="danger" %} Procédez avec précaution : une fois les codes réinitialisés, tous les QR codes précédemment téléchargés ou reçus **ne seront plus valides**, quelle que soit la collection. Pensez à prévenir l’utilisateur concerné. {% endhint %} \ Après la réinitialisation, vous pouvez cliquer sur "**Envoyer les codes**" (dans le même menu déroulant) pour envoyer les nouveaux QR codes par e-mail. # Démarrer avec l'application SENAR Pour vous aider à démarrer avec l'application SENAR et les simulateurs AR, nous avons préparé un manuel illustré. Vous pouvez le partager avec vos équipes, l'exporter au format PDF et l'imprimer si besoin. Voir le manuel Découvrez [nos collections de simulateurs AR.](https://fr.senar.io/list-of-collections) # Appareils compatibles avec SENAR Pour pouvoir utiliser l'application SENAR, votre mobile ou tablette nécessite ARCore (Android) ou ARKit (iOS). La plupart des appareils sortis depuis 2017 sont compatibles. * **Android :** la liste complète des appareils pris en charge est disponible dans le tableau de [cette page d'assistance Google.](https://developers.google.com/ar/devices) * **iOS** : les appareils compatibles sont les suivants :
ios compatible devices
* **iOS -** appareils **NON compatibles** : * iPhone 6 Plus - iPhone 6 - iPhone 5s * iPad Air 2 - iPad mini 4th generation * iPod touch 6th generation # Installer des simulateurs AR Après avoir scanné le QR code fourni par son instructeur, l'étudiant accède à la collection de simulateurs associés à ce code. Au fil de son utilisation, il génère des données individuelles qui vont alimenter les rapports d'évaluation. Ces derniers sont accessibles en ligne via le module SENAR Analytics. *** ## VOUS ÊTES INSTRUCTEUR Voici comment installer une ou plusieurs tablettes à utiliser en classe. 1. Assurez-vous d'avoir installé la version la plus récente de l'application SENAR sur chaque tablette. 2. Entre deux étudiants, vous devez vous assurer de quitter la session de formation en cours. Faute de quoi, les rapports Analytics seront inexploitables. Il est essentiel que chaque étudiant scanne votre code QR et complète le formulaire d'identification.
**Pour quitter une session de formation :** a. Ouvrez le **menu** (icône 'Profil" en haut à gauche de la Bibliothèque).
Exit a training session
b. Tapez sur le bouton "**Déconnexion**", puis confirmez dans le popup. 3. Si vous ne l'avez pas déjà, téléchargez votre QR code depuis la section "Mon profil" de [SENAR Studio.](https://studio.senar.io/)
{% hint style="warning" %} Nous vous recommandons de quitter et redémarrer SENAR quotidiennement car l'application vérifie les mises à jour de simulateurs à chaque lancement. \ Le fait de quitter l'application n'interrompra pas la session du stagiaire (mais interrompra tout scénario en cours). {% endhint %} *** ## VOUS ÊTES ÉTUDIANT Voici comment accéder à un simulateur sur votre propre mobile ou tablette. 1. Assurez-vous d'avoir installé la version la plus récente de l'application SENAR. 2. Lancez l'application puis tapez "**Accès invité**" sur l'écran d'identification.
enter as a guest
3. Scannez le QR code fourni par votre instructeur.
scan a qr code
4. Identifiez-vous dans le formulaire et tapez sur "**Démarrer**".
5. Dès que votre accès est validé par l'instructeur, un badge vous informe que vous pouvez installer les simulateurs sur votre mobile / tablette. 6. Une fois l'installation terminée, tapez sur un simulateur pour le lancer.
Student Library
{% hint style="info" %} Pour positionner correctement un simulateur en AR, [consultez cet article.](/senar-aide-en-ligne/utiliser-lapplication-senar-et-les-simulateurs-ar/positionner-repositionner-un-simulateur-en-ar) {% endhint %} # Positionner / Repositionner un simulateur en AR En AR, votre mobile recalcule constamment la position du simulateur en fonction de vos mouvements dans l'espace. Ses capteurs doivent donc être capables de reconnaître l'environnement à tout moment. Nous vous recommandons de prendre le temps de correctement ancrer le simulateur dans votre environnement car un mauvais ancrage peut altérer l'expérience utilisateur : objets hors de proportion ou partant à la dérive, simulateur enfoncé dans le sol ou flottant dans les airs. {% embed url="" %} ## Bonnes et mauvaises pratiques Afin de tirer le meilleur parti des capteurs de votre mobile, nous vous conseillons de placer le simulateur dans un environnement présentant des variations de couleurs, de motifs ou de formes.

Image : Microsoft

Évitez de placer le simulateur : * dans un endroit sombre ou très ensoleillé, * face à une fenêtre, * le long d'un mur uni, sans aucun élément reconnaissable, * face à des personnes en mouvement, * sur un sol uni, brillant ou avec des reflets. Dans ce dernier cas, la pose d'un tapis coloré ou d'un simple post-it sur le sol permettra d'ancrer le simulateur et d'éviter qu'il parte à la dérive. ## Positionner un simulateur Déplacez votre mobile en visant des objets reconnaissables (meubles, cadres de fenêtres et de portes, objets de décoration, etc.). **Ne visez pas uniquement le sol.** Une fois que la grille virtuelle a bien recouvert les surfaces planes autour de vous, placez le cercle blanc où vous voulez **sur la grille,** et tapez sur la coche bleue.
## Repositionner un simulateur 1. Tapez sur la flèche multi-directionnelle en haut à gauche de l'écran.
2. Tapez au centre de la flèche circulaire et faites glisser votre doigt pour déplacer le simulateur latéralement ou d'avant en arrière. 3. Tapez sur la flèche elle-même pour faire pivoter le simulateur. 4. Enfin, tapez sur la coche bleue pour confirmer la nouvelle position.
{% hint style="success" %} En mode repositionnement, certains simulateurs peuvent également être redimensionnés en écartant deux doigts placés sur l'écran. {% endhint %} # Se déplacer dans un simulateur La meilleure façon de se déplacer à l'intérieur d'un simulateur consiste tout simplement **à marcher.** Les simulateurs SENAR sont en effet ancrés dans votre environnement exactement comme des objets réels. Lorsque le simulateur couvre une surface importante - parfois supérieure à celle de la pièce où il est utilisé - il inclut un système de navigation permettant d'accéder à n'importe quelle zone de la scène. Dans ce cas, il suffit de taper le sol ou l'une des flèches qui s'y affichent pour se déplacer dans cette direction.
# Masquer l'environnement réel Les simulateurs de grande taille incluent un mode "Décor" qui peut être activé ou désactivé à volonté. Affiché en arrière-plan du simulateur, le décor masque complètement l'environnement réel de l'utilisateur. Cette fonctionnalité est particulièrement utile dans les cas suivants : * Le simulateur est plus grand que la pièce dans laquelle il est utilisé. * L'environnement réel est très encombré. * D'autres étudiants pratiquant à proximité perturbent le champ visuel de l'utilisateur. Le décor peut être activé ou désactivé en tapant sur l'icône "murs", en haut de l'écran.
# Éviter les situations de blocage Le bouton d'aide permet de débloquer un étudiant qui passerait trop de temps à chercher la bonne réponse. Son activation affiche un cercle lumineux sur l'objet ou la réponse à sélectionner. Lorsque l'étudiant donne une réponse correcte après avoir activé le bouton d'aide, il ne gagne aucun point. L'aide peut être activée en tapant sur l'icône de l'ampoule en haut de l'écran :
{% hint style="info" %} Certains simulateurs ne comportent pas de bouton d'aide. Ils mettent automatiquement en évidence le bon objet ou la bonne réponse, soit après une certaine période, soit après une ou deux mauvaises réponses. {% endhint %} # En cas de problème... Voici les solutions aux problèmes les plus fréquemment rencontrés avec l'application. ## **Je ne vois pas SENAR dans Google Play** * Assurez-vous que le correcteur d'orthographe n'a pas transformé "Senar" en "Sonar". * Si vous utilisez un VPN, désactivez-le temporairement. * Assurez-vous que votre mobile est compatible, [en consultant cet article.](/senar-aide-en-ligne/utiliser-lapplication-senar-et-les-simulateurs-ar/appareils-compatibles-avec-senar) * Si votre mobile est administré par une solution MDM (Mobile Device Management), contactez l'administrateur de votre domaine. ## **Je ne trouve pas la fonction "Scanner un QR code"** * Si vous n'êtes pas identifié : cette fonction est accessible depuis l'écran de connexion, en tapant sur "**Accès Invité**". * Si vous êtes identifié : tapez sur le bouton avec l'icône QR Code en bas de l'écran "Bibliothèque" (si vous ne voyez pas ce bouton, mettez l'application à jour).
## Le simulateur a une taille disproportionnée ou semble flotter dans les airs Le simulateur n'est plus ancré au sol à cause d'un manque ou d'un excès de lumière, ou en raison de reflets dans la pièce ou au sol. Quittez le scénario et relancez-le. Si le problème persiste, quittez et relancez le simulateur. Lisez nos conseils sur la meilleure façon de positionner / repositionner un simulateur [dans cet article.](/senar-aide-en-ligne/utiliser-lapplication-senar-et-les-simulateurs-ar/positionner-repositionner-un-simulateur-en-ar) ## **Le simulateur n'apparaît pas dans la vue caméra** Assurez-vous d'avoir bien installé la version la plus récente de l'application SENAR. ## L'écran reste noir après avoir lancé le simulateur Assurez-vous que SENAR a l'autorisation d'utiliser l'appareil photo. Si vous avez refusé cette autorisation au premier lancement de l'application, vous pouvez modifier ce réglage dans les **Paramètres** de votre mobile : Applications et notifications -> Info sur les applications -> SENAR -> Autorisations -> Appareil photo. ## **Le simulateur est lent à apparaître** Sur un mobile récent, un simulateur apparaît généralement en moins de 10 secondes. Sur les mobiles plus anciens, l'expérience peut mettre plusieurs minutes avant de démarrer. Le simulateur doit d'abord être décompressé, tâche que les anciens processeurs réalisent avec moins d'efficacité. Un pourcentage vous indique la progression de la décompression. ## **Le simulateur mesure moins d'un centimètre de haut** Vérifiez que vous disposez de la dernière version d'iOS ou d'Android. ## **La réalité n'est pas visible derrière le simulateur** Cela peut arriver avec certains modèles de mobile lorsque la batterie est chargée à moins de 20 %. Rechargez la batterie et les expériences AR reviendront à la normale. ## **Mon mobile plante quand je lance un simulateur** Cela peut arriver avec certains modèles de mobile - et certains simulateurs plus gourmands en ressources - lorsque la batterie est chargée à moins de 20 %. Rechargez la batterie et les expériences AR reviendront à la normale. ## **Mon mobile est lent ou l'écran "freeze"** Cela peut arriver avec certains modèles de mobile lorsque la batterie est chargée à moins de 20 %. Rechargez la batterie et les expériences AR reviendront à la normale. ## **Le zoom "à deux-doigts" ne fonctionne pas en AR** Nous concevons nos simulateurs AR pour qu'ils soient aussi proches que possible de ce que l'utilisateur pourrait expérimenter dans la réalité. Chaque simulateur est ancré dans l'environnement exactement comme un objet réel. Aussi, pour examiner un détail de plus près, vous ne zoomez pas comme vous le feriez avec une image ; vous devez vous rapprocher physiquement. Interagir avec des éléments virtuels comme s'ils étaient réels et pouvoir se déplacer tout autour augmente l'acquisition de connaissances en activant la mémoire spatiale et musculaire. {% hint style="success" %} Pour en savoir plus sur le fonctionnement de l'AR, [téléchargez notre livre blanc.](https://download.senar.io/wp/) {% endhint %} ## **Le simulateur ne réagit pas lorsque j'essaye d'interagir avec lui** Assurez-vous que la main qui tient votre mobile n'est en aucun point en contact avec l'écran.
## **En essayant de positionner un simulateur, j'obtiens le message "Mise à jour de l'application requise"** Nous améliorons régulièrement nos simulateurs. Afin de vous offrir la meilleure expérience possible, des messages vous informent lorsque des mises à jour de simulateurs sont disponibles et lorsqu'une mise à jour de l'application est nécessaire pour un fonctionnement optimal de chaque simulateur. ## **Un simulateur manque dans la Bibliothèque** Tapez sur la flèche circulaire en haut à droite de la Bibliothèque pour rafraîchir la liste des simulateurs (assurez-vous d'avoir une connection Internet active). Si le simulateur n'apparaît toujours pas, assurez-vous que le QR code scanné pour démarrer la session de formation est bien celui de la collection contenant ce simulateur - chaque collection a son propre QR code. Si vous êtes étudiant, contactez votre instructeur pour obtenir le bon QR code. ## **Rien ne se passe quand je vise le QR code** Il arrive que la mise au point de la caméra ne soit pas nette, ce qui gêne la reconnaissance du QR code. Si cela se produit, quittez l'application SENAR sans vous déconnecter, puis redémarrez-la. Cela devrait réinitialiser la mise au point de la caméra. {% hint style="info" %} Avant de taper sur l'icône QR Code pour ouvrir la vue caméra, assurez-vous que celle-ci n'est pas obstruée (mobile posé à plat sur une table, doigt devant la caméra...), afin de ne pas entraver la mise au point. {% endhint %} ## **Après avoir scanné le QR code, le message "QR Code Inconnu" s'affiche** Réessayez de scanner en variant la distance entre le QR code et votre appareil. Scannez dans un environnement bien éclairé. {% hint style="info" %} Il est normal que ce message s'affiche si l'instructeur rattaché au QR Code a été "Désactivé" par le Manager. {% endhint %} ## **Le simulateur porte un badge "accès refusé"** L'accès au simulateur vous a été refusé par l'instructeur. Si vous pensez qu'il s'agit d'une erreur, signalez-vous à l'instructeur et invitez-le à consulter [cette page.](/senar-aide-en-ligne/utiliser-senar-studio/comment-accorder-un-acces-refuse-par-erreur) ## **Le simulateur porte un badge "simulateur expiré"** Vous avez atteint la limite d'utilisation mensuelle. Vous pourrez à nouveau utiliser le simulateur à partir du 1er du mois prochain - dans la limite de 5 heures au total. ## **J'ai perdu mon mot de passe pour accéder à la plateforme SENAR** Vous pouvez demander une réinitialisation de votre mot de passe en cliquant sur "Mot de passe oublié" [sur cette page.](https://studio.senar.io/Identity/Account/Login) # Politique de "Fair Use" Notre politique de "Fair Use" vise à prévenir l'utilisation irrégulière des simulateurs, comme l'installation d'un simulateur sur plusieurs appareils partageant le même compte. Les règles ci-dessous s'appliquent par utilisateur et par simulateur : 1. Un simulateur peut être utilisé sur une période de 365 jours après scan du code QR. 2. Un simulateur peut être utilisé pendant 5 heures. 3. Un compte utilisateur ne peut être actif que sur un seul appareil à la fois. Lorsque l'une de ces limites est atteinte, un message s'affiche sur l'écran de l'utilisateur. # Utiliser SENAR en salle de classe 1. Assurez-vous que chaque tablette est chargée et que la dernière version de l'application SENAR y est bien installée. 2. La session de formation doit systématiquement être redémarrée entre deux étudiants. Pour cela, tapez sur l'icône en haut à gauche de l'écran, **puis confirmez** dans le popup. 1. Ouvrez le menu (icône 'Profil' en haut à gauche de la Bibliothèque).
b. Tapez sur le bouton "**Déconnexion**", puis confirmez dans le popup. {% hint style="warning" %} Il est essentiel que chaque étudiant commence sa propre session, en scannant le code QR de votre collection puis en complétant son propre formulaire d'identification. Sinon, les rapports Analytics ne seront pas utilisables. {% endhint %} 3. Si vous ne l'avez pas déjà fait, téléchargez le QR code de votre collection depuis la section "Mon profil" de [SENAR Studio.](https://studio.senar.io/) Il sera ainsi prêt à être scanné par vos étudiants. {% hint style="info" %} Nous vous recommandons de quitter et de redémarrer SENAR une fois par jour car l'application vérifie l'existence de mises à jour de simulateurs à chaque lancement. Quitter l'application n'interrompt pas la session de formation en cours. {% endhint %} # Utiliser SENAR avec un MDM Lorsque les tablettes sont utilisées en classe, elles peuvent être verrouillées manuellement ou à distance avec un logiciel MDM (Mobile Device Management). Les étudiants accèdent ainsi directement à l'écran où ils vont scanner le QR code. # Partager un simulateur en visioconférence Il existe plusieurs options pour partager l'écran de votre mobile lors d'une visioconférence. Voici selon nous la méthode la plus simple, quelle que soit votre configuration. *** ## Avant votre réunion 1. Installez l'application **SENAR** sur votre mobile ou tablette. Puis téléchargez les simulateurs que vous souhaitez partager. 2. Sur le même appareil, installez l'**application mobile** du logiciel de visioconférence que vous utilisez habituellement (Microsoft Teams, Zoom, ou autre). Identifiez-vous. L'idée consiste ensuite à rejoindre la conférence depuis votre ordinateur ET depuis l'application mobile. {% hint style="warning" %} Veillez à ce que vos deux appareils soient connectés au même compte de visioconférence. {% endhint %} *** ## Si vous utilisez Microsoft Teams 1. Rejoignez la visioconférence depuis votre ordinateur. 2. Lancez Teams sur votre mobile ou tablette : un message apparaît en haut de l’écran. Tapez sur **Join** (Rejoindre) pour ajouter votre mobile en tant qu’appareil compagnon.
Bannière dans Teams
3. Désactivez le micro et le haut-parleur de votre appareil compagnon pour éviter l'effet Larsen (écho). 4. Lorsque vous êtes prêt(e) à partager le simulateur : en bas de l’écran de votre mobile, sélectionnez **...** / **Share** (Partager) / **Share screen** (Partager l'écran) / **Start broadcast** (Démarrer la présentation).
5. Utilisez le simulateur normalement. Votre démonstration s'affiche sur votre ordinateur et sur celui des autres participants. 6. Lorsque vous avez terminé, tapez sur **Stop broadcast** (Arrêter la présentation) ou raccrochez votre mobile. Votre ordinateur reste connecté à la réunion. *** ## Si vous utilisez Zoom 1. Rejoignez la visioconférence depuis votre ordinateur. 2. Lancez Zoom sur votre mobile ou tablette et rejoignez la conférence (vous apparaîtrez en double). 3. Désactivez le micro et le haut-parleur de votre appareil compagnon pour éviter l'effet Larsen (écho). 4. Lorsque vous êtes prêt(e) à partager le simulateur : dans les contrôles de la réunion, en bas de l'écran de votre mobile, tapez sur **Share Content** (Partager) **> Screen** (Ecran). Puis sur **Start broadcast** (Commencer maintenant).
5. Utilisez le simulateur normalement. Votre démonstration s'affiche sur votre ordinateur et sur celui des autres participants. 6. Lorsque vous avez terminé, tapez sur **Stop share** (Arrêter le partage) ou raccrochez votre mobile. Votre ordinateur reste connecté à la réunion. *** ## Si vous utilisez une autre solution La procédure décrite ci-dessus est similaire pour l'ensemble des solutions de visioconférence. # Module Analytics Le tableau de bord web de SENAR Analytics permet d'identifier clairement des profils et des modèles au sein d'un groupe d'utilisateurs. Cela s'avère particulièrement utile pour évaluer une main-d'œuvre et s'assurer que les programmes de formation mis en place permettent d'atteindre les niveaux de performance requis. Pour accéder au module Analytics module, rendez-vous sur [SENAR Studio](https://studio.senar.io/Analytics) et connectez-vous avec les mêmes identifiants que ceux utilisés dans l'application SENAR. ## Fonctionnalités du tableau de bord * Utilisez les filtres en haut du tableau de bord pour afficher les données qui vous intéressent. * Passez au-dessus d'une série de données pour voir plus de détails. Par exemple, passer sur un numéro d'étape sur l'axe des x affiche le nom de l'étape.
* Pour passer de la vue graphique à la vue tableau, cliquez sur l'icône située en haut à droite du container.
* En vue graphique, vous pouvez exclure temporairement une série de données en cliquant simplement sur son étiquette dans la légende (la série sera alors barrée).
* En vue tableau, vous pouvez trier les données en cliquant sur les étiquettes des colonnes.
* Le fitre **Essai** montre les progrès des étudiants au fil de leur pratique. Trois essais sont affichés : le premier, le deuxième et le dernier. Si l'étudiant n'a exécuté un scénario qu'une seule fois, son premier et son dernier essai sont les mêmes. * Export de données : * Pour exporter les données d'un tableau, cliquez sur le lien bleu TÉLÉCHARGER en haut de ce tableau. * Pour exporter toutes les données d'un scénario, cliquez sur le bouton Export CSV en bas à droite du tableau de bord. Pour en savoir plus sur l'export Analytics, veuillez [consulter cet article.](/senar-aide-en-ligne/senar-analytics/comprendre-lexport-analytics) ## Utilisation du calendrier * Après avoir sélectionné un instructeur et un simulateur, le tableau de bord affiche automatiquement les données les plus récentes enregistrées. S'il paraît vide au premier abord, vérifiez bien le rapport des Abandons tout en bas de la page. * Vous pouvez sélectionner une plage de 1 à 7 jours. * Les dates désactivées (en gris clair) n'ont pas de données enregistrées.
## Rapport des Abandons * Le fait de ne pas terminer un scénario (c'est-à-dire de quitter l'expérience avant le popup "Fin de mission" ou le popup "Accident") est considéré comme un abandon. Ce rapport montre à quelle(s) étape(s) les utilisateurs ont abandonné.
Dropout report
* Ce rapport est le seul à ne pas être impacté par le filtre **Essai.** # Comprendre l'export Analytics Voici la signification des différentes colonnes qui composent le fichier CSV d'Analytics : * **Apprenant :** utilisateur qui a complété le formulaire après avoir scanné le QR code au sein de l'application * **Organisation :** employeur / école / université... de l'apprenant (saisi par ses soins dans le formulaire) * **Simulateur :** nom du simulateur dans la Bibliothèque SENAR * **Scénario :** nom du scénario dans le simulateur * **Étape :** nom de l'étape dans le scénario * **Erreurs :** nombre d'erreurs de l'apprenant à cette étape * **Durée (sec.) :** durée passée par l'apprenant à cette étape (en secondes) * **Score :** score de l'apprenant à cette étape * **Score max :** score maximum pouvant être atteint à cette étape * **Abandons :** nombre de fois où l'apprenant a abandonné à cette étape. Le fait de ne pas terminer un scénario (c'est-à-dire de quitter l'expérience avant le popup "Fin de mission" ou le popup "Accident") est considéré comme un abandon. * **Référence :** donnée provenant du profil de l'instructeur qui a émis le QR code (par ex. centre de coût, région, etc.) * **Date** : date à laquelle a été lancé le scénario * **Essai # :** numéro de l'essai
# En cas de données manquantes dans les rapports Si vous attendiez des données spécifiques dans les rapports et qu'elles n'y figurent pas, veuillez vérifier les points suivants. * Vérifiez soigneusement les valeurs de chaque filtre. Par exemple, si le filtre **2ème essai** est actif, le rapport restera vide si les étudiants n'ont fait qu'un seul essai. Faites également très attention aux dates du dernier filtre. * Si le tableau de bord semble vide à première vue, vérifiez bien le rapport **Abandons** tout en bas de la page. * Assurez-vous que le mobile de l'étudiant a pu se connecter à Internet depuis la fin de sa session afin que les données aient pu être envoyées au serveur SENAR. # Comprendre le rapport des Tokens Le rapport des Tokens est accessible aux Managers. Voici la signification de ses différentes colonnes : * **Date :** date à laquelle le code QR a été scanné dans l'application SENAR. * **Nom / Prénom / Organisation de l'étudiant :** informations saisies par l'étudiant dans le formulaire après avoir scanné le QR code. * **Collection scannée :** collection attachée au QR code * **Instructeur :** instructeur ou manager qui a émis le QR code dans SENAR Studio. * **Scénarios lancés :** nombre de fois où l'étudiant a lancé un scénario (un simulateur peut contenir plusieurs scénarios). # Documentation de l'API SENAR Cette documentation fournit des informations techniques à destination des développeurs travaillant avec les données de Senar. Elle comprend des instructions pour : * Authentifier l’accès à l’API * Ajouter des utilisateurs et leur attribuer des collections * Accéder aux données utilisateurs et d’activité * Enregistrer des webhooks pour recevoir des notifications en temps réel. Chaque section inclut des exemples de *endpoints* et de réponses JSON, pour vous aider à bien démarrer. *** ## 1. Authentification **Méthode :** POST Vous devez être authentifié pour accéder aux données Senar. Pour obtenir un login et un mot de passe, veuillez contacter le support. **Endpoint** `https://studio.senar.io/api/auth/login` **Requête** ```json5 { "username": "xxx@xxx.com", "password": "*********" } ``` **Réponse** ```json5 { "Token": "eedx..." } ``` Le token obtenu sera utilisé dans les requêtes pour vous authentifier. Ajoutez-le à l'en-tête `Authorization` en utilisant le schéma Bearer. **Exemple** `Authorization: Bearer ` *** ## 2. Ajouter un utilisateur et lui attribuer une collection **Méthode :** POST Utilisez ce *endpoint* pour ajouter un nouvel utilisateur et lui assigner une collection spécifique. **Endpoint** `https://studio.senar.io/integration/data/user_assign` **Requête** ```json5 { "email": "new.user@example.com", "firstName": "New", "lastName": "User", "password": "Password8", "organization": "NewOrg Inc.", "collectionId": 42 } ``` **Réponse** 
{
  "succeed": true,
  "email": "new.user@example.com",
  "collectionId": 42,
  "isNewUser": true
}
**Remarques :** * Ce *endpoint* nécessite une authentification (voir section 1). * `CollectionId` doit faire référence à une collection valide, dont l’utilisateur authentifié doit être propriétaire. * Pour trouver l’ID d’une collection, ouvrez-la dans Senar Studio et copiez le nombre à la fin de l’URL. Exemple : `https://studio.senar.io/Collections/Edit/42`\ → `42` * Pour assigner plusieurs collections, répétez la requête en changeant le champ `collectionId`. * Le champ `password` doit respecter les critères de sécurité imposés par Senar : minimum 6 caractères, composé de lettres et d'au moins un chiffre. * L’API ne permet pas de modifier ou supprimer les informations d’un utilisateur ; pour cela, utilisez Senar Studio. *** ## 3. Récupérer les utilisateurs **Méthode :** GET Les utilisateurs s'inscrivent via un formulaire disponible dans l'application Senar. Cet endpoint retourne tous les utilisateurs associés au compte authentifié. **Endpoint** `https://studio.senar.io/integration/data/users` **Réponse** ```json [{ "id": "765fc7cf-312b-469d-8508-0e943a6447c7", "firstName": "Jon", "lastName": "Doe", "email": "jon.doe@my.mail", "language": "en", "accountName": "ACME", "countryName": "USA", "creationDate": "2022-09-07T06:25:23.9014976", "profile": "Instructor" }] ``` *** ## 4. Récupérer les données d’activité **Méthode :** GET Une activité représente les données collectées lorsqu'un utilisateur termine un scénario. **Endpoint** `https://studio.senar.io/integration/data/activities` **Réponse** ```json [{ "id": 80119, "collectionId": 41, "userId": "b68bfbd8-8f26-427b-a3c9-2d4cec36648b", "traineeId": "b5e3bbbc-0c22-417a-8087-6554afe26400", "firstName": "Natalia", "lastName": "Brown", "company": "Daria", "trainingDate": "2021-03-09T17:37:11.186836", "scenarioId": "S01", "scenarioName": "Scenario 1", "totalPoints": 2900, "totalSec": 622, "totalTries": 1, "simulatorId": 18, "tilts": 0, "totalMaxPoints": 3400, "abandons": 1, "collectionTitle": "Rigging", "simulatorTitle": "Lifting Hardware and Sling Inspection", "userFirstName": "Jon", "userLastName": "Doe", "userEmail": "jon.doe@my.mail", "userCostCenter": "East", "userAccountName": "ACME", "traineeEmail": "guest-b45@senar.io", "traineeProfile": "Guest" }] ``` *** ## 5. Enregistrer un webhook **Méthode :** POST Utilisez les webhooks pour recevoir des notifications en temps réel lorsqu’un nouvel utilisateur ou une nouvelle activité est enregistré(e). La réponse renvoie un identifiant que vous pouvez plus tard utiliser pour vous désabonner si besoin. **Endpoint** `https://studio.senar.io/integration/data/webhook_register` **Requête** ```json5 { "hookUrl": "", "method": "activity", // or "user" "provider": "zapier" } ``` **Réponse** ```json5 { "id": "" } ``` # Créer un objet 3D pour GuidiGO : Guidelines (EN) ## 1. Modélisation dans un logiciel 3D (3ds Max) 1. Chaque modèle que vous créez doit avoir une **géométrie propre** : pas de polygones superposés, inversés, etc.\ Travaillez toujours avec des **quads**, séparez les polygones par *smoothing groups*, et appliquez un **Turbosmooth** (à **collapser** avant l’export en FBX pour Unity). 2. L’**unwrap UV** est recommandé lorsqu’un modèle utilise plusieurs matériaux. Il est également **indispensable** si vous souhaitez ***bake***** la lumière** sur une texture diffuse ou créer une **lightmap.** 3. Pour la création de matériaux, utilisez des **matériaux standard Mental Ray** (évitez V-Ray ou Corona).\ Unity prend en charge les **normal maps** : convertissez donc vos **bump maps** en normal maps à l’aide de Photoshop et d’un plugin de conversion (disponible gratuitement en ligne). 4. Le nombre de polygones recommandé pour une scène destinée à fonctionner sur un appareil type Tango est **inférieur à un million**, mais cela dépend aussi de la taille des textures, de la complexité du code et des animations. 5. Avant l’export en FBX, **collapsez le stack** et convertissez votre modèle en **Editable Mesh**. 6. Unity utilise le **mètre** comme unité. Pensez donc à **configurer vos unités** en mètres dans 3ds Max. ## 2. Animation dans 3ds Max Les modèles doivent être **exportés en FBX** pour être importés dans Unity.\ Il est possible d’importer directement un fichier `.max` , mais Unity le convertira automatiquement en FBX, ce qui peut provoquer des **bugs** ou des **crashs** du programme. Le format FBX présente plusieurs **limitations** en matière d’animation, car il ne prend en charge que certains types d’animations provenant de 3ds Max : * Translation, rotation, échelle * Animation de squelette (bones) * Morpher À l’exception du **Morpher**, les animations issues d’autres modificateurs (comme **Bend**, **FFD**, etc.) **ne sont pas exportées** en FBX. ## 3. Unity 1. **Shaders**: 1. Si vous utilisez des modèles scannés avec des textures photoréalistes ou baked, utilisez le shader UNLIT dans Unity.\ Ce shader ne reçoit ni n’émet d’ombres, et donne un très bon rendu si les textures sont bien travaillées.\ Avantage clé : il évite les bugs d'ombres pendant les animations. 2. Si vous peignez vos textures manuellement ou si vous n’effectuez pas de baking de lumière, utilisez le shader STANDARD. Ce shader dépend de l’éclairage de la scène et gère les ombres en temps réel, ce qui le rend adapté aux projets avec animations. 2. **Transparence** : Unity présente un bug connu lorsque deux objets semi-transparents se superposent : le moteur gère mal l'ordre de rendu, provoquant des chevauchements visuellement incohérents.\ Ce problème peut souvent être corrigé par du code ou un ajustement de shader. 3. **La qualité des textures** doit être aussi élevée que possible. 1k est un minimum. Unity compresse automatiquement les textures supérieures à 2K.\ Si vous souhaitez conserver du 4K, pensez à rétablir manuellement cette résolution dans les paramètres d’import de la texture. 4. **Organisation de la hiérarchie :** Créez toujours un game object vide, avec un pivot positionné en 000 000 111, et placez votre modèle dans sa hiérarchie.\ Si vous ne le faites pas, le modèle risque de se retrouver mal positionné ou désancré dans la scène.