TudadaStore API

TudadaStore API (Cloud Storage)

Stores and retrieves user data in the cloud, independent of the device.

Capacity Limit: Maximum 2KB per value

getTudadaStore()

Returns the TudadaStore singleton instance.

Return Value:

Field	Type	Description
(return value)	TudadaStore	Cloud storage instance

Instance Methods:

Member	Type	Description
get(options)	void	Retrieve data from the cloud
save(options)	void	Save data to the cloud

store.get(options) Options:

Parameter	Type	Required	Description
key	string	✅	Key to retrieve
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

store.get Success Response:

Field	Type	Description
value	string | null	Stored value (null if not found)

store.save(options) Options:

Parameter	Type	Required	Description
key	string	✅	Key to store
value	string	✅	Value to store (max 2KB)
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

const store = TudadaSDK.getTudadaStore();

// Save value (max 2KB)
store.save({
  key: 'userScore',
  value: '1000',
  success: () => console.log('Cloud save complete'),
  fail: (err) => console.error('Save failed:', err.errMsg),
});

// Get value
store.get({
  key: 'userScore',
  success: (res) => {
    if (res.value !== null) {
      console.log('Score:', res.value);
    } else {
      console.log('No stored value');
    }
  },
});

tudadaStoreGet(options) / tudadaStoreSave(options)

An alternative way to call TudadaStore directly.

tudadaStoreSave(options) Options:

Parameter	Type	Required	Description
key	string	✅	Key to store
value	string	✅	Value to store (max 2KB)
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

tudadaStoreGet(options) Options:

Parameter	Type	Required	Description
key	string	✅	Key to retrieve
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

tudadaStoreGet Success Response:

Field	Type	Description
value	string | null	Stored value (null if not found)

// Save
TudadaSDK.tudadaStoreSave({
  key: 'gameState',
  value: JSON.stringify({ level: 5, coins: 300 }),
  success: () => console.log('Save complete'),
  fail: (err) => console.error('Save failed:', err.errMsg),
});

// Retrieve
TudadaSDK.tudadaStoreGet({
  key: 'gameState',
  success: (res) => {
    if (res.value) {
      const state = JSON.parse(res.value);
      console.log('Level:', state.level);
    }
  },
});