Skip to content

An interaction concept & visual scripting-based authoring tool for procedural Mobile (Android & iOS) Augmented Reality trainings.

License

Notifications You must be signed in to change notification settings

metageno/TrainAR

 
 

Repository files navigation

TrainAR

GitHub license Maintenance Made with Unity Documentation

TrainAR is a holistic threefold combination of an interaction concept, didactic framework and authoring tool for Augmented Reality (AR) trainings on handheld Android and iOS devices (Blattgerste et al. 2021). It is completely open source, free and offers non-programmers and programmers without AR-specific expertise aiding in the creation of interactive, engaging, procedural Augmented Reality trainings. This repository contains the technical components of the interaction concept and authoring tool of TrainAR in form of a custom Unity 2022.3 (LTS) Editor Extension. It can be used with the Unity Windows, macOS (Silicon), macOS (Intel), or Linux Editor and deploy to Android and iOS devices. The authoring tool already offers features like the onboarding animations, tracking solutions, assembly placements, evaluated interaction concepts, layered feedback modalities and training assessments of TrainAR out of the box. This allows authors of AR trainings to focus on the content of the training instead of technical challenges. Authors can simply import 3D models into the tool, convert them to TrainAR objects and reference them in a visual-scripting stateflow (that is inspired by work-process-analyses) to create a procedural flow of instructions, user actions and feedback.

Example TrainAR Authoring on a laptop with deployment to an android phone

The idea behind TrainAR is simple: Realistic deployments of head-mounted AR devices still remain a challenge today because of high costs, missing relevant training, and novelty of interactions that require in-depth onboarding. In contrast, smartphone-based AR would be realistically scalable today, while still retaining many of the learning benefits. At least in theory. While possible, most mobile AR learning applications focus on visualisation instead of interactions today, severely limiting their application scope. In line with recent findings that, in terms of training outcome, tangible interactions are not significantly increasing retention or transfer of knowledge compared to purely virtual interaction approaches (Knierim et al. 2020), the idea of TrainAR is a holistic and scalable solution for procedural task training using Augmented Reality on handheld AR devices. Hereby, the idea is not to replace practical trainings but use TrainAR scenarios for concept and procedure understanding in preparation for or retention training after the practical training sessions. In line with Gagne 1984, it is envisioned as a novel type of multimedia source to train intellectual skills and cognitive strategies but does not train associated motor skills.

TrainAR Training Scenarios

Several TrainAR trainings were already developed by us, researchers from partner universities, and students using preliminary versions of the TrainAR authoring tool. They span across the contexts of medical education, nursing education, chemical engineering, science educational, manual assembly, and everyday work tasks. A list of publications for some of the trainings can be found below.

Example TrainAR scenarios

Documentation & Getting Started

If you want to try out already developed TrainAR trainings, here is a list of available Apps that utilize TrainAR:

  • Training scenario "Preparation of a tocolytic injection" in the Heb@AR App [Youtube, Android & iOS]
  • Training scenario "Pelvis Termini" in the Heb@AR App [Youtube, Android & iOS]

If you want to get started with creating, deploying and playing with your own TrainAR training, check out our Getting Started Guide. You can either use the example scenario that ships with this repository, or create a very simple example scene from the guide in less than half an hour. Beyond the Getting Started Guide, a full documentation is available detailing the available visual scripting nodes, how to create TrainAR objects and how to use nodes to implement action flows. Additionally, a complete documentation of all API references is included.

A key idea behind TrainAR is the retention of the full Unity capabilities while offering a higher-level abstraction for non-programmers to get started with AR authoring. Therefore, it can also be utilized without the visual scripting and without the TrainAR authoring overlay, using the standard Unity Editor Overlay and C# programming. This could for example be interesting, if you want to implement non-procedural educational games or you are only interested in the components of the interaction concept and not so much the authoring tool itself. For this, check out the Advanced Options documentation.

Contributing to this Project

TrainAR is envisioned as a participatory project, continously improving and expanding it's quality and scope. Feel free to contribute to its source code, documentation or conceptual/didactic ideas through Issues or Discussions. You are using TrainAR for an Augmented Reality training or learning game? Show us what you created! You are using TrainAR to explore Augmented Reality trainings in a new context as your scientific research? Feel free to add your publications to our list of publications below so others can use it as a reference.

Publication List

TrainAR Framework:

TrainAR Trainings:

Funding

The research resulting in the open source TrainAR project was partially supported by the grant 16DHB3021, project "HebAR - AR-Based-Training-Technology", by the German Ministry for Education and Research (BMBF) [1] and partially by the Mixed Reality Lab at University of Applied Sciences Emden/Leer. TrainAR is the abstraction and generalization of interaction concepts, feedback mechanisms, and didactic ideas developed during Project Heb@AR [1, 2]. Here, procedural Augmented Reality emergency trainings were explored in the academic midwifery education context. During the development it became clear that those concepts could also be generalized towards other training contexts and thus we share TrainAR here.

Acknowledgement

TrainAR is freely accessible for commercial and non-commercial use under the MIT license and does not require acknowledgement in your TrainAR training or App itself. If you use TrainAR in the scientific context though, please acknowledge it by citing our publications on the interaction concept, didactic considerations and the authoring tool itself:

@article{Blattgerste2023TrainAR,
AUTHOR = {Blattgerste, Jonas and Behrends, Jan and Pfeiffer, Thies},
TITLE = {TrainAR: An Open-Source Visual Scripting-Based Authoring Tool for Procedural Mobile Augmented Reality Trainings},
JOURNAL = {Information},
VOLUME = {14},
YEAR = {2023},
NUMBER = {4},
ARTICLE-NUMBER = {219},
URL = {https://www.mdpi.com/2078-2489/14/4/219},
ISSN = {2078-2489},
DOI = {10.3390/info14040219}
}

About

An interaction concept & visual scripting-based authoring tool for procedural Mobile (Android & iOS) Augmented Reality trainings.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 78.6%
  • ShaderLab 9.0%
  • Mathematica 5.4%
  • GLSL 5.2%
  • HLSL 1.8%