This framework has been designed to offer some resources to those developers with an interest in working with Augmented Reality based on geolocalization on SmartPhones and tablets.
BeyondAR Game is using this platform to show the creatures arround the user. Here some images:
##How to build your first app
To create the UI it we can choose using an Android Layout XML or using java code. For both of them the minimal view required is the BeyondarGLSurfaceView. The CameraView is a nice complement, but not mandatory.
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.beyondar.android.opengl.views.BeyondarGLSurfaceView
android:id="@+id/customGLSurface"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<com.beyondar.android.views.CameraView
android:id="@+id/camera"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</FrameLayout>
Once we have the layout ready it is time to load it.
private CameraView mCameraView;
private BeyondarGLSurfaceView mBeyondarGLSurfaceView;
...
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
mBeyondarGLSurfaceView = (BeyondarGLSurfaceView) findViewById(R.id.customGLSurface);
mLabelText = (TextView) findViewById(R.id.labelText);
mCameraView = (CameraView) findViewById(R.id.camera);
...
}And when the app goes to onPause/onResume the BeyondarGLSurfaceView needs to be notified
@Override
protected void onResume() {
super.onResume();
mBeyondarGLSurfaceView.onResume();
}
@Override
protected void onPause() {
super.onPause();
mBeyondarGLSurfaceView.onPause();
}The next step is to create the World that holds the information related to the objects that need to be displayed in the app using augmented reality.
// Create the world instance
World world = new World(this);
// User position (you can change it using the GPS listeners form Android API)
world.setLongitude(1.925848038959814d);
world.setLatitude(41.26533734214473d);
// Create an object with an image in the app resources.
GeoObject go1 = new GeoObject(1l);
go1.setLongitude(1.926036406654116d);
go1.setLatitude(41.26523339794433d);
go1.setImageResource(R.drawable.creature_1);
go1.setName("Creature 1");
// Is it also possible to load the image dynamically form internet
GeoObject go2 = new GeoObject(3l);
go2.setLongitude(1.92582424468222d);
go2.setLatitude(41.26518966360719d);
go2.setImageUri("http://beyondar.com/sites/default/files/logo_reduced.png");
go2.setName("Online image");
// Also possible to get images from the SDcard
GeoObject go3 = new GeoObject(4l);
go3.setLongitude(1.925873388087619d);
go3.setLatitude(41.26550959641445d);
go3.setImageUri("/sdcard/TheAvengers_IronMan.jpeg");
go3.setName("IronMan sdcard");
// And the same goes for the app assets
GeoObject go4 = new GeoObject(6l);
go4.setLongitude(1.925932313852319d);
go4.setLatitude(41.26581776104766d);
go4.setImageUri("assets://TheAvengers_IronMan.jpeg");
go4.setName("IronMan assets");
//We add this GeoObjects to the world
world.addBeyondarObject(go1);
world.addBeyondarObject(go2);
world.addBeyondarObject(go3);
world.addBeyondarObject(go4);
//Finally we add the Wold data in to the View
mBeyondarGLSurfaceView.setWorld(world);Now we have the app ready to show the GeoObjects. But we also want to campture events, for instance, when the user click on a GeoObject
...
mBeyondarGLSurfaceView.setonARTouchListener(this);
...
@Override
public void onTouchARView(MotionEvent event, BeyondarGLSurfaceView beyondarView) {
// We need the coordinates to know where the user has touched the screen
float x = event.getX();
float y = event.getY();
ArrayList<BeyondarObject> geoObjects = new ArrayList<BeyondarObject>();
//Now we use the view to collect all the objects that are touched by the user
beyondarView.getARObjectOnScreenCoordinates(x, y, geoObjects);
String textEvent = "";
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
textEvent = "Event type ACTION_DOWN: ";
break;
case MotionEvent.ACTION_UP:
textEvent = "Event type ACTION_UP: ";
break;
case MotionEvent.ACTION_MOVE:
textEvent = "Event type ACTION_MOVE: ";
break;
default:
break;
}
// We just iterate and display the Objects. The first object will be the closest to the user
Iterator<BeyondarObject> iterator = geoObjects.iterator();
while (iterator.hasNext()) {
BeyondarObject geoObject = iterator.next();
textEvent = textEvent + " " + geoObject.getName();
}
doSomethingInTheUIThread(textEvent);
}