Skip to main content

Unity + Internet Identity app links

Overview​

This sample shows one way to integrate Internet Identity with Android apps. It contains two parts: a dapp with II integrated, and an Unity Project which interacts with this dapp.

View this example on GitHub.

ii_integration_dapp is an example that integrates with Internet Identity, with the backend and frontend. It derives from the Internet Identity integration sample demo with some modifications. Please refer to README for details.

unity_project is a Unity project with BIG.NET embedded, which is a C# agent that is able to communicate with the BIG from C#. Please refer to README for details.

Workflow​

Before continuing, please read through the Android App Links to understand how Android App Links works.

Here is the basic workflow that how to integrate with Internet Identity from a Unity Android game. The basic idea is to open the Web Browser from the game, login in with II in the browser, and pass the DelegationChain back to the game.

The steps in detail are described below:

  1. Set up an Internet Identity integration dapp which supports logging in with II, with an assetlinks.json file associated. Please refer to ii_integration_dapp to set up the dapp.

  2. Run a Unity game on Android, which is built from android_integration sample. Please refer to unity_project to build the Unity Android game.

  3. Launch the Web Browser from the game to open the dapp frontend deployed in #1, with the public key of Ed25519Identity as a parameter.

  4. Login with your Internet Identity in the Web Browser.

  5. Launch the application via App Links, and pass the DelegationChain back to the game as the URL parameter.

  6. Composite the DelegationIdentity with DelegationChain and the Ed25519Identity.

  7. Call the backend canister with the DelegationIdentity to greet.