BrainCloudServiceClient Class

Initializes a new instance of the BrainCloudServiceClient class

Initializes a new instance of the BrainCloudServiceClient class

Marks the given match as abandoned.

Marks the given match as complete.

Creates an instance of an asynchronous match.

Creates an instance of an asynchronous match with an initial turn.

Removes the match and match history from the server. DEBUG ONLY, in production it is recommended the user leave it as completed.

Returns all matches that are in a COMPLETE state for which the player is involved.

Returns all matches that are NOT in a COMPLETE state for which the player is involved.

Returns the current state of the given match.

Returns the match history of the given match.

Submits a turn for the given match.

Allows the current player (only) to update Summary data without having to submit a whole turn.

Authenticate a user anonymously with brainCloud - used for apps that don't want to bother the user to login, or for users who are sensitive to their privacy

Authenticate the user with a custom Email and Password. Note that the client app is responsible for collecting (and storing) the e-mail and potentially password (for convenience) in the client data. For the greatest security, force the user to re-enter their password at each login. (Or at least give them that option).

Authenticate the user via cloud code (which in turn validates the supplied credentials against an external system). This allows the developer to extend brainCloud authentication to support other backend authentication systems.

Authenticate the user via wechat

Authenticate the user using a userId and password (without any validation on the userId). Similar to AuthenticateEmailPassword - except that that method has additional features to allow for e-mail validation, password resets, etc.

Authenticate the user via wechat

Used to clear the saved profile id - to use in cases when the user is attempting to switch to a different app profile.

Used to create the anonymous installation id for the brainCloud profile.

@Authentication_GetWeChatQRPageURL_desc

Initialize - initializes the identity service with a saved anonymous installation id and most recently used profile id

Request an SMS code sent to a phone prior to authentication.

Reset Email password - Sends a password reset email to the specified address

Enable logging of brainCloud transactions (comms etc)

Enables the timeout message caching which is disabled by default. Once enabled, if a client side timeout is encountered (i.e. brainCloud server is unreachable presumably due to the client network being down) the SDK will do the following: 1 - cache the currently queued messages to brainCloud 2 - call the network error callback 3 - then expect the app to call either: a) RetryCachedMessages() to retry sending to brainCloud b) FlushCachedMessages() to dump all messages in the queue. Between steps 2 and 3, the app can prompt the user to retry connecting to brainCloud to determine whether to follow path 3a or 3b. Note that if path 3a is followed, and another timeout is encountered, the process will begin all over again from step 1. WARNING - the brainCloud SDK will cache *all* API calls sent when a timeout is encountered if this mechanism is enabled. This effectively freezes all communication with brainCloud. Apps must call either RetryCachedMessages() or FlushCachedMessages() for the brainCloud SDK to resume sending messages. ResetCommunication() will also clear the message cache.

Flushes the cached messages to resume API call processing. This will dump all of the cached messages in the queue.

Gets the authentication packet timeout which is tracked separately from all other packets. Note that authentication packets are never retried and so this value represents the total time a client would wait to receive a reply to an authentication API call. By default this timeout is set to 15 seconds.

Returns the list of packet timeouts.

Returns the sessionId or empty string if no session present.

Returns the low transfer rate threshold in bytes/sec

Returns the low transfer rate timeout in secs

Method initializes the BrainCloudClient.

Method initializes the BrainCloudClient.

Initialize the identity aspects of brainCloud.

Inserts a marker which will tell the brainCloud comms layer to close the message bundle off at this point. Any messages queued before this method was called will likely be bundled together in the next send to the server. To ensure that only a single message is sent to the server you would do something like this: InsertEndOfMessageBundleMarker() SomeApiCall() InsertEndOfMessageBundleMarker()

Returns true if the user is currently authenticated. If a session time out or session invalidation is returned from executing a sever API call, this flag will reset back to false.

Returns true if brainCloud has been initialized.

Sets the country code sent to brainCloud when a user authenticates. Will override any auto detected country.

Sets the language code sent to brainCloud when a user authenticates. If the language is set to a non-ISO 639-1 standard value the game default will be used instead. Will override any auto detected language.

Resets all messages and calls to the server

Attempts to resend any cached messages. If no messages are in the cache, this method does nothing.

Sets the authentication packet timeout which is tracked separately from all other packets. Note that authentication packets are never retried and so this value represents the total time a client would wait to receive a reply to an authentication API call. By default this timeout is set to 15 seconds.

Sets the packet timeouts back to default.

Sets the low transfer rate threshold of an upload in bytes/sec. If the transfer rate dips below the given threshold longer than the specified timeout, the transfer will fail. By default this is set to 50 bytes/sec. Note that this timeout method does not work on Unity mobile platforms.

Sets the timeout in seconds of a low speed upload (i.e. transfer rate which is underneath the low transfer rate threshold). By default this is set to 120 secs.Setting this value to 0 will turn off the timeout. Note that this timeout method does not work on Unity mobile platforms.

Update method needs to be called regularly in order to process incoming and outgoing messages.

Creates custom data stream page event

Creates custom data stream screen event

Creates custom data stream track event

Method creates a new entity on the server.

Method deletes the given entity on the server.

Method deletes the given singleton on the server.

Method returns all user entities that match the given type.

Method to get a specific entity.

Method gets list of entities from the server base on type and/or where clause

Method gets a count of entities based on the where clause

Method uses a paging system to iterate through user entities. After retrieving a page of entities with this method, use GetPageOffset() to retrieve previous or next pages.

Method to retrieve previous or next pages after having called the GetPage method.

Method returns all shared entities for the given profile id. An entity is shared if its ACL allows for the currently logged in user to read the data.

Method gets list of shared entities for the specified user based on type and/or where clause

Method returns a shared entity for the given profile and entity ID. An entity is shared if its ACL allows for the currently logged in user to read the data.

Method retrieves a singleton entity on the server. If the entity doesn't exist, null is returned.

Partial increment of shared entity data field items. Partial set of items incremented as specified.

Partial increment of entity data field items. Partial set of items incremented as specified.

Method updates a new entity on the server. This operation results in the entity data being completely replaced by the passed in JSON string.

Method updates a shared entity owned by another user. This operation results in the entity data being completely replaced by the passed in JSON string.

Method updates a singleton entity on the server. This operation results in the entity data being completely replaced by the passed in JSON string. If the entity doesn't exist it is created.

Delete an event out of the user's incoming mailbox.

Get the events currently queued for the user.

Sends an event to the designated profile id with the attached json data. Any events that have been sent to a user will show up in their incoming event mailbox. If the recordLocally flag is set to true, a copy of this event (with the exact same event id) will be stored in the sending user's "sent" event mailbox.

Updates an event in the user's incoming event mailbox.

@BrainCloud_CancelDownload_desc

Method cancels an upload. If an IFileUploadCallback has been registered with the BrainCloudClient class, the fileUploadFailed callback method will be called once the upload has been canceled. NOTE: The upload will still continue in the background on versions of Unity before 5.3 and on Unity mobile platforms.

Deletes a single user file.

Delete multiple user files

@BrainCloud_DownloadFile_desc

Returns the CDN URL for a file object.

@BrainCloud_GetDownloadInfo_desc

Returns the number of bytes uploaded or -1 if upload not found. NOTE: This will always return the total bytes to transfer on Unity mobile platforms.

Returns the progress of the given upload from 0.0 to 1.0 or -1 if upload not found. NOTE: This will always return 1 on Unity mobile platforms.

Returns the total number of bytes that will be uploaded or -1 if upload not found.

List all user files

List user files from the given cloud path

Prepares a user file upload. On success the file will begin uploading to the brainCloud server.To be informed of success/failure of the upload register an IFileUploadCallback with the BrainCloudClient class.

Finds a list of users matching the search text by performing an exact search of all user names.

Finds a list of users matching the search text by performing a substring search of all user names.

Returns user state of the player's friends.

Returns user state of a particular user.

Returns user state of player's recently met.

Returns a particular entity of a particular friend.

Returns entities of all friends based on type and/or subtype.

Returns user state of a particular friend.

Method retrives the list of achieved achievements.

Read all of the achievements defined for the game.

Method retrieves all gamification data for the player.

Method retrieves the list of completed milestones.

Method returns all completed quests.

Method retrieves the list of in progress milestones

Method returns all in progress quests.

Method retrieves all milestones defined for the game.

Method retrieves milestones of the given category.

Method returns all quests that haven't been started.

Method retrieves all of the quests defined for the game.

Method returns all quests for the given category.

Method returns all quests with a basic percentage.

Method returns all quests with a complex percentage.

Method returns all quests with status.

Method returns all defined xp levels and any rewards associated with those xp levels.

Method reads all the global properties of the game

Method creates a new entity on the server.

Method creates a new entity on the server with an indexed id.

Method deletes an existing entity on the server.

Method gets list of entities from the server base on type and/or where clause

Method gets list of entities from the server base on indexed id

Method gets a count of entities based on the where clause

Method uses a paging system to iterate through Global Entities. After retrieving a page of Global Entities with this method, use GetPageOffset() to retrieve previous or next pages.

Method to retrieve previous or next pages after having called the GetPage method.

Gets a list of up to randomCount randomly selected entities from the server based on the where condition and specified maximum return count.

Partial increment of global entity data field items. Partial set of items incremented as specified.

Method reads an existing entity from the server.

Method updates an existing entity's Acl on the server.

Method updates an existing entity on the server.

Method updates an existing entity's time to live on the server.

Atomically increment (or decrement) global statistics. Global statistics are defined through the brainCloud portal.

Method returns all of the global statistics.

Method retrieves the global statistics for the given category.

Accept an outstanding invitation to join the group.

Cancel an outstanding invitation to the group.

Delete a group.

Delete a group entity.

Read information on groups to which the current user belongs.

Increment elements for the group's data field.

Increment elements for the group entity's data field.

Join an open group or request to join a closed group.

Leave a group in which the user is a member.

Retrieve a page of group summary information based on the specified context.

Retrieve a page of group summary information based on the encoded context and specified page offset.

Read information on groups to which the specified user belongs. Access is subject to restrictions.

Read the specified group.

Read the data of the specified group.

Read a page of group entity information.

Read a page of group entity information.

Read the specified group entity.

Read the members of the group.

Reject an outstanding invitation to join the group.

Reject an outstanding request to join the group.

Remove a member from the group.

Updates a group's data.

Update a group entity.

Updates a group's name.

Attach a Email and Password identity to the current profile.

Attach a new identity to a parent app

Attaches a peer identity to this user's profile

Attach a Universal (userId + password) identity to the current profile.

Allows email identity email address to be changed

Detach the e-mail identity from the current profile

Detaches parent from this user's profile

Detaches a peer identity from this user's profile

Detach the universal identity from the current profile

Returns a list of all child profiles in child Apps

Retrieve list of expired identities

Retrieve list of identities

Retrieves a list of attached peer profiles

Merge the profile associated with the provided e=mail with the current profile.

Merge the profile associated with the provided e=mail with the current profile.

Refreshes an identity for this user

Switch to a Child Profile

Switch to a Parent Profile

Switches to the child profile of an app when only one profile exists If multiple profiles exist this returns an error

Close a lobby so players can't join.

Destroy a lobby.

Find lobbies with the player's friends in them.

Find lobbies the player can join.

Get a list of lobbies the player is a member of.

Join a lobby.

Leave a lobby.

Open a lobby so players can join.

Start a lobby game.

Sends an advanced email to the specified user

Sends an advanced email to the specified email address

Sends a simple text email to the specified user

Decrements player rating

Disables Match Making for the Player

Enables Match Making for the Player

Finds matchmaking enabled players

Finds matchmaking enabled players using a cloud code filter

Finds matchmaking enabled players with additional attributes

Finds matchmaking enabled players using a cloud code filter and additional attributes

Gets the shield expiry for the given player id. Passing in a null player id will return the shield expiry for the current player. The value returned is the time in UTC millis when the shield will expire.

Increments player rating

Increases the shield on time by specified number of minutes

Read match making record

Resets player rating

Sets player rating

Turns shield off

Turns shield on

Turns shield on for the specified number of minutes

Cancels a match

Completes a match

Starts a match

Adds a stream event

Deletes a stream

Ends a stream

Gets recent streams for initiating player

Gets recent streams for target player

Reads a stream

Starts a stream

Completely deletes the user record and all data fully owned by the user. After calling this method, the user will need to re-authenticate and create a new profile. This is mostly used for debugging/qa.

Retrieve the user's attributes.

Logs user out of server.

Read the state of the currently logged in user. This method returns a JSON object describing most of the player's data: entities, statistics, level, currency. Apps will typically call this method after authenticating to get an up-to-date view of the user's data.

This method will delete *most* data for the currently logged in user. Data which is not deleted includes: currency, credentials, and purchase transactions. ResetUser is different from DeleteUser in that the player record will continue to exist after the reset (so the user does not need to re-authenticate).

Update user's attributes.

Update the user's contact email. Note this is unrelated to email authentication.

Updates the "friend summary data" associated with the logged in user. Some operations will return this summary data. For instance the social leaderboards will return the player's score in the leaderboard along with the friend summary data. Generally this data is used to provide a quick overview of the player without requiring a separate API call to read their public stats or entity data.

Sets the user name.

Updates player's picture URL.

Returns JSON representing the next experience level for the user.

Increments the user's experience. If the user goes up a level, the new level details will be returned along with a list of rewards.

Atomically increment (or decrement) user statistics. Any rewards that are triggered from user statistic increments will be considered. User statistics are defined through the brainCloud portal. Note also that the "xpCapped" property is returned (true/false depending on whether the xp cap is turned on and whether the user has hit it).

Read all available user statistics.

Method retrieves the user statistics for the given category.

Reset all of the statistics for this user back to their initial value.

Sets the user's experience to an absolute value. Note that this is simply a set and will not reward the user if their level changes as a result.

Trigger an event server side that will increase the user statistics. This may cause one or more awards to be sent back to the user - could be achievements, experience, etc. Achievements will be sent by this client library to the appropriate awards service (Apple Game Center, etc). This mechanism supercedes the PlayerStatisticsService API methods, since PlayerStatisticsService API method only update the raw statistics without triggering the rewards.

See documentation for TriggerStatsEvent for more documentation.

Gets the player's currency for the given currency type or all currency types if null passed in.

Returns the eligible promotions for the player.

Method gets the active sales inventory for the passed-in currency type.

Method gets the active sales inventory for the passed-in currency type and category.

Verify ITunes Receipt. On success, the player will be awarded the associated currencies.

Verify Microsoft Receipt. On success, the player will be awarded the associated currencies.

Checks supplied text for profanity.

Checks supplied text for profanity and returns a list of bad wors.

Replaces the characters of profanity text with a passed character(s).

Deregisters all device tokens currently registered to the user.

Deregisters the given device token from the server to disable this device from receiving push notifications.

Registers the given device token with the server to enable this device to receive push notifications.

Schedules a normalized push notification to a user

Schedules a normalized push notification to a user

Schedules raw notifications based on user local time.

Schedules raw notifications based on user local time.

Schedules a rich push notification to a user

Schedules a rich push notification to a user

Sends a notification to a user consisting of alert content and custom data.

Sends a notification to a "group" of user based on a brainCloud portal configured notification template. Includes JSON defining the substitution params to use with the template. See the Portal documentation for more info.

Sends a raw push notification to a target user.

Sends a raw push notification to a target group.

Sends a notification to a user based on a brainCloud portal configured notification template. NOTE: It is possible to send a push notification to oneself.

Sends a notification to a user based on a brainCloud portal configured notification template. Includes JSON defining the substitution params to use with the template. See the Portal documentation for more info. NOTE: It is possible to send a push notification to oneself.

Sends a simple push notification based on the passed in message. NOTE: It is possible to send a push notification to oneself.

Sends a notification to a "group" of user based on a brainCloud portal configured notification template. Includes JSON defining the substitution params to use with the template. See the Portal documentation for more info.

Cancels a scheduled cloud code script

Run a cloud script in a parent app

Runs a script from the context of a peer

Runs a script asynchronously from the context of a peer This operation does not wait for the script to complete before returning

Executes a script on the server.

Allows cloud script executions to be scheduled

Add a product to the player's shopping cart.

Add an item to the player's wishlist.

Empty the player's shopping cart.

Remove all items from the player's wishlist.

@2222188570

Retrieve the player's current shopping cart.

Return a list of featured products.

@2304250631

@919332756

@274383141

Returns the current player's wishlist.

Return a list of the mos tpopular products.

@1350446922

@2681224790

@3387279661

Return a list of recently created products.

Return a list of recently updated products.

@2681224790

Return a list of special offers.

Get a list of user reviews for a product.

@1777617418

Returns the specified player's wishlist.

@3972606582

Remove an item from the player's shopping cart.

Remove an item from the player's wishlist.

@2944656417

Submit a user review of a product.

@3717774610

@2806051775

@594218927

Gets the number of entries in a global leaderboard

Gets the number of entries in a global leaderboard

Gets the global leaderboard versions.

Retrieve the social leaderboard for a group.

Gets a player's score from a leaderboard

Method returns the social leaderboard. A player's social leaderboard is comprised of players who are recognized as being your friend. For now, this applies solely to Facebook connected players who are friends with the logged in player (who also must be Facebook connected). In the future this will expand to other identification means (such as Game Centre, Google circles etc). Leaderboards entries contain the player's score and optionally, some user-defined data associated with the score. The currently logged in player will also be returned in the social leaderboard. Note: If no friends have played the game, the bestScore, createdAt, updatedAt will contain NULL.

Retrieve a list of all leaderboards

Post the players score to the given social leaderboard. You can optionally send a user-defined json string of data with the posted score. This string could include information relevant to the posted score. Note that the behaviour of posting a score can be modified in the brainCloud portal. By default, the server will only keep the player's best score.

Removes a player's score from the leaderboard

Method returns the server time in UTC. This is in UNIX millis time format. For instance 1396378241893 represents 2014-04-01 2:50:41.893 in GMT-4.

Processes any outstanding rewards for the given player

Get tournament status associated with a leaderboard

Join the specified tournament. Any entry fees will be automatically collected.

Removes player's score from tournament leaderboard

Returns the user's expected reward based on the current scores

Returns the user's reward from a finished tournament