Service providing access to Microsoft GDK functionality if supported. More...

Inheritance diagram for Dragengine.Services.ServiceMsgdk:

Classes
class	InitParameters
	Service initialization parameters. More...

Public Member Functions
void	addStatListener (ServiceStatsListener listener)
	Add stats and achievements listener. More...

void	dispose ()
	Dispose of Microsoft GDK service. More...

BaseServiceConversions	getConversions ()
	Conversion helper. More...

void	getStatsAndAchievements (Set stats, Set achievements, ServiceStatsListener listener)
	Get stats and achievements. More...

ServiceUserFeatures	getUserFeatures ()
	Features supported by this service. More...

void	getUserInfo (ServiceUserListener listener)
	Retrieve user information. More...

void	getUserWalletBalance (ServiceUserListener listener)
	Retrieve user wallet balance. More...

void	loginUser (ServiceUserCredentials credentials, ServiceUserListener listener)
	Log in user. More...

void	logoutUser (ServiceUserListener listener)
	Log out user. More...

ServiceMsgdk	new (InitParameters params)
	Create service ServiceMsgdk. More...

void	removeStatsListener (ServiceStatsListener listener)
	Remove stats and achievements listener. More...

void	requestResponse (Service service, UniqueID id, ServiceObject response, bool finished)
	Response received for request. More...

Public Member Functions inherited from Dragengine.Services.Stats.ServiceStats
void	resetAllStats (bool resetAchievements)
	Reset all stats on service provider. More...

void	setStatsAndAchievements (Dictionary stats, Dictionary achievements, ServiceStatsListener listener)
	Set stats and achievements. More...

Public Member Functions inherited from Dragengine.Services.User.ServiceUser
void	addUserListener (ServiceUserListener listener)
	Add user listener. More...

void	getAuthToken (ServiceUserListener listener)
	Request authentification token. More...

bool	isUserLoggedIn ()
	User is logged in. More...

void	loadUserResource (String url, ServiceUserListener listener)
	Load resource asynchronously. More...

void	removeUserListener (ServiceUserListener listener)
	Remove user listener. More...

void	reportUser (String id, ServiceUserReport report, ServiceUserListener listener)
	Report user. More...

Public Member Functions inherited from Dragengine.ServiceListener
void	eventReceived (Service service, ServiceObject event)
	Service event received for example notifications. More...

void	requestFailed (Service service, UniqueID id, ServiceObject error)
	Request failed. More...

Static Public Member Functions
static bool	isServiceSupported ()
	Checks if Microsoft GDK service is supported. More...

Public Attributes
BaseServiceConversions	pConversions

InitParameters	pInitParameters

Dictionary	pOnceListeners

Service	pService

SafeArray	pStatsListeners

Static Public Attributes
static final String	authProviderId = "xboxLive"
	Authentification provider identifier. More...

Detailed Description

Service providing access to Microsoft GDK functionality if supported.

Version: 1.23

Provides access to these functionalities:

Stats/Achievements
User

Member Function Documentation

◆ addStatListener()

void Dragengine.Services.ServiceMsgdk.addStatListener ( ServiceStatsListener listener )

Add stats and achievements listener.

Parameters

listener Listener to add

Implements Dragengine.Services.Stats.ServiceStats.

◆ dispose()

void Dragengine.Services.ServiceMsgdk.dispose ( )

Dispose of Microsoft GDK service.

◆ getConversions()

BaseServiceConversions Dragengine.Services.ServiceMsgdk.getConversions ( )

Conversion helper.

◆ getStatsAndAchievements()

void Dragengine.Services.ServiceMsgdk.getStatsAndAchievements	(	Set	stats,
		Set	achievements,
		ServiceStatsListener	listener
	)

Get stats and achievements.

Requests from the service provider the set of stats and achievements with the matching api names. Once retrieved calls ServiceStatsListener::onGetStats().

Parameters

stats	Stats.
achievements	Achievements.
listener	If not null called once in addition to added listeners.

Implements Dragengine.Services.Stats.ServiceStats.

◆ getUserFeatures()

ServiceUserFeatures Dragengine.Services.ServiceMsgdk.getUserFeatures ( )

Features supported by this service.

Implements Dragengine.Services.User.ServiceUser.

◆ getUserInfo()

void Dragengine.Services.ServiceMsgdk.getUserInfo ( ServiceUserListener listener )

Retrieve user information.

Parameters

listener If not null called once in addition to added listeners.

Implements Dragengine.Services.User.ServiceUser.

◆ getUserWalletBalance()

void Dragengine.Services.ServiceMsgdk.getUserWalletBalance ( ServiceUserListener listener )

Retrieve user wallet balance.

Can be used if ServiceUserFeatures::hasMarketplace is true.

Parameters

listener If not null called once in addition to added listeners.

Implements Dragengine.Services.User.ServiceUser.

◆ isServiceSupported()

static bool Dragengine.Services.ServiceMsgdk.isServiceSupported ( )

static

Checks if Microsoft GDK service is supported.

Service is reported supported if the Microsoft GDK Service Module is present. Creating the service can still fail if Microsoft GDK can not be initialized.

◆ loginUser()

void Dragengine.Services.ServiceMsgdk.loginUser	(	ServiceUserCredentials	credentials,
		ServiceUserListener	listener
	)

Log in user.

User can be logged in automatically or manually.

Automatic logging in is used for example Steam where the user has to log into the platform before the game can be launched. Automatic logging in can trigger platform specific log in procedure and terms acknowledge process. Typically this has to be done once and then logging in is automatic.

Manual logging in requires the game to obtain the credentials from the user. This can be useful for developers to not enter credentials each time they launch the game. Production games usually do not require manual logging in unless the service in question does not support automatic logging in.

Manual logging in is also possible using authentification tokens from other services. For example a user can log into certain services using his Steam user account. See ServiceUserFeatures::canAuthProviderLogin obtained from getUserFeatures() to know which other services are supported for manual login using auth tokens.

Once logging in finished ServiceUserListener::onLoginUser() is called.

Parameters

credentials	Credentials for manual logging in. Use null for automatic logging in.
listener	If not null called once in addition to added listeners.

Implements Dragengine.Services.User.ServiceUser.

◆ logoutUser()

void Dragengine.Services.ServiceMsgdk.logoutUser ( ServiceUserListener listener )

Log out user.

Once logging out finished ServiceUserListener::onLogoutUser() is called.

Parameters

listener If not null called once in addition to added listeners.

Implements Dragengine.Services.User.ServiceUser.

◆ new()

ServiceMsgdk Dragengine.Services.ServiceMsgdk.new ( InitParameters params )

Create service ServiceMsgdk.

Parameters

params Init parameters.

Exceptions

EInvalidParam	Microsoft GDK service module is not present.
EInvalidAction	Microsoft GDK can not be initialized.

◆ removeStatsListener()

void Dragengine.Services.ServiceMsgdk.removeStatsListener ( ServiceStatsListener listener )

Remove stats and achievements listener.

Parameters

listener Listener to remove.

Implements Dragengine.Services.Stats.ServiceStats.

◆ requestResponse()

void Dragengine.Services.ServiceMsgdk.requestResponse	(	Service	service,
		UniqueID	id,
		ServiceObject	response,
		bool	finished
	)

Response received for request.

Parameters

service	Service receiving the response.
id	Identifier of request this response belongs to.
response	Response data.
finished	True if the request finished or false if more responses will be received.

Implements Dragengine.ServiceListener.

Member Data Documentation

◆ authProviderId

final String Dragengine.Services.ServiceMsgdk.authProviderId = "xboxLive"

static

Authentification provider identifier.

◆ pConversions

BaseServiceConversions Dragengine.Services.ServiceMsgdk.pConversions

◆ pInitParameters

InitParameters Dragengine.Services.ServiceMsgdk.pInitParameters

◆ pOnceListeners

Dictionary Dragengine.Services.ServiceMsgdk.pOnceListeners

◆ pService

Service Dragengine.Services.ServiceMsgdk.pService

◆ pStatsListeners

SafeArray Dragengine.Services.ServiceMsgdk.pStatsListeners

The documentation for this class was generated from the following file:

ServiceMsgdk.ds

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Member Function Documentation

◆ addStatListener()

◆ dispose()

◆ getConversions()

◆ getStatsAndAchievements()

◆ getUserFeatures()

◆ getUserInfo()

◆ getUserWalletBalance()

◆ isServiceSupported()

◆ loginUser()

◆ logoutUser()

◆ new()

◆ removeStatsListener()

◆ requestResponse()

Member Data Documentation

◆ authProviderId

◆ pConversions

◆ pInitParameters

◆ pOnceListeners

◆ pService

◆ pStatsListeners