App configuration

After image placement and object placement have been addressed for the AR experience, the app must be configured to use them. The following procedure walks you through app configuration on the iPad.

1. Launch the app and when prompted to access the camera, click the OK button.
   Note: Since this is an AR experience, the app will only work if you grant access to use the camera.
2. Next, the app will determine if you have set the OIC F(n)settings. This notice will appear in two cases: 1) you have not configured OIC F(n) yet, or 2) your OIC F(n) settings are incorrect and the app cannot communicate with your instance.
3. Click the Open Preferences button, which will take you to the iOS settings where these values are controlled.
   Note: It is possible to update these settings before opening the app for the first time. The app takes you to the settings as a convenience.
4. The credentials required are defined based on the OCI REST API requirements. The required fields are used to generate the proper authorization signature for each API call.
5. .

   It's recommended that you create a user account that belongs to a group that can invoke functions from within the OCI tenancy and compartment where you configured your OCI functions. This user will then be restricted to only making API calls to OCI functions, and won't have access to any other services, or to make changes, in your OCI tenancy.

   This function returns the OCID of your F(n) application. You will then use the OCID to construct the application’s details endpoint which is formatted as follows replacing the variable with the proper values.

   functions.<oci region>.oraclecloud.com/v2/fns?app_id=<Application OCID>

6. Get your tenancy OCID, user OCID, and key fingerprint from the OCI management screens online. The private key field requires the private key that you generated for this user account, as it is required to generate the OCI signature.
7. Now get the OCI F(n) application endpoint, by using the F(n) command line or through the OCI web interface: This function returns the OCID of your F(n) application. This function returns the OCID of your F(n) application: fn i a ar-accelerator
8. Use the OCID to construct the application’s details endpoint which is formatted as follows replacing the variable with the proper value: functions.<oci region>.oraclecloud.com/v2/fins?app_id=<Application OCID>
9. Once the settings are configured, navigate back to the application and you should see the watermark to find the placement image. For image placement, point the camera at your printout of the image for the AR UI to appear. For object placement, point the camera at the object that you scanned for object recognition.
10. You can now interact with the experience and there are two ways to do so: 1) the heads-up-display (HUD), which is contextual and will show/hide buttons depending on the selected object, and 2) gestures to interact with the 3D model.