Konsep

Pemain dan sesi

Salin halaman

Setiap pemain masuk sebagai pengguna aplikasi Anda, dengan ID yang hanya untuk aplikasi Anda. Token sesi memungkinkan server Anda mengetahui siapa yang meminta.

#Pemain

Orang tidak pernah masuk ke aplikasi Anda: Lia melakukannya untuk mereka. Kali pertama seseorang membuka aplikasi Anda, Lia membuat mereka sebuah pemain darinya. Lia.init() memberi Anda:

{
  "player": { "id": "p_3f9c0a6d1b2e4f5a6b7c", "name": "amara" },
  "session": "lias_eyJhcHAiOi…",
  "exp": 1761998400000,
  "mode": "live"
}

player.id adalah orang ini'id di aplikasimu. Tetap sama setiap kali mereka membukanya, di mana pun ponselnya. Itu'pseudonim: itu'hanya untuk aplikasi Anda, tidak pernah akun Lia mereka, dan aplikasi lain mendapatkan id berbeda untuk orang yang sama. Gunakan sebagai kunci untuk semua yang Anda simpan tentang seorang pemain.
player.name adalah username Lia mereka, tanpa @. Itu'publik dan bisa berubah; Lia menjaganya tetap diperbarui setiap kali mereka membuka aplikasi Anda. Tampilkan, tetapi jangan'tidak kunci apa pun di atasnya.

Lia tidak memberi aplikasi Anda seorang orang'email, nomor telepon, saldo atau apa pun tentang akun mereka.

#Sesi

Halaman Anda dapat'tidak membuktikan siapa itu ke server Anda: siapa pun dapat mengirim permintaan ke server Anda yang mengklaim sebagai pemain apa pun. Jadi Lia memberikan halaman Anda token sesi, ditandatangani oleh Lia, yang server Anda periksa dengan Lia.

Lia.init() jawaban dengan sebuah session dan ketika berakhir, exp (milidetik sejak 1970).
Sebuah sesi berlangsung 15 menit. Dapatkan yang baru dengan Lia.session() kapan saja Anda membutuhkannya; itu menjawab { session, exp }.
Sebuah sesi menamai aplikasi Anda, pemain dan mode (uji atau live). Token dari aplikasi lain, dari mode lain atau melebihi masa berlakunya tidak sah.

// In your page: send a fresh session with anything your server must trust.
const { session } = await Lia.session();
await fetch("/api/claim", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ session, chargeId }),
});

Server Anda mengirim token ke POST /session/verify dengan kunci rahasia Anda dan mendapatkan kembali id pemain:

{ "valid": true, "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "mode": "live", "exp": 1761998400000 }

#Mode

Setiap sesi berada dalam satu mode, test atau live, dan setiap kunci. Kunci uji hanya memverifikasi sesi uji coba dan kunci live hanya sesi live. Lihat Uji dan live.

#Lia'catatan miliknya tentang seorang pemain

Beberapa hal Lia yang disimpan per pemain di aplikasi Anda, jadi Anda tidak'tidak perlu server untuk mereka:

Mereka skor terbaik dan tempatkan di papan peringkat.
Mereka penyimpanan awan: hingga 1024 kunci.
Apakah mereka memungkinkan notifikasi Anda.
Mereka mengenakan biaya, hadiah dan menonton video, yang dapat server Anda cari.

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris