Skip to content

Samsung/avatar-plugin-for-unity

Repository files navigation

Avatar Plug-in for Unity : glTFast Plug-in


Introduce

glTFast is an open-source library for loading and rendering glTF™ (GL Transmission Format) 3D models in Unity. This is a lightweight and fast implementation compared to other glTF libraries, providing high performance even on mobile devices or low-end computers. This can be integrated with Unity's rendering engine. So we serve the Avatar Plug-in for Unity, which loads AREmoji via glTFast and provides a variety of additional features. For detailed explanation, please refer to Samsung Developers.


Version Naming Convention

Type Version
Official 4.X
Unofficial(LATEST) 4.0.X

Why need to use Avatar Plug-in

Avatar provided by Samsung complies with the gltf 2.0 standard specification. However, in order to fully function as an Avatar, additional functions and processes are required. For detailed explanation, please refer to Samsung Developers.

How To Use

1. Project Settings

The Avatar Plug-in for Unity is validated in Unity version 2023.2.Xf1 and may work in some higher versions.

Figure 1: Create Project


here is a dependency on glTFast, so you need to import glTFast into your project first. Avatar Plug-in always follows the latest glTFast. To import the gltfast package into the project, go to Package Manage -> Install package by name.. -> Enter "com.unity.cloud.gltfast"

Figure 3: Import GLTFast Pakage


Finally, import the Avatar Plug-in for Unity Package into Proejct. The easiest way to install is to download and open the Installer Package

Figure 3: Import Avatar Plug-in for Unity Pakage


The Avatar Plug-in for Unity automatically configures essential project settings when imported into a project. Please refer to the table below and note that project settings will change automatically.

Auto Project Setting Fratures

Frature Hierarchy Value
Minimum API Level Player/Iedntification Android 9.0 'Pie'(API level 28)
Normal Map Encoding Player/Rendering XYZ
Scriipting Backend Player/Configuration IL2CPP
Target Architectures Player/Configuration ARM64
Always Included Shaders Graphics/Built-in Shader Settings Add glTF/PbrMetallicRoughness

2. Usage

Once the Avatar Plug-in for Unity has been imported into your project, using it is very simple. We provide samples for each feature. You can run each sample and test it out.

Figure 4: Avatar Plug-in for Unity Samples


Open-Source Library

The Avatar Plug-in for Unity can be reviewed and modified by anyone to improve it. This allows adding or modifying features required to render glTF models in Unity. Moreover, the library is continually being developed and maintained by the Unity community, allowing users to obtain better results using the latest version of the library. Anyone with update requests for The Avatar Plug-in for Unity can contribute through the Github System. Send a “Pull Request” to jeoungjukim