Game Scenes
A scene is a geographical area, within the game playground, which is defined by a center (GPS coordinates) and a radius. A scene is an active area of your game where the action happens according to the script you define for that scene.
Scenes can be enabled and disabled according to your needs. In the real world, players can enter/exit any scene, disabled or enabled (you cannot prevent a player's physical move). However, the player app will check only if the player has entered an enabled scene and then will try to listen for events (e.g. player’s proximity, scanning of codes, etc.) and try to handle them. On the contrary, if the player enters the geographical area of a disabled scene, nothing will happen game-wise.
If scenes are visible to your players (see Game Playground configuration section), scenes are drown as semi-transparent cycles on their map.
A scene as shown to the player (if visible) |
You can configure a scene to be initially enabled or not. So, if a scene is not initially enabled, you can enable it later in order to allow game action to happen there.
Moreover, when players enter or exit an enabled scene while having their app closed or backgrounded, they will be notified accordingly (with a notification saying that they have entered/exited a game neighborhood (named after the title of the scene). This behavior can be prevented if you define a scene as foreground only. Foreground-only scenes are only crossed (gamewise) if the player has the rollick player app open and foregrounded.
Player State Data
Concerning scenes, the following player state information can be exploited:
- Player has entered scene
- Player has exited scene
- Player is currently in scene