Skip to content

fxnai/fxn3d

Repository files navigation

Function for Unity Engine

function logo

Dynamic JSON Badge

Run AI prediction functions (a.k.a "predictors") in your Unity apps and games. With Function, you can build AI-powered apps by creating and composing GPU-accelerated predictors that run in the cloud. In a few steps:

Installing Function

Add the following items to your Unity project's Packages/manifest.json:

{
  "scopedRegistries": [
    {
      "name": "Function",
      "url": "https://registry.npmjs.com",
      "scopes": ["ai.fxn"]
    }
  ],
  "dependencies": {
    "ai.fxn.fxn3d": "0.0.17"
  }
}

Important

When building for WebGL, make sure that the Enable Exceptions setting in Player Settings > Publishing Settings is set to Full With Stacktrace. Other exception modes will currently raise errors.

Retrieving your Access Key

Head over to fxn.ai to create an account by logging in. Once you do, generate an access key:

generate access key

Then add it to your Unity project in Project Settings > Function:

add access key to Unity

Caution

If your Unity project is open-source, make sure to add ProjectSettings/Function.asset to your .gitignore file to keep your Function access key private.

Making a Prediction

First, create a Function client:

using Function;

// Create a Function client
var fxn = FunctionUnity.Create();

Then make a prediction:

// Make a prediction
var prediction = await fxn.Predictions.Create(
    tag: "@samplefxn/greeting",
    inputs: new () {
        ["name"] = "Rhea"
    }
);
// Log the result
Debug.Log(prediction.results[0]);

Requirements

  • Unity 2021.3+

Supported Platforms

  • Android API Level 24+
  • iOS 14+
  • macOS 10.15+ (Apple Silicon and Intel)
  • Windows 10+ (64-bit only)
  • WebGL:
    • Chrome 91+
    • Firefox 90+
    • Safari 16.4+

Useful Links

Thank you very much!