Chapter 4 of 13
Permissions
The six permissions a game can ask for, what each grants, the bridge calls it opens and the line players read before they agree.
permissions is a vocabulary CamTable enforces. The player sees your list on the consent screen
(install, and again when a friend’s room loads your game), and the bridge refuses any call for
a capability you did not declare, with a PERMISSION_DENIED error. The manifest declares the
union; each Play Option declares what that game uses.
| Permission | Grants | Bridge calls |
|---|---|---|
players.profile |
Display names, usernames and avatars of the players. Without it every player is just “Player 1”, “Player 2”, … | (the player fields of init, getState, getPlayers, getLocalPlayer) |
video.effects |
Camera filters on the local player’s outgoing video. They are your game’s alone: the player has no switch for them. To close a camera to the Call, use call.cover. The consent screen says “Bu oyun kamerandan giden görüntüyü değiştirebilir.” |
setVideoEffect, resetVideoEffect |
whisper |
Putting your players in Whispers (whispers.groups, whispers.requests), the Whispers your player may know of, and the Whisper Requests your page makes and answers for its player. Without it the room puts nobody in a Whisper, and your page learns nothing of any: not in its room state, not as an event. The consent screen says “Bu oyun seni fısıltıya alabilir ve senin adına fısıltı isteyip kabul edebilir.” |
getWhispers, onWhisperChange, requestWhisper, acceptWhisperRequest, declineWhisperRequest, onWhisperRequest, endWhisper |
tiles.overlay |
Badges, counters, timers, glow and action buttons on the players’ video tiles. | setTileOverlay, clearTileOverlay |
call.mute |
Closing the local player’s voice to the Call while the match runs (Call Mute). The consent screen says “Bu oyun aramaya giden sesini kapatabilir.” | setCallMuted |
call.cover |
Closing cameras to the Call while the match runs (Call Cover), through the callCover key of your rules’ state: the table sees a dark, blurred or still picture in place of a covered camera. Without it the room ignores the key and tells you once. The consent screen says “Bu oyun kameranı aramaya kapatabilir ve fısıldaştığın oyunculara gösterebilir.” |
(none: the cover is your rules’ state) |
Game state, actions, custom tab state, hit regions and video slots need no permission. The rules apply equally to your game frame and to its custom tab frames.
Ask for as little as you need: every permission is a line on a screen players read before they decide.