Difference between revisions of "Gaming"

From GiderosMobile
m
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Supported platforms:''' android, ios<br/>
+
<!-- GIDEROSOBJ:Gaming -->
 +
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]]<br/>
 
'''Available since:''' Gideros 2012.09<br/>
 
'''Available since:''' Gideros 2012.09<br/>
=== <translate>Description</translate> ===
 
<translate><br />
 
The [[Special:MyLanguage/Gaming|Gaming]] class is defined in the module &quot;gaming&quot;. Therefore, you need to call<br />
 
[[Special:MyLanguage/require(&quot;gaming&quot;)|require(&quot;gaming&quot;)]] before using it. Loading the Gaming module <br />
 
also creates a global class [[Special:MyLanguage/Gaming|Gaming]]. <br />
 
  
<p><strong>Currently supports:</strong></p>
+
=== Description ===
<ul>
+
The '''Gaming''' class currently supports:
<li>Gaming.new("googleplay") -- Android</li>
+
*Gaming.new("googleplay") -- Android
<li>Gaming.new("gamekit") -- iOS</li>
+
*Gaming.new("gamekit") -- iOS
</ul></translate>
+
<syntaxhighlight lang="lua">
 +
require("gaming")
 +
</syntaxhighlight>
 +
 
 +
Loading the '''gaming''' module also creates a global class '''Gaming'''.
 +
 
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
=== <translate>Methods</translate> ===
+
=== Methods ===
[[Special:MyLanguage/Gaming.new|Gaming.new]] <br/>
+
[[Gaming.new]] ''instantiate the Gaming plugin''<br/><!--GIDEROSMTD:Gaming.new(backend) instantiate the Gaming plugin-->
[[Special:MyLanguage/Gaming:autoMatch|Gaming:autoMatch]] <br/>
+
[[Gaming:autoMatch]] <br/><!--GIDEROSMTD:Gaming:autoMatch()-->
[[Special:MyLanguage/Gaming:deleteState|Gaming:deleteState]] <br/>
+
[[Gaming:deleteState]] ''remove the specified save/state''<br/><!--GIDEROSMTD:Gaming:deleteState(key) remove the specified save/state-->
[[Special:MyLanguage/Gaming:getAllPlayers|Gaming:getAllPlayers]] <br/>
+
[[Gaming:getAllPlayers]] <br/><!--GIDEROSMTD:Gaming:getAllPlayers()-->
[[Special:MyLanguage/Gaming:getPlayerId|Gaming:getPlayerId]] <br/>
+
[[Gaming:getPlayerId]] ''get the id of current player''<br/><!--GIDEROSMTD:Gaming:getPlayerId() get the id of current player-->
[[Special:MyLanguage/Gaming:getPlayerInfo|Gaming:getPlayerInfo]] <br/>
+
[[Gaming:getPlayerInfo]] <br/><!--GIDEROSMTD:Gaming:getPlayerInfo()-->
[[Special:MyLanguage/Gaming:getPlayerName|Gaming:getPlayerName]] <br/>
+
[[Gaming:getPlayerName]] ''get the name of current player''<br/><!--GIDEROSMTD:Gaming:getPlayerName() get the name of current player-->
[[Special:MyLanguage/Gaming:getPlayerPicture|Gaming:getPlayerPicture]] <br/>
+
[[Gaming:getPlayerPicture]] ''get the profile picture of current player''<br/><!--GIDEROSMTD:Gaming:getPlayerPicture() get the profile picture of current player-->
[[Special:MyLanguage/Gaming:getPlayerScore|Gaming:getPlayerScore]] <br/>
+
[[Gaming:getPlayerScore]] ''get the score of current player''<br/><!--GIDEROSMTD:Gaming:getPlayerScore() get the score of current player-->
[[Special:MyLanguage/Gaming:incrementAchievement|Gaming:incrementAchievement]] <br/>
+
[[Gaming:incrementAchievement]] ''increment the progress toward an achievement''<br/><!--GIDEROSMTD:Gaming:incrementAchievement(achievementId,numSteps,immediate) increment the progress toward an achievement-->
[[Special:MyLanguage/Gaming:invitePlayers|Gaming:invitePlayers]] <br/>
+
[[Gaming:invitePlayers]] <br/><!--GIDEROSMTD:Gaming:invitePlayers()-->
[[Special:MyLanguage/Gaming:isLoggedIn|Gaming:isLoggedIn]] <br/>
+
[[Gaming:isLoggedIn]] ''return the login state in Gaming service''<br/><!--GIDEROSMTD:Gaming:isLoggedIn() return the login state in Gaming service-->
[[Special:MyLanguage/Gaming:joinRoom|Gaming:joinRoom]] <br/>
+
[[Gaming:joinRoom]] <br/><!--GIDEROSMTD:Gaming:joinRoom()-->
[[Special:MyLanguage/Gaming:loadAchievements|Gaming:loadAchievements]] <br/>
+
[[Gaming:loadAchievements]] ''load all achievements''<br/><!--GIDEROSMTD:Gaming:loadAchievements() load all achievements-->
[[Special:MyLanguage/Gaming:loadPlayerCenteredScores|Gaming:loadPlayerCenteredScores]] <br/>
+
[[Gaming:loadPlayerCenteredScores]] ''load a leaderboard centered on the player''<br/><!--GIDEROSMTD:Gaming:loadPlayerCenteredScores(leaderboardId,timeSpan,collection,maxEntries) load a leaderboard centered on the player-->
[[Special:MyLanguage/Gaming:loadScores|Gaming:loadScores]] <br/>
+
[[Gaming:loadScores]] ''load a leaderboard''<br/><!--GIDEROSMTD:Gaming:loadScores(leaderboardId,timeSpan,collection,maxEntries) load a leaderboard-->
[[Special:MyLanguage/Gaming:loadState|Gaming:loadState]] <br/>
+
[[Gaming:loadState]] ''load a save/state''<br/><!--GIDEROSMTD:Gaming:loadState(key) load a save/state-->
[[Special:MyLanguage/Gaming:login|Gaming:login]] <br/>
+
[[Gaming:login]] ''log in the Gaming service''<br/><!--GIDEROSMTD:Gaming:login() log in the Gaming service-->
[[Special:MyLanguage/Gaming:logout|Gaming:logout]] <br/>
+
[[Gaming:logout]] ''log out of the gaming service''<br/><!--GIDEROSMTD:Gaming:logout() log out of the gaming service-->
[[Special:MyLanguage/Gaming:reportAchievement|Gaming:reportAchievement]] <br/>
+
[[Gaming:reportAchievement]] ''report an achievement progress''<br/><!--GIDEROSMTD:Gaming:reportAchievement(achievementId,numSteps,immediate) report an achievement progress-->
[[Special:MyLanguage/Gaming:reportScore|Gaming:reportScore]] <br/>
+
[[Gaming:reportScore]] ''report a new score''<br/><!--GIDEROSMTD:Gaming:reportScore(leaderboardId,score,immediate) report a new score-->
[[Special:MyLanguage/Gaming:resolveState|Gaming:resolveState]] <br/>
+
[[Gaming:resolveState]] ''resolve a save/state conflict''<br/><!--GIDEROSMTD:Gaming:resolveState(key,version,data) resolve a save/state conflict-->
[[Special:MyLanguage/Gaming:revealAchievement|Gaming:revealAchievement]] <br/>
+
[[Gaming:revealAchievement]] ''reveal an achievement''<br/><!--GIDEROSMTD:Gaming:revealAchievement(achievementId,immediate) reveal an achievement-->
[[Special:MyLanguage/Gaming:sendTo|Gaming:sendTo]] <br/>
+
[[Gaming:sendTo]] <br/><!--GIDEROSMTD:Gaming:sendTo()-->
[[Special:MyLanguage/Gaming:sendToAll|Gaming:sendToAll]] <br/>
+
[[Gaming:sendToAll]] <br/><!--GIDEROSMTD:Gaming:sendToAll()-->
[[Special:MyLanguage/Gaming:showAchievements|Gaming:showAchievements]] <br/>
+
[[Gaming:showAchievements]] ''show the achievements''<br/><!--GIDEROSMTD:Gaming:showAchievements() show the achievements-->
[[Special:MyLanguage/Gaming:showInvitations|Gaming:showInvitations]] <br/>
+
[[Gaming:showInvitations]] <br/><!--GIDEROSMTD:Gaming:showInvitations()-->
[[Special:MyLanguage/Gaming:showLeaderboard|Gaming:showLeaderboard]] <br/>
+
[[Gaming:showLeaderboard]] ''show a leaderboard''<br/><!--GIDEROSMTD:Gaming:showLeaderboard(leaderboardId) show a leaderboard-->
[[Special:MyLanguage/Gaming:showWaitingRoom|Gaming:showWaitingRoom]] <br/>
+
[[Gaming:showWaitingRoom]] ''display the waiting room''<br/><!--GIDEROSMTD:Gaming:showWaitingRoom() display the waiting room-->
[[Special:MyLanguage/Gaming:updateState|Gaming:updateState]] <br/>
+
[[Gaming:updateState]] ''update a save/state''<br/><!--GIDEROSMTD:Gaming:updateState(key,data,immediate) update a save/state-->
| style="width: 50%; vertical-align:top;"|
+
 
=== <translate>Events</translate> ===
+
|style="width: 50%; vertical-align:top;"|
[[Special:MyLanguage/Event.CONNECTED_TO_ROOM|Event.CONNECTED_TO_ROOM]]<br/>
+
=== Events ===
[[Special:MyLanguage/Event.DATA_RECEIVED|Event.DATA_RECEIVED]]<br/>
+
[[Event.CONNECTED_TO_ROOM]]<br/><!--GIDEROSEVT:Event.CONNECTED_TO_ROOM conntectedToRoom-->
[[Special:MyLanguage/Event.DISCONNECTED_FROM_ROOM|Event.DISCONNECTED_FROM_ROOM]]<br/>
+
[[Event.DATA_RECEIVED]]<br/><!--GIDEROSEVT:Event.DATA_RECEIVED dataReceived-->
[[Special:MyLanguage/Event.GAME_STARTED|Event.GAME_STARTED]]<br/>
+
[[Event.DISCONNECTED_FROM_ROOM]]<br/><!--GIDEROSEVT:Event.DISCONNECTED_FROM_ROOM disconntectedFromRoom-->
[[Special:MyLanguage/Event.INVITATION_RECEIVED|Event.INVITATION_RECEIVED]]<br/>
+
[[Event.GAME_STARTED]]<br/><!--GIDEROSEVT:Event.GAME_STARTED gameStarted-->
[[Special:MyLanguage/Event.JOINED_ROOM|Event.JOINED_ROOM]]<br/>
+
[[Event.INVITATION_RECEIVED]]<br/><!--GIDEROSEVT:Event.INVITATION_RECEIVED invitationReceived-->
[[Special:MyLanguage/Event.LEFT_ROOM|Event.LEFT_ROOM]]<br/>
+
[[Event.JOINED_ROOM]]<br/><!--GIDEROSEVT:Event.JOINED_ROOM joinedRoom-->
[[Special:MyLanguage/Event.LOAD_ACHIEVEMENTS_COMPLETE|Event.LOAD_ACHIEVEMENTS_COMPLETE]]<br/>
+
[[Event.LEFT_ROOM]]<br/><!--GIDEROSEVT:Event.LEFT_ROOM leftRoom-->
[[Special:MyLanguage/Event.LOAD_ACHIEVEMENTS_ERROR|Event.LOAD_ACHIEVEMENTS_ERROR]]<br/>
+
[[Event.LOAD_ACHIEVEMENTS_COMPLETE]]<br/><!--GIDEROSEVT:Event.LOAD_ACHIEVEMENTS_COMPLETE loadAchievementsComplete-->
[[Special:MyLanguage/Event.LOAD_SCORES_COMPLETE|Event.LOAD_SCORES_COMPLETE]]<br/>
+
[[Event.LOAD_ACHIEVEMENTS_ERROR]]<br/><!--GIDEROSEVT:Event.LOAD_ACHIEVEMENTS_ERROR loadAchievementsError-->
[[Special:MyLanguage/Event.LOAD_SCORES_ERROR|Event.LOAD_SCORES_ERROR]]<br/>
+
[[Event.LOAD_SCORES_COMPLETE]]<br/><!--GIDEROSEVT:Event.LOAD_SCORES_COMPLETE loadScoresComplete-->
[[Special:MyLanguage/Event.LOGIN_COMPLETE|Event.LOGIN_COMPLETE]]<br/>
+
[[Event.LOAD_SCORES_ERROR]]<br/><!--GIDEROSEVT:Event.LOAD_SCORES_ERROR loadScoresComplete-->
[[Special:MyLanguage/Event.LOGIN_ERROR|Event.LOGIN_ERROR]]<br/>
+
[[Event.LOGIN_COMPLETE]]<br/><!--GIDEROSEVT:Event.LOGIN_COMPLETE loginComplete-->
[[Special:MyLanguage/Event.PEER_CONNECTED|Event.PEER_CONNECTED]]<br/>
+
[[Event.LOGIN_ERROR]]<br/><!--GIDEROSEVT:Event.LOGIN_ERROR loginError-->
[[Special:MyLanguage/Event.PEER_DECLINED|Event.PEER_DECLINED]]<br/>
+
[[Event.PEER_CONNECTED]]<br/><!--GIDEROSEVT:Event.PEER_CONNECTED peerConnected-->
[[Special:MyLanguage/Event.PEER_DISCONNECTED|Event.PEER_DISCONNECTED]]<br/>
+
[[Event.PEER_DECLINED]]<br/><!--GIDEROSEVT:Event.PEER_DECLINED peerDeclined-->
[[Special:MyLanguage/Event.PEER_INVITED|Event.PEER_INVITED]]<br/>
+
[[Event.PEER_DISCONNECTED]]<br/><!--GIDEROSEVT:Event.PEER_DISCONNECTED peerDisconnected-->
[[Special:MyLanguage/Event.PEER_JOINED|Event.PEER_JOINED]]<br/>
+
[[Event.PEER_INVITED]]<br/><!--GIDEROSEVT:Event.PEER_INVITED peerInvited-->
[[Special:MyLanguage/Event.PEER_LEFT|Event.PEER_LEFT]]<br/>
+
[[Event.PEER_JOINED]]<br/><!--GIDEROSEVT:Event.PEER_JOINED peerJoined-->
[[Special:MyLanguage/Event.PLAYER_INFORMATION_COMPLETE|Event.PLAYER_INFORMATION_COMPLETE]]<br/>
+
[[Event.PEER_LEFT]]<br/><!--GIDEROSEVT:Event.PEER_LEFT peerLeft-->
[[Special:MyLanguage/Event.PLAYER_INFORMATION_ERROR|Event.PLAYER_INFORMATION_ERROR]]<br/>
+
[[Event.PLAYER_INFORMATION_COMPLETE]]<br/><!--GIDEROSEVT:Event.PLAYER_INFORMATION_COMPLETE playerInformationComplete-->
[[Special:MyLanguage/Event.PLAYER_SCORE_COMPLETE|Event.PLAYER_SCORE_COMPLETE]]<br/>
+
[[Event.PLAYER_INFORMATION_ERROR]]<br/><!--GIDEROSEVT:Event.PLAYER_INFORMATION_ERROR playerInformationError-->
[[Special:MyLanguage/Event.PLAYER_SCORE_ERROR|Event.PLAYER_SCORE_ERROR]]<br/>
+
[[Event.PLAYER_SCORE_COMPLETE]]<br/><!--GIDEROSEVT:Event.PLAYER_SCORE_COMPLETE playerScoreComplete-->
[[Special:MyLanguage/Event.REPORT_ACHIEVEMENT_COMPLETE|Event.REPORT_ACHIEVEMENT_COMPLETE]]<br/>
+
[[Event.PLAYER_SCORE_ERROR]]<br/><!--GIDEROSEVT:Event.PLAYER_SCORE_ERROR playerScoreError-->
[[Special:MyLanguage/Event.REPORT_ACHIEVEMENT_ERROR|Event.REPORT_ACHIEVEMENT_ERROR]]<br/>
+
[[Event.REPORT_ACHIEVEMENT_COMPLETE]]<br/><!--GIDEROSEVT:Event.REPORT_ACHIEVEMENT_COMPLETE reportAchievementComplete-->
[[Special:MyLanguage/Event.REPORT_SCORE_COMPLETE|Event.REPORT_SCORE_COMPLETE]]<br/>
+
[[Event.REPORT_ACHIEVEMENT_ERROR]]<br/><!--GIDEROSEVT:Event.REPORT_ACHIEVEMENT_ERROR reportAchievementError-->
[[Special:MyLanguage/Event.REPORT_SCORE_ERROR|Event.REPORT_SCORE_ERROR]]<br/>
+
[[Event.REPORT_SCORE_COMPLETE]]<br/><!--GIDEROSEVT:Event.REPORT_SCORE_COMPLETE reportScoreComplete-->
[[Special:MyLanguage/Event.ROOM_AUTO_MATCHING|Event.ROOM_AUTO_MATCHING]]<br/>
+
[[Event.REPORT_SCORE_ERROR]]<br/><!--GIDEROSEVT:Event.REPORT_SCORE_ERROR reportScoreError-->
[[Special:MyLanguage/Event.ROOM_CONNECTED|Event.ROOM_CONNECTED]]<br/>
+
[[Event.ROOM_AUTO_MATCHING]]<br/><!--GIDEROSEVT:Event.ROOM_AUTO_MATCHING roomAutoMatching-->
[[Special:MyLanguage/Event.ROOM_CONNECTING|Event.ROOM_CONNECTING]]<br/>
+
[[Event.ROOM_CONNECTED]]<br/><!--GIDEROSEVT:Event.ROOM_CONNECTED roomConnected-->
[[Special:MyLanguage/Event.ROOM_CREATED|Event.ROOM_CREATED]]<br/>
+
[[Event.ROOM_CONNECTING]]<br/><!--GIDEROSEVT:Event.ROOM_CONNECTING roomConnecting-->
[[Special:MyLanguage/Event.STATE_CONFLICT|Event.STATE_CONFLICT]]<br/>
+
[[Event.ROOM_CREATED]]<br/><!--GIDEROSEVT:Event.ROOM_CREATED roomCreated-->
[[Special:MyLanguage/Event.STATE_DELETED|Event.STATE_DELETED]]<br/>
+
[[Event.STATE_CONFLICT]]<br/><!--GIDEROSEVT:Event.STATE_CONFLICT stateConflict-->
[[Special:MyLanguage/Event.STATE_ERROR|Event.STATE_ERROR]]<br/>
+
[[Event.STATE_DELETED]]<br/><!--GIDEROSEVT:Event.STATE_DELETED stateDeleted-->
[[Special:MyLanguage/Event.STATE_LOADED|Event.STATE_LOADED]]<br/>
+
[[Event.STATE_ERROR]]<br/><!--GIDEROSEVT:Event.STATE_ERROR stateError-->
=== <translate>Constants</translate> ===
+
[[Event.STATE_LOADED]]<br/><!--GIDEROSEVT:Event.STATE_LOADED stateLoaded-->
[[Special:MyLanguage/Gaming.ALL_PLAYERS|Gaming.ALL_PLAYERS]]<br/>
+
=== Constants ===
[[Special:MyLanguage/Gaming.ALL_TIME|Gaming.ALL_TIME]]<br/>
+
[[Gaming.ALL_PLAYERS]]<br/><!--GIDEROSCST:Gaming.ALL_PLAYERS 1-->
[[Special:MyLanguage/Gaming.FRIENDS|Gaming.FRIENDS]]<br/>
+
[[Gaming.ALL_TIME]]<br/><!--GIDEROSCST:Gaming.ALL_TIME 2-->
[[Special:MyLanguage/Gaming.HIDDEN|Gaming.HIDDEN]]<br/>
+
[[Gaming.FRIENDS]]<br/><!--GIDEROSCST:Gaming.FRIENDS 0-->
[[Special:MyLanguage/Gaming.REVEALED|Gaming.REVEALED]]<br/>
+
[[Gaming.HIDDEN]]<br/><!--GIDEROSCST:Gaming.HIDDEN 2-->
[[Special:MyLanguage/Gaming.TODAY|Gaming.TODAY]]<br/>
+
[[Gaming.REVEALED]]<br/><!--GIDEROSCST:Gaming.REVEALED 1-->
[[Special:MyLanguage/Gaming.UNLOCKED|Gaming.UNLOCKED]]<br/>
+
[[Gaming.TODAY]]<br/><!--GIDEROSCST:Gaming.TODAY 0-->
[[Special:MyLanguage/Gaming.WEEK|Gaming.WEEK]]<br/>
+
[[Gaming.UNLOCKED]]<br/><!--GIDEROSCST:Gaming.UNLOCKED 0-->
 +
[[Gaming.WEEK]]<br/><!--GIDEROSCST:Gaming.WEEK 1-->
 
|}
 
|}
 +
 +
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 22:42, 7 December 2023

Supported platforms: Platform android.pngPlatform ios.png
Available since: Gideros 2012.09

Description

The Gaming class currently supports:

  • Gaming.new("googleplay") -- Android
  • Gaming.new("gamekit") -- iOS
require("gaming")

Loading the gaming module also creates a global class Gaming.

Methods

Gaming.new instantiate the Gaming plugin
Gaming:autoMatch
Gaming:deleteState remove the specified save/state
Gaming:getAllPlayers
Gaming:getPlayerId get the id of current player
Gaming:getPlayerInfo
Gaming:getPlayerName get the name of current player
Gaming:getPlayerPicture get the profile picture of current player
Gaming:getPlayerScore get the score of current player
Gaming:incrementAchievement increment the progress toward an achievement
Gaming:invitePlayers
Gaming:isLoggedIn return the login state in Gaming service
Gaming:joinRoom
Gaming:loadAchievements load all achievements
Gaming:loadPlayerCenteredScores load a leaderboard centered on the player
Gaming:loadScores load a leaderboard
Gaming:loadState load a save/state
Gaming:login log in the Gaming service
Gaming:logout log out of the gaming service
Gaming:reportAchievement report an achievement progress
Gaming:reportScore report a new score
Gaming:resolveState resolve a save/state conflict
Gaming:revealAchievement reveal an achievement
Gaming:sendTo
Gaming:sendToAll
Gaming:showAchievements show the achievements
Gaming:showInvitations
Gaming:showLeaderboard show a leaderboard
Gaming:showWaitingRoom display the waiting room
Gaming:updateState update a save/state

Events

Event.CONNECTED_TO_ROOM
Event.DATA_RECEIVED
Event.DISCONNECTED_FROM_ROOM
Event.GAME_STARTED
Event.INVITATION_RECEIVED
Event.JOINED_ROOM
Event.LEFT_ROOM
Event.LOAD_ACHIEVEMENTS_COMPLETE
Event.LOAD_ACHIEVEMENTS_ERROR
Event.LOAD_SCORES_COMPLETE
Event.LOAD_SCORES_ERROR
Event.LOGIN_COMPLETE
Event.LOGIN_ERROR
Event.PEER_CONNECTED
Event.PEER_DECLINED
Event.PEER_DISCONNECTED
Event.PEER_INVITED
Event.PEER_JOINED
Event.PEER_LEFT
Event.PLAYER_INFORMATION_COMPLETE
Event.PLAYER_INFORMATION_ERROR
Event.PLAYER_SCORE_COMPLETE
Event.PLAYER_SCORE_ERROR
Event.REPORT_ACHIEVEMENT_COMPLETE
Event.REPORT_ACHIEVEMENT_ERROR
Event.REPORT_SCORE_COMPLETE
Event.REPORT_SCORE_ERROR
Event.ROOM_AUTO_MATCHING
Event.ROOM_CONNECTED
Event.ROOM_CONNECTING
Event.ROOM_CREATED
Event.STATE_CONFLICT
Event.STATE_DELETED
Event.STATE_ERROR
Event.STATE_LOADED

Constants

Gaming.ALL_PLAYERS
Gaming.ALL_TIME
Gaming.FRIENDS
Gaming.HIDDEN
Gaming.REVEALED
Gaming.TODAY
Gaming.UNLOCKED
Gaming.WEEK