Skip to content

robofit/arcor2_areditor

Repository files navigation

ARCOR2 AREditor

ARCOR stands for Augmented Reality Collaborative Robot. It is a system for simplified programming of collaborative robots based on augmented reality developed by Robo@FIT.

This repository contains the main user interface, Unity-based client application for ARCore-supported tablets: AREditor. The backend part of the solution is available here.

Development is supported by Test-it-off: Robotic offline product testing project (Ministry of Industry and Trade of the Czech Republic).

Main menu with overview of scene, projects and execution packages. AREditor being used to program Dobot M1. VR mode.

Installation

With each release, we are building Android apk which can be simply installed on a supported device, which is any ARCore compatible tablet. We use primarily Samsung devices (S6, S7). There are also Linux/Windows binaries, but mainly for testing and debugging purposes (no AR).

Usage

Instructions for use can be found on the wiki.

Development

These are instructions for developers.

  • clone this repo

  • get submodules:

    git submodule update --init
  • create symlink of the submodules to the Assets folder:

    Windows:

    cd scripts
    .\link_submodules.bat

    Linux:

    cd scripts
    ./link_submodules.sh
  • download multimedia files from LFS:

    git lfs install
    git lfs pull
  • get third party assets from Unity AssetStore (extract and copy into Assets/Submodules):

    • Lunar Mobile Console (optional)
    • Loading screen animation
    • Modern UI Pack
    • UI Graph
    • Joystick Pack
    • Native Camera for Android & iOS (only if you want to build Android version)
    • Trilib 2 - manually delete folder Trilib/Plugins/NewtonSoft.Json/ otherwise, there will be most likely conflicts
    • Simple Collada
      • requires to apply patch (/scripts/ColladaImporter.patch and /scripts/StringExtensions.patch) on script ColladaImporter.cs and OrbCreationExtensions/StringExtensions.cs
      • SimpleCollada asset must be moved to Assets/Submodule folder in order to patch script works
      • on Windows, you can download UnxUtils and use batch file in /scripts/patch_simple_collada_asset.bat (if UnxUtils extracted to "C:\Program Files") or use this command:
      path_to_UnxUtils\UnxUtils\usr\local\wbin\patch.exe ..\arcor2_AREditor\Assets\Submodules\SimpleCollada\ColladaImporter.cs -i ColladaImporter.patch
      path_to_UnxUtils\UnxUtils\usr\local\wbin\patch.exe ..\arcor2_AREditor\Assets\Submodules\SimpleCollada\OrbCreationExtensions\StringExtensions.cs -i StringExtensions.patch
      • on Linux, you can use bash script in /scripts/patch_simple_collada_asset.sh
  • (Optional) - Get Google Cloud API Key to enable Cloud Anchors (follow step 7 in Codelabs ARCore Extensions tutorial)