Starting and Stopping LiveSight
It is important to make a distinction between the two operating modes provided by the
CompositeFragment, Map Mode and LiveSight Mode. Map Mode is the mode of operation that is the same as that provided by the
MapFragment. As with
MapFragment, Map Mode behavior and functionality are as described under Maps. LiveSight Mode is the mode of operation that provides the LiveSight experience and has separate functionality and behavior.
To switch between Map Mode and LiveSight Mode, two methods from the
stop(), are used. The
start() method triggers the transition from Map Mode to LiveSight Mode, which includes a short cinematic transition animation by default. Calling
start() while already in LiveSight Mode results in the
Error.INVALID_OPERATION error code being returned. Use the
stop() method to transition from LiveSight Mode to Map Mode. By default the
CompositeFragment starts in Map Mode.
// Triggers the transition from Map Mode to LiveSight Mode Error error = arController.start(); ... // Exits LiveSight Mode and returns to Map Mode Error error = arController.stop(true);
Reading the Current Pose
ARControllerprovides a convenient way to retrieve the current positional and directional (pose) values of your LiveSight session. By calling
ARController.getPose(), you can retrieve the
ARPoseReadinginstance, which contains the following values:
ARPoseReadingvalues are derived from device sensors, they are interpolated and smoothed by the LiveSight engine.