Didimo creates incredible high-fidelity digital humans. Simple, fast, high-quality user-generated avatars to integrate into business, apps, and experiences.
Didimo provides a cloud-based automated service that enables the generation of digital humans from a simple selfie, we call these didimos.
Utilising this code library and tools, you can easily integrate digital humans into your existing software and enable your users to easily generate and load digital doubles of themselves directly into your experience, all at runtime.
All you need to get up and running after download is included in this README.
Following your decision to download this repo - our goal is to make it as easy and smooth as possible to get you building software. Your didimos can be imported into the project by simple drag-and-drop at edit time, or they can be loaded into the scene at runtime. No matter which approach you need, we've got you covered.
This SDK has been built to work with Unity 2021.3.x LTS (from Unity 2021.3.1 onwards).
Install via the package manager
Go to Project Settings → Package Manager
Name: Didimo
URL: https://package.openupm.com
Scopes: com.didimo.sdk
Open Unity's Package Manager, and make sure you refresh it
On the Packages:
drop down, select My Registries
The available Didimo packages will be listed. Install the ones you want. We recommend starting with the Core
package.
Optionally, add any of the following modules, by repeating the previous 2 steps, with the URLs:
Didimo SDK - Networking
For didimo API integrationDidimo SDK - Mobile
For a communication layer between android/iOS and UnityDidimo SDK - Oculus
For integration with OculusDidimo SDK - Asset Fitter
For a tool used to fit apparelSetup your project. You can do this by going to Window → Didimo Manager, and following the instructions, or by following these steps
UniversalRP-HighQuality
as the render pipeline asset.UniversalRP-HighQuality
as the render pipeline asset, for your desired
quality level.Explore
MeetADidimo
scene, by going to Window → Didimo Manager, and clicking the "open the Meet a didimo scene" link.For runtime loading of didimos, you can keep both importers without any issues. But for the Unity Editor, to import didimos directly into the project, Unity only allows one scripted importer per file extension. If you already have a glTF importer on your project, we will have a clash. To fix this, either:
USE_DIDIMO_CUSTOM_FILE_EXTENSION
to your project. This will make our importer register to the extension .gltfd
instead. You will then be responsible to rename your didimo .gltf
files into .gltfd
.
This will break our sample scenes, so if you need to evaluate the SDK first, we suggest you do it on a clean project.This project is broken down into the following modules:
Every module may contain a Samples
folder, where example assets and scenes of said module can be found. You can import
samples into your project through the Package Manager interface, after adding the module to your project. Go to Window →
Package Manager, select the Didimo SDK module you want to see samples from, and click one of the "Import" buttons.
Be sure to check out the Digital Human Specifications, best practices and the SDK Guide on our Developer Portal.
If you wish to build for Oculus, install the package Oculus Integration
1.1 Add the Oculus Integration
package to your account through Unity's Asset Store
1.2 Download and install the Oculus Integration
package, through Unity's Package Manager. It should be listed
under Packages: My Assets
. Refresh the Package Manager if required
1.3 Follow the instructions to update Oculus and restart Unity
You may be asked to update a number of Oculus related tools and restart Unity BEFORE the plugin will be installed. If
you restart - check to see if the plugin still needs to be installed. A successful install will result in an Oculus
folder in the Assets folder.
Didimo has tested this against version 32.0 which was published on the 30th August 2021.
If you wish to capture and record face movements using ARKit, install the package Live Capture from Unity.
2.1 Open Unity's Package Manager
2.2 Under the +
button, select Add package from git URL...
2.3 Enter [email protected]
and press Add
Additionally, you will need the companion app Unity Face Capture installed on an iPhone or iPad that supports ARKit face tracking.
Warning: This package is marked as preview and therefore the installation process may be subject to changes.
MeetADidimo
scene and don't see any didimos, go to Window → Didimo Manager, and click the Reimport didimos
button.Further detail is explained in the Developer Portal - "Getting Started" docs related to software creation are:
Thank you for contributing and trying our product! For bug reports, use github's issue tracker.
For pull requests:
This SDK uses the Didimo Source Code License. Read our Privacy page for more information on our license and privacy policies.
Detailed documentation can be read on our Developer Portal and