Example of how to use Beamable APIs in a webpage context: HTML and Javascript.
The code in this example is deliberately bare-bones, aiming to demonstrate login and stats access as simply as possible.
This example code is pointed at the BeamWebAccess-prod realm, as
described below. You can start testing with it without making any
changes.
- Point a web browser at
web/index.html - Use the Guest Login button to create a guest account
- Try out the forms below the login area
The "Display Name" and "Avatar" portion of things uses client.public
stats, which can be written and read by anyone who has a valid access
token. The "Dice" portion of the page uses a Beamable C# Microservice
to interact with game.private stats, which are only readable and
writable by admins and privileged processes. C# Microservices are a
good way to mediate access to privileged resources, using logic that
you define when writing the C#MS.
As shipped in this repository, the example code is hardcoded to use a Beamable staff CID and PID (1418422019508250 and DE_1719820960373762, respectively). You may freely try out the code in this realm, but if you want to make significant changes, such as modifying the C# microservice, you should switch to a realm that you control. The CID and PID are encoded in two places; you should change them in both.
- In
Assets/Beamable/Resources/config-defaults.txtyou should modify three fields:"cid","alias", and"pid". You can find the proper values for these in theconfig-defaults.txtof any other Beamable project that you have created on your own. - In
web/index.htmlyou should modify the constantsbeam_cidandbeam_pidto match your own realm.
Because the primary purpose of this repo is to demonstrate web-based
interaction with Beamable, the Unity project in the Assets/ directory
is just there to serve as a reminder that config-defaults.txt exists
and as a jumping off point for Unity-based testing if needed.
Questions or comments? Reach out to [email protected] to continue the conversation!