SRVS-C: Source Code for the Spatially Referenced Virtual Synchronization for Collaboration Algorithm

Figure: Snapshot of two SRVS-C user interfaces in a collaborative spatial sketching scenario. Left API-VR interface: users draw in 3D space using handheld 6DoF controllers, selecting brush properties such as color and thickness via an in-world palette. Right API-AR interface: users draw via touch input on an ARCore-enabled smartphone screen, with brush customization available through an overlaid 2D toolbar

Overview

This repository presents a framework designed to streamline the deployment and configuration of colocated collaborative mixed reality (MR) experiences that bridge both augmented reality (mobile AR) and virtual reality (VR) environments. The solution employs a centralized client-server architecture, where a dedicated local server (PC) manages real-time data communication and synchronization across connected devices, enabling seamless interaction between AR and VR participants. This approach eliminates reliance on cloud anchor services or third-party platforms, which often impose restrictive limitations, while supporting both ARCore-compatible mobile devices and various VR headsets for truly cross-reality collaborative experiences.

Perfect for:

• Prototyping multi-user AR/VR experiences
• Collaborative projects
• AR education tools

🧩 Project Components

Folder	Purpose	What You'll Find There
SRVS-C/	Contains the complete architecture and technical configuration for the local server, including all necessary components and operational processes	Server code, database setup
API-AR/	Includes the mobile application implementation that connects to and interacts with the server framework	Unity project, App setup
API-VR/	Includes the VR application implementation that connects to and interacts with the server framework	Unity project, VR setup

🛠️ Setup Guide

Before You Begin

You'll need:

✔ Computer: Windows/Mac/Linux with:

• Node.js v22.12.0 (installation guide)
• MongoDB 8.0.4 (Optional)

✔ Phone: Android devices with:

• ARCore support (compatibility list)
• Developer mode enabled

✔ VR Device: VR device with a 6DoF controller (Oculus Rift recommended):

• Meta Quest Developer Hub app installed on PC (for Quest devices)

✔ Refer to SRVS-C.md, API-AR.md and API-VR.md for setup instructions.

Please kindly cite our paper as:

@article{SRVS-C,
author = {Murillo Gutierrez, Gustavo Adolfo and Jin, Rong and Ramirez-Paredes, Juan-Pablo I. and Hernandez Belmonte, Uriel Haile},
title = {A Framework Designed with Perceptual Symmetry and Interactive Asymmetry for {XR} Collaboration},
journal = {Symmetry},
volume = {17},
year = {2025},
number = {11},
article-number = {1842},
url = {https://www.mdpi.com/2073-8994/17/11/1842},
issn = {2073-8994},
doi = {10.3390/sym17111842}
}