Set up Cloud Code
To make use of the Triggers service, you should define a Cloud Code script or a Cloud Code module.
Cloud Code C# modules Write server-side code with a type-safe programming language and powerful .NET components. Consume other content needed in the project bundling dynamic link libraries (DLLs) with tools like NuGet. |
Cloud Code JavaScript scripts Write server-side code with a easy to iterate language. Take the advantage of using the same ecosystem if you come from a JavaScript frontend background. Bundle your code with reusable pieces through CommonJS and ECMAScript module systems supported out-of-the-box with the Cloud Code command line. |
This script or module is executed when a trigger is fired, given you have defined a trigger configuration.
Execution return value
Currently, Triggers service does not interact with any return value coming from Cloud Code. Account for this by creating modules and scripts that execute your game logic directly.
Context attributes
Since the Triggers service is authenticated by a Service Account, certain attributes are not available in the context
object for scripts, and the IExecutionContext
interface for modules during execution.
Due to lack of player authentication, the following attributes are not available:
playerId
accessToken
unityInstallationId
analyticsUserId
correlationId
Ensure your scripts and modules do not rely on these attributes.
Note: You can still authenticate using the serviceToken
. This allows you to call out to other UGS services, such as the Lobby service, to retrieve player data.
Cross-player data
To modify cross-player data using Cloud Code, you need to authenticate using the serviceToken
and call out to other UGS services.
You cannot retrieve the player ID from the context object when writing Cloud Code logic. However, when triggers are paired with events emitted from UGS, you can often retrieve a player ID from the event payload and interact with player data. Refer to Supported UGS events for more information on supported events and their payloads.
You can also call out to other Unity Gaming Services to retrieve player data. For example, you can retrieve players from Leaderboards or players in the Lobby service by calling out to these services in your script or module.
Refer to Use case sample: Reward top players with in-game currency for an example.
Payload parameters
Cloud Code modules and scripts can be invoked with a set of parameters. These parameters are defined in the event’s payload. The scheduled events' payloads are defined by the user in the schedule configurations. For UGS events, refer to Supported UGS events for the contents of the event payloads.
The parameters should be defined in the same way as they would be for any other script or module.
The triggering event’s payload is used as the argument set for the Cloud Code invocation; any defined parameters that match keys in the event payload are populated.
All event payloads automatically include projectId
, environmentId
and correlationId
.
For example, given a script below has a string parameter name
:
JavaScript
module.exports = async ({ params, context, logger }) => {
return "Hello " + params.name;
};
or a module has a function SayHello
with a string parameter name
:
C#
using Unity.Services.CloudCode.Core;
namespace ExampleModule;
public class MyModule
{
[CloudCodeFunction("SayHello")]
public string Hello(string name)
{
return $"Hello, {name}!";
}
}
then you would define the payload for the schedule configuration as follows:
{
"name": "hello-world-test",
"eventName": "hello-world-test",
"type": "one-time",
"schedule": "2023-08-28T15:20:00Z",
"payloadVersion": 1,
"payload": "{\"name\": \"World\"}"
}
When the trigger is fired, the Cloud Code script or module is executed with the payload parameters populated.
Note: Limits apply. Refer to Limits for more information.