Skip to content
forked from ARPOISE/ARpoise

ARpoise - Augmented Reality point of interest service environment

License

Notifications You must be signed in to change notification settings

Avatarchik/ARpoise

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ARpoise Logo

Augmented Reality point of interest service environment

Overview

ARpoise is an open-source Augmented Reality service environment that allows AR content designers to create and distribute and AR users to view location based AR content that is created in Unity.

Two different client applications have both been implemented for Android and iOS.

  • The ARpoise client is a geolocative AR app running on most available phones. The ARpoise app can be downloaded from the Google Play Store and the Apple App Store. The source code of the apps is available here.

  • The AR-vos client is an image trigger and a geolocative AR app using ARKit on iOS and ARCore on Android. The AR-vos app can be downloaded from the Google Play Store and the Apple App Store. The source code of the apps is available here.

The goal of ARpoise is to provide an open-source, community-supported, location-based AR app as a replacement for the Layar app and other commercial geolocative AR platforms.

Getting Started

If you are a content creator wanting to use ARpoise or AR-vos to deliver your own 3D content, you should start by reading this document. As you also will have to run you own version of the ARpoise-PorPOISe Back End you should also read the documentation for it in /php/porpoise.

Functionality

  • Content designers can create image trigger or location-based AR experiences in Unity3d and add them as project layers to a general directory. This AR experiences can either be visible all over the world, or geo-fenced to be viewable only within areas defined by specific GPS coordinates.

  • These AR experiences can be viewed by anyone who downloads one of the free client apps, ARpoise or AR-vos, onto Android and iOS devices. Since the AR experiences are individual project layers within an existing app, content designers do not have to create individual apps for each project and bring each project into the App and Play stores themselves.

  • Artist define layers of points of interest, (POI)s, can be added to, removed from, or placed within the world coordinates of ARpoise dynamically.

  • The 3D content visible in ARpoise is independent of the app downloaded from the Google Play Store or the Apple App Store. The POIs specified in an ARpoise layer definition contain the URL of an Unity AssetBundle. When showing a POI, the ARpoise app downloads this asset bundle and loads the 3D Unity prefab of the POI from it.

  • Unity-created 3D content of ARpoise can include your animations. Furthermore, POIs can have ARpoise level animations like scale, rotation, and transformation to be started 'on create', 'on focus', 'in focus', or 'on click' of a POI.

  • Image trigger based POIs are shown to the user once the app discovers a trigger image.

  • Geolocative POIs can have an absolute world location defined by longitude and latitude or they can have a position relative to the user's device defined in meters of distance in the X, Y, and Z directions. POIs with an absolute location can additionally be confined into an area around the user, so they will always be around the user.

  • POIs can be added to and removed from an ARpoise layer via a PHP based web interface similar to the PorPOISe for Layar web service. The placement of individual POIs can be performed through a Google-maps-based click-and-drag map interface. The ARpoise version of PorPOISe converts your data sets of POIs into responses to the ARpoise client. Things like JSON formatting and distance calculation are all done for you. ARpoise supports XML as data stores.

  • One or more ARpoise layers can be shown at any location in the world. If there are two or more ARpoise layers located within the range of the client's location, a list of all available layers is shown to the user for selecting a layer. If there is exactly one ARpoise layer located within the range, this layer is shown to the user. If there is no layer within the range of the client's location, the default layer is shown. Currently Tamiko Thiel's Lotus Meditation.

Components

iOS- and Android-Client Application

See unity. This folder contains Unity projects for the different clients, ARpoise and AR-vos.

ARpoise-Directory Front End

See ARpoiseDirectory.

ARpoise-Directory Back End

See /php/dir.

ARpoise-PorPOISe Back End

See /php/porpoise.

Restrictions

  • Unity behaviour scripts written in C# cannot be included in Unity-created 3D content of ARpoise.

  • Adding, removing and placing layers within the ARpoise-Directory is an email-based process involving the administrators of www.arpoise.com.

About

ARpoise - Augmented Reality point of interest service environment

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 64.6%
  • C 16.7%
  • PHP 13.1%
  • Objective-C++ 2.5%
  • ShaderLab 1.7%
  • JavaScript 0.9%
  • Other 0.5%