Unity Tutorial

Video Tutorial

How to move the sample avatar

1. download the script and sample avatar for Unity from the following page



2. Load the script and sample avatar into Unity.


3. Attach the script (UnityRecieve_Facemotion3d.cs) to a GameObject.



4. Press the Settings button in the Facemotion3d iOS app and find out the IP address of the iPhone.

 Enter the iPhone's IP address in the "iOS_IP Address" field of the Unity script.


5. Turn on the "Game Start With Connect" checkbox in the Unity script.

 Press the "Game Start" button, and the sample avatar will start moving.

How to move your original avatar

1. Load your original avatar into Unity.

 Create a BlendShape with the same naming convention as the sample avatar.


2. Switch to the iOS app Settings → Streaming Settings → Unity tab.

 Enter the avatar's bone name and other information here.


3. If you want to ignore the settings on the iOS side and specify the bone name on the Unity side, you can do so in the script on the Unity side.

 Check the "Specify Object Name Inside Unity" checkbox.


      Enter the name of the GameObject you want to move into the attached script.


4. Start the game and move the avatar.

How to import recorded data into Unity

1. record with the iOS application. 2.


2. Press the Save button, save the recording data in .txt format, and send the data to your PC via email, etc.


3. Download the script to import the recording data into Unity from the following site.




4. Load the script into Unity.


5. Enter the name of the GameObject to which the animation will be applied.


6. Load the .txt file output from the iOS app.

How to move VRM avatars

Download the script from the following URL and attach it to the GameObject.


In the inspector script, select the root object of the VRM and the GameObjects of the bones such as head, eyes and neck.


Turn on "Use ARKit BlendShape" to find and move the 52 blendshape BlendShapeClips.