Difference between revisions of "Cloud Global"
From Virtual World Web Wiki
(Documentation for the Cloud Global class) |
(Documentation for the Cloud Global class) |
||
Line 42: | Line 42: | ||
::Checkpoints your app data. Just in case. | ::Checkpoints your app data. Just in case. | ||
− | :{{CSharp|void SetApplication(string | + | :{{CSharp|void SetApplication(string identifier)}} |
:: | :: | ||
::Associates this script with an application (scope of data storage). A single call to this function is required before most other GameCloud functions will work. Simply pass a Guid as a string. | ::Associates this script with an application (scope of data storage). A single call to this function is required before most other GameCloud functions will work. Simply pass a Guid as a string. | ||
Line 49: | Line 49: | ||
:: | :: | ||
::Sets the value of an application-scoped data item. This is basic global application string data storage. | ::Sets the value of an application-scoped data item. This is basic global application string data storage. | ||
+ | |||
+ | :{{CSharp|void SetOrCreateApplication(string identifier, Guid applicationID)}} | ||
+ | :: | ||
+ | ::Similar to SetApplication, but will also create the application with the known GUID application ID. This is useful for scripts that auto-create their application if it doesn't exist, and ensures the application always has the same ID so it can be transferred reliably between systems. | ||
__NOTOC____NOEDITSECTION__ | __NOTOC____NOEDITSECTION__ |
Revision as of 14:41, 5 April 2018
The Cloud JavaScript global object is available from server world scripts and is the main entry point for the GameCloud functionality.
- This is a JavaScript global object named Cloud
Remarks [edit]
Methods
- EngagementExtended CreateEngagement()
- Creates a new engagement which wraps a state machine and can be used to help coordinate complex player interactions
- bool DataExists(string key)
- Checks if an application scoped data item exists (is set).
- void DeleteData(string key)
- Deletes the specified application scoped data item.
- CloudCurrencyExtended GetCurrency(string identifier, bool accountScoped = true)
- Gets or creates a currency for use in your javascript applications. The returned object can be used to transact in this currency, and get balance of accounts.
- string GetData(string key)
- Gets the value of an application scoped data item.
- ReturnType GetMetadata(string key)
- Gets the value of an application metadata item
- DOMObjectExtended Instantiate(DOMObjectExtended parent, Guid objectTypeID)
- Instantiates a new reference to the specified object type and adds it as a child of the provided DOM object
- InteractionMappingExtended RegisterInteraction(string selector, string abilityIdentifier, string groupIdentifier = NULL, string personaSelector = NULL)
- Wraps up the ViewInfo’s AddInteractionMapping and AddAbility methods into a single call. The abilityIdentifier is the name of a GameCloud registered ability (created in the admin). The groupIdentifier is the optional name of a GameCloud registered entity group used to filter who gets the interaction, and the selector is a CSS-Style selector which identifies nodes which are eligible targets of the interaction.
- void SaveData()
- Checkpoints your app data. Just in case.
- void SetApplication(string identifier)
- Associates this script with an application (scope of data storage). A single call to this function is required before most other GameCloud functions will work. Simply pass a Guid as a string.
- void SetData(string key, string value)
- Sets the value of an application-scoped data item. This is basic global application string data storage.
- void SetOrCreateApplication(string identifier, Guid applicationID)
- Similar to SetApplication, but will also create the application with the known GUID application ID. This is useful for scripts that auto-create their application if it doesn't exist, and ensures the application always has the same ID so it can be transferred reliably between systems.