Packages
Mga pakete ng backend & manggagawa
Kopya ang pahina
Ofisyál na mga backend client ng Lia at mga mapag-ugnay na proyekto para sa TypeScript, Python, PHP at Go.
Ofisyales na server clients para sa TypeScript/JavaScript, Python, PHP at Go. Sila ay tumatawag sa parehong server ng Lia na app-scoped API. Ang isang test key ay nakakakita ng mga test na tala; ang isang live key ay kailangan ng isang live na app at nakakakita ng mga live na tala.
#I-likha ang isang backend
npx @lia-labs/create-app@latest backendPiliin ang Node.js HTTP o Express, FastAPI o Django, PHP HTTP, o Go HTTP. Ang mga inilabas na backend ay nagpapatunay sa maikling panahong sesyon ng manlalaro at mga bayad, panatilihin ang mga imbentaryo ng SQLite na may natatanging mga resibo, kinikilala ang paghahatid pagkatapos ng isang matagumpay na pagbibigay, at bumawi ng mga refund pagkatapos. Ang Node starter ay kasama rin ang mga challenge ng reward na ibinigay ng server at isang limitadong, paginadong pagbawi.
Ang CLI ay hindi kailanman hihilingin sa iyo na ilagay ang isang lihim sa mga argumento ng terminal o isulat ito sa frontend. I-set LIA_SERVER_KEY at LIA_WEBHOOK_SECRET sa iyong server. Lumikha ng coins-100 produkto sa Lia Developers, pagkatapos ay baguhin ang server-owned entitlement mapping para sa iyong tunay na mga produkto. Panatilihin data/ sa isang matatag na volume. Para sa maramihang mga kaso ng aplikasyon, palitan ang sample SQLite na talaan ng isang ibinahaging transactional na database. I-configure ang HTTPS at application-specific rate limits sa production hosting.
Mga halimbawa ng pag-integro ng framework ay kasama para sa Express, Next.js App Router, Hono, FastAPI, Django at Laravel. Ang isang framework adapter ay hindi maaaring matukoy ang iyong laro'ang kanyang karapatan o mga patakaran laban sa cheat; ang mga ito ay nananatili sa server-ari na kodigo ng aplikasyon.
#I-install sa isang umiiral na backend
| Wika | Package / source | I-install |
|---|---|---|
| JavaScript / TypeScript | @lia-labs/server | npm install @lia-labs/server |
| Python | lia-labs-server | pip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0' |
| PHP | lia-labs/server | Magdagdag ng kumpanya GitHub VCS repository sa ibaba, pagkatapos composer require lia-labs/server:^0.1.0 |
| Go | github.com/The-Lia-Labs/lia-server-go | go get github.com/The-Lia-Labs/lia-server-go@v0.1.0 |
Ang Python ay maaaring i-install mula sa tagged GitHub source nito; hindi pa ito nakalista sa PyPI. Ang PHP ay maaaring i-install sa pamamagitan ng Composer VCS; hindi pa ito nakalista sa Packagist.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}Ang node ay suporta sa ESM at CommonJS at kasama ang mga uri ng TypeScript. Ang Python ay nagbibigay LiaClient at AsyncLiaClient. Ang PHP ay nangangailangan ng 8.2+ at cURL; ang generated inventory starter ay nangangailangan din ng PDO SQLite. Go's client gamit ang standard library; ang generated inventory starter nito ay gumagamit ng SQLite hanggang CGO at kailangan ang C compiler. Huwag i-import ang mga package na ito sa isang browser bundle.
#I-Authenticate ang manlalaro
import {LiaClient} from '@lia-labs/server';
const lia = new LiaClient(process.env.LIA_SERVER_KEY!);
const player = await lia.requireSession(sessionFromLia);
const {products} = await lia.listProducts();Python: lia.require_session(session); PHP: $lia->requireSession($session); Maglakbay: client.RequireSession(ctx, session).
Ang frontend nagpapadala ng sesyon na ibinabalik ng Lia.init() o Lia.session(), hindi isang player ID o ang iyong server key. Ang resulta's exp ay Unix milisegundo. Ang mga kliyente ay naniniwala sa tugon'ang modo, hugis ng manlalaro at pag-expire. I-renew ang sesyon ng frontend kapag ito ay nag-expire. Ang API mismo ang nagsusuri ng mga signature at pagmamay-ari ng app.
#Mga Operasyon
Ang partisipante na makabasa ng makina ay operasyon kontrata. Ang mga pangalan sa ibaba ay TypeScript/PHP pangalan. Ang Python ay gumagamit ng snake_case at keyword parameters; ang Go ay gumagamit ng PascalCase, context.Context, lia.Params at lia.RequestOptions.
| Lugar | Paraan |
|---|---|
| Mga session | verifySession, requireSession |
| Koleksyon | listProducts |
| Mga Bili | getCharge, deliverCharge, refundCharge, listPendingCharges |
| Mga parangal ng LIA | payReward, getPool |
| Mga Notification | sendNotification |
| Nagbibigay ng ad | verifyAd, createAdChallenge, claimAdChallenge |
| Multiplayer lobby | listTables, saveTable, sitAtTable, removeTable |
| Makapangyarihang mga marka | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Storage na eksklusibo sa server | getPlayerStorage, setPlayerStorage |
| Webhooks | listWebhookEvents, replayWebhookEvent, raw signature verification at pagbuo ng event |
| Analytics | getAnalytics, exportAnalytics |
Ang mga pagsulat sa imbakan ay kailangan expectedVersion; isang pagkakasala ay HTTP 409. JSON null ay isang wastong naka-imbak na halaga. Ang pag-access ng browser sa imbakan ay nasa mode lamang ng pagbasa at nakakabit sa sesyon'ang manlalaro. Ang mga puntos ay dapat mula sa paglalaro na napatunayan ng server; ang paglipat ng isang hindi mapaniwalaang puntos sa isang endpoint ng server ay hindi ito ginagawa ang opisyal.
#Mga Bili at pagreretry
- Kumuha ng bayad gamit ang server key. Suriin
playerId,mode,productIdat isangpaid/deliveredestado. - Sa isang transaksyon ng database, i-iskan ang isang natatanging resibo na nakasalalay sa mode + bayad ID at bigyan ng karapatan na nakalakip lamang kung ang resibo ay bagong-bago.
- I-commit ang imbentaryo, pagkatapos ay tawagan ang
deliverCharge. Iulit ang pagtanggap kahit na ang inventory ay nakuha na. - I-reconcile ang mga pending na bayad na mga gastos gamit ang bawat page ng cursor. Ang mga refund ay kailangang i-verify muli laban sa Lia at i-reverse kapag nasa iyong database.
Ang lahat ng mga kliyente ay gumagamit ng isang 15-segundo na budget para sa kahilingan at nangunguna sa dalawang pagsubok ulit. Sila ay nag-uulit ng transitory HTTP/network failures, sumunod Retry-After, iwasan ang authenticated redirects at ihiwalay ang raw error bodies mula sa mga error. Ang mga mutation ay panatilihin ang parehong generated Idempotency-Key at serialized body sa loob ng isang katanungan. Ipasa ang isang nakapag-iisa na key ng negosyo kapag nag-retry sa pagitan ng pagrestart ng proseso o magkakahiwalay na mga tawag.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});Ang Python ay gumagamit idempotency_key=...; PHP ay tinatanggap bilang pangalawang argumento; Ang Go ay gumagamit lia.RequestOptions{IdempotencyKey: ...}. Ang pagsusuri ng sesyon ay isang pagbasa ng POST at hindi naglalabas ng walang kahulugan na tala ng idempotency. LiaError kasama ang isang code, HTTP status, request ID at retry delay. Huwag kailanman ituring ang 503 bilang isang hindi wastong manlalaro o isang natapos na pagbili. Ang mapanganib na GETs at pagpapatunay ng sesyon ay may nakatakdang pagsubok muli; ang eksakto sa isang pag-uugali ng pananalapi ay nakasalalay din sa API's at database mo'ang mga natatanging dokumento ng negosyo.
#Nakasiguro na mga webhook
I-verify hindi nakakabago na raw bytes bago ang parsing JSON kasama constructWebhookEvent (Node), construct_webhook_event (Python), Webhooks::constructEvent (PHP), o ConstructWebhookEvent (Pumunta). Gamitin ang Lia-Signature header at ang iyong app'ang secret ng webhook. Ang pagsusuri ay ikinokonsidera ang mga payload na binago at mga oras na higit sa limang minuto sa nakaraan o sa hinaharap. Ang mga hindi kilalang mga uri ng event na may signature ay maaaring tanggapin nang walang pagbibigay ng anumang bagay; test:true ang mga probe ay hindi kailanman nagbibigay ng inventory.
Nag-iimbak ang Lia ng isang matatag na outbox na may mapagkakatiwalaang event ID. Sinisimulan ang pagpapadala agad, pagkatapos ng 1 minuto, 5 minuto, 30 minuto, 2 oras, 8 oras, 24 oras at 48 oras. Ang bawat pagsubok ay may bagong timestamp ng signature. Surin ang metadata gamit listWebhookEvents, at i-replay ang isang pangyayari pagkatapos ayusin ang iyong handler. I-deduplicate gamit ang mga tumpak na kumento ng negosyo kahit na i-replay ito. Huwag ibalik ang 2xx bago ang pagkakamit ng pagkakasundo.
#Mga hamon sa reward
Lumikha ng isang challenge sa iyong server na may isang konteksto na sinasakop ng server at manlalaro ID. Ibaling ang challengeId sa frontend at ipasa ito bilang rewardContextId nang humihingi ng isang rewarded ad. Ang mga pagsusuri ng pagbili/pananagot ay kinokontrol ang manlalaro, modo ng app, format ng ad, edad, kumpleto at paggamit ulit. Ang isang pananagot hindi nagbibigay ng inventory nang sarili; ipagkaloob ang iyong laro's entitlement isang beses bawat ad sa iyong sariling transaksyon.
Ang mga nakabuhay na karangalan ay kailangan providerVerified:true. Ang bagong proof flow ay kailangan din ng isang na-update na native Lia host upang ipadala ang per-ad SSV nonce at ang AdMob SSV callback na nakakonekta. Ang suporta sa backend lamang ay hindi nag-uumpisa ang naka-install na mga app. Ang test-mode native completion ay isang sinimulang ebidensiya, diyan ang totoong proof na nakasiguro ng tagapag-alok.
Limitado sa 3 kahilingan bawat araw sa UTC ang mga totoong ad sa SDK Demo, na may hindi bababa sa 30 minutong pagitan. Simulated pa rin ang mga pagbili at LIA reward. I-update ang Lia para magamit ito.
#Analytics
Ang mga ulat ay kasama ang araw-araw na aktibong manlalaro, mga pagbili at pagkonbersyon ng manlalaro, ad telemetry bawat format at D1/D7/D30 retention. Ang CSV ay naglalaman ng mga uri ng record ng aktibidad, ad at retention. Ang pagkuha ng retention nagsisimula sa release na ito; ang mga kohort na nakaraan ay hindi inimbento. Ang hindi kompleto na kapanapanabik ng ad ay bumalik na null metrics. Ang inireport na kita ng SDK ay isang estimasyon, hindi ang tapos na AdMob kita o isang pahayag ng pagbabayad sa developer.
Pamahalaan ang mga season, itago o ibalik ang mga score, suriin ang mga pagtatangkang maghatid ng webhook, at ipadala muli ang mga event sa Lia Developers. Kasama sa analytics ang mga app ng iyong team at CSV export. Magkahiwalay ang test at live na data.
#Pagsusuri
Mula sa kumpanya lia-sdk repository:
npm install
python3 -m venv .venv
.venv/bin/pip install -e backends/python
LIA_PYTHON=.venv/bin/python npm run test:backends
npm run test:create-appI-install ang Postman CLI, PHP kasama ang cURL at Go. Ito ay nagrurun ng apat na tunay na kliyente sa lokal na unang partido Postman HTTP simulasyon, kabilang ang mga temporaryong pagkabigo, paulit-ulit na pagbabago, pag-expire ng sesyon, redirect, deadlines at pagmamay-ari ng webhook. Hindi ito nakakasalo sa production data. Tingnan ang scripts/developer-server-features-local-test.mjs nasa API repository para sa hiwalay na pagsusulit ng integrasyon laban sa tunay na lokal na Worker implementation.
Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles