| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| gamedev:service_steamsdk [2024/09/08 14:32] – dragonlord | gamedev:service_steamsdk [2024/09/08 15:58] (current) – dragonlord |
|---|
| {{tag>dragonscript utils}} | {{tag>service steam steamworks dragonscript}} |
| <WRAP youarehere> | <WRAP youarehere> |
| [[:start|Start Page]] >> [[:gamedev|Game Development with the Drag[en]gine]] >> **Steam SDK** | [[:start|Start Page]] >> [[:gamedev|Game Development with the Drag[en]gine]] >> [[:gamedev:servicemodules#service_listing|Service Listing]] >> **Steam SDK** |
| </WRAP> | </WRAP> |
| |
| * #@LinkApiDocDEDS2_HTML~interfaceDragengine_1_1Services_1_1Stats_1_1ServiceStats,ServiceStats~@# | * #@LinkApiDocDEDS2_HTML~interfaceDragengine_1_1Services_1_1Stats_1_1ServiceStats,ServiceStats~@# |
| |
| ===== Initialization ===== | ====== Initialization ====== |
| |
| ==== Automatic ==== | ===== Automatic ===== |
| |
| The #@LinkApiDocDEDS2_HTML~classDragengine_1_1BaseGameApp,BaseGameApp~@# class automatically creates the SteamSDK service instance if the following values are present in the ''configuration.ptree.xml'' file: | The #@LinkApiDocDEDS2_HTML~classDragengine_1_1BaseGameApp,BaseGameApp~@# class automatically creates the SteamSDK service instance if the following values are present in the ''configuration.ptree.xml'' file: |
| <code ds> | <code ds> |
| if getBaseGameServices().getSteam() != null | if getBaseGameServices().getSteam() != null |
| // SteamSDK is ready to be used | // ServiceSteam is ready to be used |
| end | end |
| </code> | </code> |
| |
| ==== Manual ==== | ===== Manual ===== |
| |
| The SteamSDK service can be manually created either by using the ''new'' constructor on the #@LinkApiDocDEDS2_HTML~classDragengine_1_1Services_1_1ServiceSteam,ServiceSteam~@# class using #@LinkApiDocDEDS2_HTML~classDragengine_1_1Services_1_1ServiceSteam_1_1InitParameters,ServiceSteam.InitParameters~@# setup with the initialization data or by calling ''initSteam()'' on #@LinkApiDocDEDS2_HTML~classDragengine_1_1BaseGameApp,BaseGameApp~@#. Using ''initSteam'' is preferred if manual creation is required. | The SteamSDK service can be manually created either by using the ''new'' constructor on the #@LinkApiDocDEDS2_HTML~classDragengine_1_1Services_1_1ServiceSteam,ServiceSteam~@# class using #@LinkApiDocDEDS2_HTML~classDragengine_1_1Services_1_1ServiceSteam_1_1InitParameters,ServiceSteam.InitParameters~@# setup with the initialization data or by calling ''initSteam()'' on #@LinkApiDocDEDS2_HTML~classDragengine_1_1BaseGameApp,BaseGameApp~@#. Using ''initSteam'' is preferred if manual creation is required. |
| |
| ===== Functionality ===== | ====== ServiceUser ====== |
| |
| ==== ServiceUser ==== | The service module provides user management support. Supported is only retrieving user information and user resources. |
| |
| The service module provides user management support. Supported is only retrieving user information and user resources. The user can not be logged in or out since a Steam user is always logged in as soon as Steam is running. | ===== Login ===== |
| |
| The service module provides also ''Authentification Provider'' support to other modules. The provider has the unique identifier ''steam''. This feature allows other service modules to link accounts to the logged in Steam user. For this to work you have to call ''getAuthToken()'' to asynchronously retrieve an authentification token. Once received in the listener this token can be used on other service modules supporting linking with Steam user accounts. | The user can not be logged in or out since a Steam user is always logged in as soon as Steam is running. |
| |
| ==== ServiceStats ==== | ===== Authentication Provider ===== |
| | |
| | The service module provides also ''Authentication Provider'' support to other modules. The provider has the unique identifier ''steam''. This feature allows other service modules to link accounts to the logged in Steam user. For this to work you have to call ''getAuthToken()'' to asynchronously retrieve an authentication token. Once received in the listener this token can be used on other service modules supporting linking with Steam user accounts. |
| | |
| | ====== ServiceStats ====== |
| |
| The service module provides achievement and statistics support. Use ''setStatsAndAchievements()'' to set the value of individual statistics. Once the requirements are fulfilled server side the respective achievements will be unlocked. You can also use the same function to manually unlock achievements. Use ''getStatsAndAchievements()'' to retrieve the current stats and achievements state. | The service module provides achievement and statistics support. Use ''setStatsAndAchievements()'' to set the value of individual statistics. Once the requirements are fulfilled server side the respective achievements will be unlocked. You can also use the same function to manually unlock achievements. Use ''getStatsAndAchievements()'' to retrieve the current stats and achievements state. |
| |
