This package is a fork of the original Dissonity package. This particular package been created to be used with Snapser. If you are not building your game on Snapser, please use the original package link.
Snapser is a modern alternative to Playfab and Firebase. We have built a starter project in Unity C# which you can deploy as a Discord activity within a manner of minutes, while having full access to Snapser backend services. If you are interested to know more, please register for a Snapser account.
Dissonity allows you to easily create Discord activities with Unity. In version 1, the npm and Unity packages share data to provide functionality.
It's designed for a structure similar to the nested-messages example from Discord. You may want to familiarize with that project structure first.
npm install snapser-dissonity
yarn add snapser-dissonity
pnpm add snapser-dissonity
When running the activity, your game build will be inside a nested iframe that we will call "child". The child iframe must have the id "dissonity-child", like:
<iframe id="dissonity-child" src=".proxy/nested/index.html"></iframe>
Instead of manually creating an SDK instance, call setupSdk
inside the parent index.js with your options:
import { setupSdk } from "snapser-dissonity";
window.addEventListener("DOMContentLoaded", () => {
setupSdk({
clientId: /*your-app-id*/,
tokenRoute: "/v1/auth/discord/login",
method: "PUT",
});
});
Where tokenRoute
is the route where your server is handling authorization codes and sending back an access token in a POST request:
{ code: string, create_user: bool, access_token: string }
{ access_token: string, user: UserObject }
app.post("/api/token", async (req, res) => {
const code = req.body.code;
(...)
res.send({ access_token, user });
});
That's all the configuration you need inside Node.js! Now, in your Unity project install the Dissonity Unity package.
As a note, there's an already configured Node.js project in the GitHub repository.