This package provides C# bindings to the Kongregate Web API to be used in developing Unity games that will be published on the Kongregate website.
KongregateWeb.BecameReady += () =>
{
if (KongregateWeb.IsGuest)
{
Debug.Log("Player is a guest");
}
else
{
Debug.Log("Player is logged in as " + KongregateWeb.Username);
}
};
KongregateWeb.LoggedIn += () =>
{
Debug.Log("Player is logged in as " + KongregateWeb.Username);
};To include kongregate-web as a Unity package, you'll need to be on Unity 2018.3 or later. Open Packages/manifest.json in your project and add "com.kongregate.kongregate-web" to the "dependencies" object:
{
"dependencies": {
"com.kongregate.kongregate-web": "https://github.com/kongregate/kongregate-web.git"
}
}NOTE: You'll need to have Git installed on your development machine for Unity to be able to download the dependency. See https://git-scm.com/ for more information.
NOTE: If you're using an older version of Unity, you can still use kongregate-web by copying the contents of
Pluginsinto your project'sPluginsfolder.
To use kongregate-web, you'll first need to include the Kongregate JavaScript API in your build's generated index.html file. To do so, follow the Unity instructions for setting up a custom WebGL template, then add a link to kongregate_api.js as described in the Kongregate JavaScript guide.
NOTE: There's an additional dependency on Json.NET currently, which means you'll need to import it into your project in order to use kongregate-web. There is a package on the Unity store that you can use for this purpose. This dependency will be removed in a future version, see #1.
The API is accessible through public, static methods on the KongregateWeb class. You never need to access the KongregateWeb instance directly.
The API needs to be loaded before it can be accessed. This will happen automatically on Awake() when the KongregateWeb object is created, however you'll need to wait for KongregateWeb to become ready before accessing any of the API functions. There are two ways of doing this:
IsReadycan be used to check if the API is ready.- The
BecameReadyevent is emitted once the API becomes ready.
Any attempts to access the API (other than IsReady) before it becomes ready will throw an exception. It is always okay to register callbacks on public events, though.
NOTE:
KongregateWebwill automatically create its own instance the first time it is accessed, which may mean that the API won't become ready until a later point. To ensure that the API becomes ready as early as possible, you can explicitly add an instance ofKongregateWebto your scene file. This will help to reduce the amount of time that your game will have to wait before accessing the Kongregate API.
The KongregateWeb class itself provides usage documentation for each of the functions and events. Additionally, the API mirrors the JavaScript API, so you can check the Kongregate docs for more details: https://docs.kongregate.com/v1.0/reference
The Kongregate API is only available when building for WebGL, and will only work correctly for a game that has been uploaded to the Kongregate website. When deploying your game to another website, or when testing builds locally, you can use KongregateWeb.Status to check the availability of the Kongregate JavaScript API. If you have not yet initialized the web API (by creating the KongregateWeb instance) it will return ApiStatus.Uninitialized. Once you have initialized the API, it will return ApiStatus.IsReady if the JavaScript API is present, or ApiStatus.Unavailable if initialization failed. KongregateWeb.Ready will also return false if the API is unavailable.