The Sandbox Game — Developers HUB

Sandbox Developers SDK — FAQ & Troubleshooting ​

This section provides answers to common questions and troubleshooting tips for integrating and using the SandboxSDK.

Frequently Asked Questions ​

❓ Why am I getting errors like "Settings are not initialized"? ​

You must call SandboxSDK.Initialize(OAuthSettings settings) before using any other method in the SDK. This sets up the authorization context.

❓ What credentials do I need to use this SDK? ​

You need to provide valid OAuth settings (client ID, scopes, etc.) to authenticate with the Sandbox platform. These are passed into the Initialize() method via the OAuthSettings object.

❓ What is the minimum set of steps required to make API calls? ​

  1. Call SandboxSDK.Initialize() with your settings
  2. Call SandboxSDK.RequestAuthorization() to log in the user
  3. Use other methods like GetUser() or GetPublicAssets() after successful authorization

❓ Do I need to handle token expiration? ​

No. The SDK manages token refreshing internally, as long as it was properly initialized and authorized.

❓ Can I use this SDK in a Unity project? ​

Yes. The SDK was designed with Unity in mind and is fully compatible with async workflows using UniTask.

Troubleshooting ​

⚠️ I get AuthenticationException when calling an API ​

  • Make sure you have successfully called RequestAuthorization() before making authenticated API calls
  • Ensure the user has completed the login flow

⚠️ My assets are not loading or instantiating ​

  • Ensure you are using valid assetIds from a public or owned collection
  • Check for connectivity or API errors in your development console

⚠️ Samples or examples are missing ​

Make sure to import the optional SDK samples from the Unity Package Manager if they are provided via the Samples~ folder.

If you're still encountering issues, please refer to the full documentation or contact the Sandbox Developer Support team.