HERE iOS SDK Developer's Guide

<NMAARControllerDelegate>

Protocol Summary

protocol <NMAARControllerDelegate>

Derived from: <NSObject>

A delegate protocol for handling NMAARController events.

Include: NMAKit.framework/headers/NMAARController.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for <NMAARControllerDelegate> – <NMAARControllerDelegate>

[For complete information, see the section Protocol Details]

Instance Method Summary

Table 1. Instance Methods
Instance Method Summary

- @optional (void) arController:( NMAARController *) arController didUpdatePose:( NMAARPoseReading *) poseReading

Called when the pose (device location and orientation) has been updated

- @optional (void) arController:( NMAARController *) arController errorOccurred:(NSError *) error

Called when a serious error occurs or when LiveSight is stopped

- @optional (void) arControllerDidEnterCameraView:( NMAARController *) arController

Called when the camera view is presented

- @optional (void) arControllerDidExitCameraView:( NMAARController *) arController

Called when the camera view is hidden

Protocol Details

A delegate protocol for handling NMAARController events.

Note:

Methods of this protocol are called on the main queue.

Instance Method Details

- @optional (void) arController:( NMAARController *) arController didUpdatePose:( NMAARPoseReading *) poseReading

Called when the pose (device location and orientation) has been updated.

The pose is udpated when the user moves the device (by tilting, rotating, or changing location).

Parameters:

  • arController

    The NMAARController instance sending the callback.

  • poseReading

    The current pose.

- @optional (void) arController:( NMAARController *) arController errorOccurred:(NSError *) error

Called when a serious error occurs or when LiveSight is stopped.

There may be the situations where hardware or other system components are not behaving as expected. For example, sensors failing to respond, access being denied to the camera or GPS hardware, or other hardware-related problems.

This callback allows the app to handle such situations by asking the user to attempt to recover by quitting the app or restarting the device. LiveSight will continue to operate as best it can but certain features may not be available. For example, if the camera cannot be started then the camera view will not be presented.

The same error may be reported more then once depending on the internal state of the LiveSight system.

Parameters:

  • arController

    The NMAARController instance sending the callback.

  • error

    The NMAARError that occured if available.

- @optional (void) arControllerDidEnterCameraView:( NMAARController *) arController

Called when the camera view is presented.

Parameters:

- @optional (void) arControllerDidExitCameraView:( NMAARController *) arController

Called when the camera view is hidden.

Parameters: