Menu
Lumberyard
Developer Guide (Version 1.12)

Cloud Gem Portal

A cloud gem is a gem in Lumberyard whose scripts and assets use AWS resources to implement cloud-connected game features. A cloud gem creates a Cloud Gem Portal (CGP) that you can use to manage the cloud data for your game. For example, the Leaderboard Cloud Gem Portal can provide a way for a support person to remove fraudulent high scores. The Cloud Gem Portal is hosted in your AWS account and is a website that you own. The Cloud Gem Portal is part of the Cloud Gem Framework and can be customized.

How a Cloud Gem Portal Works

Cloud gem portals use Amazon Web Services to implement their functionality, as shown in the following diagram.


        Cloud gem workflow

Amazon S3 stores a Cloud Gem Portal as a web application. AWS Lambda functions implement the required server-side logic. JavaScript code that runs in the web browser accesses the Lambda functions through the Amazon API Gateway. The configuration for the API Gateway is handled by the Cloud Canvas Cloud Gem Framework Service API.

Cloud Gem Workflow

A cloud gem provides content (for example, HTML, JavaScript, or images) from its /dev/Gems/<gem>/AWS/cgp-resource-code subdirectory. When you deploy a cloud gem, the Cloud Canvas Resource Manager uploads this content to the project’s configuration bucket. To determine which cloud gems are available to it, the Cloud Gem Portal page uses the Cloud Gem Portal service API to call the Cloud Gem Portal Lambda function. When you select a cloud gem, its content is loaded into the Cloud Gem Portal webpage. To query the state of the cloud gem or perform other operations, JavaScript code can use a service API defined for the cloud gem. The service API calls the cloud gem's Lambda function that implements the cloud gem's functionality.