11. API Reference

This section provides a detailed description of the API provided by the ARGear Plugin.

11.1 ARGearManager

The ARGearManager oversees the overall flow and status and manages the lifecycle of ARgear. It also provides the methods that make all the ARGear functions possible.

11.1.1 Overview

Method
Description
Awake
Resets ARGear.
OnPostRender
Renders the camera data received through ARGear in Unity OpenGL.
LateUpdate
Processes the camera data received through ARGear after updating.
OnApplicationPause
Restarts or pauses ARGear based on the lifecycle.
OnDestroy
Destroys the ARGear session.
GetFaceTransform
Converts the transform object that has face data.
UpdateFaceObjects
Relays the ARGSession sampleBuffer and connection.
ChangeCameraFacing
Changes between the front/back camera.
RequestSignedUrl
Requests a SignedURL for Contents Download.
SetItem
Applies contents.
SetBeauty
Selects the beauty function type and sets the strength level.
SetBulge
Sets the Fun Bulge.
SetFilterLevel
Sets the strength level of the filter.
ClearContents
Clears the contents.
SetDrawLandmark
Turns the landmark debugging mode on and off.
ConvertBeautyData
Converts to an Android beauty data type.

11.1.2 Details

Awake()
When the script instance is loaded, it resets permissions, main camera, and renderer needed to drive ARGear.
OnPostRender()
Takes the camera data received in the ARGear Session and renders it in Unity OpenGL. It also saves the FaceTracking and Segmentation data in the Unity transform object.
LateUpdate()
After the update is run, it converts the ARGear Session's camera data to fit the window of the Unity Player.
OnApplicationPause(bool pause)
Resets/ pauses the ARGear session based on the state of the Unity Player.
Parameters
  • bool pause: the value of the Unity player's state
OnDestroy()
Destroys the ARGear session when the Unity player is destroyed.
GetFaceTransform(int index)
Returns the specific location of the face transform array object.
Parameters
  • int index: the location from the array.
Returns
  • Transform: an object with face scale, position, and rotation data
UpdateFaceObjects()
Renews the transform data with the face data from ARGear as a foundation every time OpenGL is rendered in the Unity Player.
ChangeCameraFacing()
Changes between the front/back camera.
RequestSignedUrl(string url, string title, string uuid)
Takes the URL, title, and type data of the content file to be downloaded and returns a string of a signed URL where contents download is possible.
Parameters
  • string url: a basic URL of the file to be downloaded
  • string title: Title of contents
  • string uuid: the unique URL (uuid) of the contents
Returns
  • string: a signed URL where contents download is possible
SetItem(ARGEnum.ContentsType type, string filePath, string uuid, ARGearContentsCallback callback = null)
Delivers the file path of the downloaded Type and Contents File and the Contents' uuid and makes it possible to render the contents on the camera screen.
Parameters
  • ARGEnum.ContentsType type: the ContentType of the content to be set
  • string filePath: the file path where the contents will be downloaded to
  • string uuid: the unique URL (uuid) of the contents
  • callback: callback result
SetBeauty(float[] values)
Applies 16 types of Beauty Type values consistently.
Parameters
  • float[] values: arranges a float of size 16
SetBulge(ARGEnum.BulgeType type)
Applies the selected type from 6 types of Fun Bulge. Choosing the ARGEnum.BulgeType.NONE option turns off Fun Bulge.
Parameters
  • ARGEnum.BulgeType type: chosen Fun Bulge type
SetFilterLevel(float level)
Sets the strength level of the currently selected filter. It is set from 0 to 100, and the closer to 100, the filter strength is closer to 100%.
Parameters
  • float level: strength of the chosen filter (0~100)
ClearContents(ARGEnum.ContentsType type)
Clears the contents of the received ARGEnum.ContentsType.
Parameters
  • ARGEnum.ContentsType type: ARGear contents type
SetDrawLandmark(bool isVisible)
A function that switches the debug mode of the landmark sign on and off.
Parameters
  • bool isVisible: Landmark Debug on/off
ConvertBeautyData(float[] values)
Converts the Beauty data values set in Unity to fit Android values. This is a method exclusively for Android.
Parameters
  • float[] values: Unity Beauty data
Returns
  • float[] values: the values converted to Android Beauty data

11.2 ARGearCamera

11.2.1 Overview

Method
Description
Start
Resets the ARGear Session.
Update
Gets the camera data after the ARGear Session is reset.
SetCameraTexture
Sets the ARGear camera texture in the Unity Renderer.
GetRigidPose
Changes ARGear's face data so that it can be used in Unity.

11.2.2 Details

Start()
Gives ARGear the Unity Player settings of ApiKey, SecretKey, AuthKey, and Config and resets.
Update()
Returns the ARGear Session's camera width and height when each frame of the Unity Player is updated.
SetCameraTexture(int width, int height, System.IntPtr ptr)
Sets the screen texture in Unity with the camera data from ARGear.
Parameters
  • int width: URL of file
  • in height: Title of Contents
  • System.IntPtr ptr: Type of Contents
GetRigidPose()
Takes the active face data from ARGear and saves it as a transform object with rotation and position values in Unity.

11.3 ARGearNative

11.3.1 Overview

Method
Description
ARGearNative
A creator to reset ARGear sessions on each platform

11.3.2 Details

ARGearNative(string url, string key string secretKey, string authKey, int[] inferenceConfig)
Uses the inferenceConfig value to reset Android/ iOS ARGear.
If you use Feature enum and set the
[Serializable]
public enum Feature
{
FACE_TRACKING = 0,
// FACE_BLEND_SHAPES = 1,
SEGMENTATION_HALF = 2
}