SDK
Errors and limits
The SDK resolves with a safe default and does not throw, so a failure never breaks your game loop.
Error codes
| Code | Meaning |
|---|---|
needs_signin | The player is a guest. VPlay opens its own sign-in. |
insufficient | Not enough VCoins. VPlay tells the player. |
unavailable | The item, game or feature is not available (or switched off). |
price_changed | The price moved while the sheet was open; the player is asked again. |
rate_limited | Too many requests. Slow down. |
not_granted | Your game isn't allowed to do that. Ask us to switch it on. |
Limits
| Limit | Value |
|---|---|
| Cloud save | 64 KB of JSON |
| Live hints (score, lives, level) | 10 per second |
| Shortest counted run | 3 seconds |
| Item and milestone ids | 80 characters |
| Purchase confirmation | waits up to 3 minutes for the player |
Read the live numbers from host.limits instead of copying them.
