SDK reference

Mga marka at imbakan

Kopya ang pahina

Leaderboards na walang sariling server, at tatlong uri ng storage. Ang cloud storage ay sumunod sa isang manlalaro sa anumang telepono; ang device at secure storage ay nananatili sa isa lamang.

#Mga marka

Mayroon ang bawat app ng isang leaderboard. Ang isang manlalaro lamang'na pinakamabuti na marka.

#Lia.submitScore(score, options)

Nakarekord ng iskor. Kung ito ay mas mahusay kaysa sa manlalaro'na pinakamabuti, ito ang kanilang pinakamabuti.

const { best } = await Lia.submitScore(1280);

Parameter	Uri
`score`	bilang	Isang buong numero, 0 hanggang 1,000,000,000,000. Mas mataas ang mas maganda.
`options.idempotencyKey`	string	Pangkatawan (SDK 1.5). Tingnan Mga idempotency keys.

Nag-uugnay sa { best }: ang player'na pinakamabuti na marka ngayon. Mga error: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Ang pinakataas na 50, at kung saan nakatayo ang manlalaro na ito.

const { top, me } = await Lia.leaderboard();

Nag-uugnay sa:

{
  "top": [
    { "rank": 1, "name": "amara", "score": 4210, "me": false },
    { "rank": 2, "name": "kofi", "score": 3990, "me": true }
  ],
  "me": { "rank": 2, "score": 3990 }
}

name ay ang Lia username. Ang mga tie ay ipinapadala sa kanya na nakarating unang beses. me ay null hanggang ang manlalaro ay may iskor.

#Storage

	Nasaan	Limits	Para sa
`Lia.cloudStorage`	Lia'ang server ngayon, bawat player	1024 mga key, mga halaga hanggang 4096 karakter	Ang pag-unlad at mga setting na sumusunod sa manlalaro sa anumang telepono
`Lia.deviceStorage`	Ang telepono na ito, para sa iyong app	5 MB sa lahat	Mga cache at draft
`Lia.secureStorage`	Ang telepono na ito's secure store (ang Keychain sa iPhone)	10 mga item, mga halaga hanggang 2048 karakter	Mga token at lihim

Ang bawat app ay nakakakita lamang ng kanyang sariling mga key. Ang mga key ay 1 sa 128 ng mga letra, digit, _ at -; ang mga halaga ay text (iimbak ang JSON na JSON.stringify. Ang mga maling keys at values ay i-reject na may bad_key, bad_keys o bad_value.

#Lia.cloudStorage

Sa Lia'ang server ngayon, para sa player na ito sa iyong app, sa anumang telepono. Ang test at live ay magkakasama.

await Lia.cloudStorage.setItem("progress", JSON.stringify({ level: 7, coins: 120 }));
const progress = JSON.parse((await Lia.cloudStorage.getItem("progress")) ?? "{}");

Paraan	Nag-uugnay sa
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Nagfail sa `storage_full` sa 1024 na mga key.
`Lia.cloudStorage.getItem(key)`	Ang halaga, o `null`.
`Lia.cloudStorage.getItems(keys)`	Isang object ng mga key na umiiral at ang kanilang mga halaga. 1 hanggang 100 keys.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 sa 100 na mga pana.
`Lia.cloudStorage.getKeys()`	Lahat ng ito ng manlalaro'ng wika (i-off gamit ang

Ang mga writes ay naglalaman ng isang opsyonal { idempotencyKey } huling (SDK 1.5), kaya ang isang mahabang pagsubok ng isang lumang pagpapadala ay hindi kailanman maliwanag ang mas bagong halaga. Tingnan Mga idempotency keys.

Mga error: not_open (tawag init() una), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Sa iyong telepono lamang, para sa iyong app. Wala kung ang tao ay tanggalin ang Lia o maglipat sa ibang telepono.

Paraan	Nag-uugnay sa
`Lia.deviceStorage.setItem(key, value)`	`true`. Mga halaga hanggang 1,048,576 karakter; lahat ng iyong app ay nagsasama (mga key at halaga) hanggang 5 MB, o `storage_full`.
`Lia.deviceStorage.getItem(key)`	Ang halaga, o `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Nalilimot ang lahat ng iyong app'ng keys, ayayari.

#Lia.secureStorage

Sa telepono's secure store (ang Keychain sa iPhone), para sa iyong app.

Paraan	Nag-uugnay sa
`Lia.secureStorage.setItem(key, value)`	`true`. Mga halaga hanggang 2048 karakter; hanggang 10 mga item, o `storage_full`.
`Lia.secureStorage.getItem(key)`	Ang halaga, o `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Ang iyong pahina'naka-own localStorage din gumagana, ngunit ito'nakakabit sa Lia'ang web view at maaaring ma-clear; paboran ito.

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles