LiaGeliştiriciler

Paketler

Resmi Lia arka plan istemcileri ve TypeScript, Python, PHP ve Go için güvenli başlangıç projeleri.

Resmi sunucu istemcileri için TypeScript/JavaScript, Python, PHP ve Go. Aynı uygulama kapsamlı Lia sunucusuna API çağırır. Bir test anahtarı test kayıtlarını görür; canlı bir anahtar, canlı bir uygulama gerektirir ve canlı kayıtları görür.

#Arka uç oluştur

npx @lia-labs/create-app@latest backend

Lütfen Node.js HTTP veya Express, FastAPI veya Django, PHP HTTP, veya Go HTTP seçin. Oluşturulan arka plan sistemleri kısa ömürlü oyuncu oturumlarını ve ödemeleri doğrular, benzersiz faturalarla SQLite envanterlerini korur, başarılı bir verilişten sonra teslimi onaylar ve bir kez geri ödeme yapar. Node başlangıç paketi, sunucu tarafından verilen ödül zorlukları ve sınırlı, sayfalı bir kurtarma tarayıcısı içerir.

The CLI, sizi bir gizli anahtarı terminal argümanlarına yapıştırmadan veya ön uçta yazmadan ister. Ayarla LIA_SERVER_KEY ve LIA_WEBHOOK_SECRET sunucunuzda. Oluşturun coins-100 ürün Lia Geliştiriciler, ardından gerçek ürünleriniz için sunucu sahibi olan erişim eşlemesini değiştirin. Kalıcı data/ dayanıklı bir hacimde. Birden fazla uygulama örneği için örnek SQLite deposunu paylaşılan işlem tabanlı bir veritabanıyla değiştirin. Üretim barındırma üzerinde HTTPS ve uygulama özel oran sınırlarını yapılandırın.

Çerçeve entegrasyon örnekleri şunlar için dahil edilmiştir Express, Next.js App Router, Hono, FastAPI, Django ve Laravel. Bir çerçeve adaptörü, oyununuzu belirleyemez's hakkı veya anti-cheat kuralları; bu, sunucu sahipliğindeki uygulama kodu kalmaya devam eder.

#Mevcut bir arka uç sistemine kurun

DilPaket / kaynakYükle
JavaScript / TypeScript@lia-labs/servernpm install @lia-labs/server
Pythonlia-labs-serverpip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0'
PHPlia-labs/serverŞirket GitHub VCS deposunu aşağıya ekleyin, ardından composer require lia-labs/server:^0.1.0
Gogithub.com/The-Lia-Labs/lia-server-gogo get github.com/The-Lia-Labs/lia-server-go@v0.1.0

Python, GitHub etiketli kaynaklarından kurulabilir; henüz PyPI üzerinde listelenmemiştir. PHP, Composer VCS aracılığıyla kurulabilir; henüz Packagist üzerinde listelenmemiştir.

{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}

Düğüm ESM ve CommonJS destekler ve TypeScript türlerini içerir. Python sağlar LiaClient ve AsyncLiaClient. PHP, 8.2+ ve cURL gerektirir; oluşturulan stok başlatıcısı ayrıca PDO SQLite gerektirir. Go's istemcisi standart kütüphane kullanır; ürettiği envanter başlangıç dosyası SQLite ile CGO arasında ve bir C derleyicisi gerektirir. Bu paketleri bir tarayıcı paketinde içe aktarmayın.

#Oyuncuyu doğrula

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); Git: client.RequireSession(ctx, session).

Ön uç, tarafından döndürülen oturumu gönderir Lia.init() veya Lia.session(), ID bir oyuncu veya sunucu anahtarınız değil. Sonuç's exp Unix'dur milisaniye. İstemciler yanıtın doğruluğunu kontrol eder's modu, oyuncu şekli ve sona erme. Süresi dolduğunda ön uç oturumunu yenileyin. API kendisi imzaları ve uygulama sahipliğini doğrular.

#İşlemler

Paylaşılan makineye okunabilir sözleşmesi işlem sözleşmesi. Aşağıdaki isimler TypeScript/PHP isimleridir. Python, snake_case ve anahtar kelime parametrelerini kullanır; Go, PascalCase kullanır, context.Context, lia.Params ve lia.RequestOptions.

AlanYöntemler
OturumlarverifySession, requireSession
KataloğlistProducts
AlışverişlergetCharge, deliverCharge, refundCharge, listPendingCharges
LIA ödülleripayReward, getPool
BildirimlersendNotification
Ödül reklamlarıverifyAd, createAdChallenge, claimAdChallenge
Çok oyunculu lobilistTables, saveTable, sitAtTable, removeTable
Yetkili skorlarlistLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore
Sadece sunucu depolamasıgetPlayerStorage, setPlayerStorage
Webhook'larlistWebhookEvents, replayWebhookEvent, ham imza doğrulama ve olay yapısı
AnalitikgetAnalytics, exportAnalytics

Depolama yazmaları gerekir expectedVersion; bir çakışma HTTP 409. JSON null geçerli bir depolama değeri. Tarayıcı erişimi bu depolamaya yalnızca okunur ve oturuma bağlıdır's oyuncusu. Puanlar sunucu doğrulanmış oyun oynamaından gelmelidir; güvenilmeyen bir puanı bir sunucu uç noktasına taşımak onu yetkili kılmaz.

#Alışverişler ve yeniden denemeler

  1. Satıcı anahtarını kullanarak ücreti alın. Kontrol edin playerId, mode, productId ve bir paid/delivered durum.
  2. Bir veritabanı işlemi içinde, aşağıdaki anahtara göre benzersiz bir fatura ekleyin mod + ücret ID ve faturanın yeni olduğundan emin olunca eşlenmiş hakkı verin.
  3. Envanteri kaydedin, ardından şunu çağırın deliverCharge. İadeyi, envanter zaten verilmiş olsa bile tekrar deneyin.
  4. Tüm imzalı sayfa kümelerini kullanarak bekleyen ödenmiş ücretleri denetleyin. İadeler, veritabanınızda Lia ile yeniden kontrol edilmeli ve bir kez geri alınmalıdır.

Tüm istemciler varsayılan olarak 15 saniyelik istek bütçesine sahiptir ve en fazla iki yeniden deneme yapar. Geçici HTTP/ağ hatalarını yeniden denemeler, onlar tarafından takip edilir Retry-After, kimlik doğrulamalı yönlendirmeleri reddet ve hatalardan ham hata gövdesini atla. Değişiklikler, bir çağrı içinde aynı oluşturulan Tekrarlanmazlık Anahtarını ve seri hale getirilmiş gövdeyi korur. İşlem yeniden başlatıldığında veya ayrı çağrılar arasında istikrarlı bir iş anahtarı geçirin.

await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});

Python kullanır idempotency_key=...; PHP ikinci bağımsız değişken olarak alır; Git lia.RequestOptions{IdempotencyKey: ...}. Oturum doğrulaması, yinelenmeyen bir eşsizlik kaydı oluşturmayan bir okuma tarzı POST'dır. LiaError bir kod, HTTP durumu, istek ID ve tekrar gecikmesi içerir. Asla 503'yi geçersiz bir oyuncu veya tamamlanmış bir satın alma olarak kabul etmeyin. Güvenli GETs ve oturum doğrulaması sınırlı tekrarlar içerir; finansal tam olarak bir kez davranış API'e dayanır've veritabanınız's tekil iş maliyetleri.

#İmzalı webhuklar

Doğrula ayrıştırma JSON olmadan ham bayt olarak ilet ile constructWebhookEvent (Düğüm), construct_webhook_event (Python), Webhooks::constructEvent (PHP), veya ConstructWebhookEvent (Git). Kullan Lia-Signature başlık ve uygulamanız's webkuyruk gizli anahtarı. Doğrulama, değiştirilmiş veri yüklerini ve geçmişte veya gelecekte beş dakikadan fazla olan zaman damgalarını reddeder. Bilinmeyen imzalı olay türleri, hiçbir şey verilmeden teyit edilebilir; test:true taramalar hiçbir zaman envanter vermez.

Lia, sabit bir olay ID ile dayanıklı bir outbox tutar. Hemen teslimat denemesi yapar, ardından 1 dakika, 5 dakika, 30 dakika, 2 saat, 8 saat, 24 saat ve 48 saat sonra. Her deneme için yeni bir imza zaman damgası alınır. Meta verileri incelemek için listWebhookEvents, ve işleyiciyi düzelttikten sonra bir olayı tekrar oynatın. Tekrar oynatılsa bile kararlı iş alım belgelerine göre çakışmaları önleyin. Tamamlama işlerinden önce 2xx döndürmeyin.

#Ödül zorlukları

Bir sunucu sahibi bağlam ve oyuncu ID ile sunucunuzda bir zorluk oluşturun. Dönüş challengeId önceki ön uç ve onu rewardContextId ödül reklamı istendiğinde. Bağla/teslim, oyuncuyu, uygulama modunu, reklam formatını, yaşı, tamamlanma ve yeniden kullanım kontrol eder. Bir teslim kendisi başına envanter sağlamaz; oyununuza izin ver'kendinizinkini işlemdeki her reklam için bir kez yetki verir.

Canlı değerli ödüller gerekir providerVerified:true. Yeni kanıt akışı, per-ad SSV noncesini ve AdMob SSV geri arama fonksiyonunu göndermek için güncellenmiş yerel Lia sunucusuna da ihtiyaç duyar. Arka plan desteği, zaten kurulmuş uygulamaları yükseltmez. Test modu yerel tamamlama, gerçek sağlayıcı imzalı kanıt değil, simüle edilmiş kanıttır.

SDK Demo içindeki gerçek reklamlar, aralarında en az 30 dakika olacak şekilde UTC günü başına 3 istekle sınırlıdır. Satın alımlar ve LIA ödülleri simülasyon olarak kalır. Bu özelliği kullanmak için Lia’yı güncelleyin.

#Analitik

Raporlar, günlük aktif oyuncular, satın almalar ve ödemeci dönüşümü, format bazında reklam telemetrisi ve D1/D7/D30 tutunma içerir. CSV etkinlik, reklam ve tutunma kayıt türlerini içerir. Tutunma toplama bu sürümle başlar; geçmiş koherentler icat edilmez. Tam olmayan reklam görüntüleme kapsama alanı null metrikler döndürür. SDK tarafından bildirilen gelir, geliştirici ödemeleri beyannamesi veya sonlandırılmış AdMob geliri değil, tahmini bir değerdir.

Lia Developers üzerinden sezonları yönetin, puanları gizleyin veya geri yükleyin, webhook teslimat denemelerini inceleyin ve olayları yeniden gönderin. Analizler ekip uygulamalarınızı ve CSV dışa aktarımlarını içerir. Test ve canlı veriler ayrı tutulur.

#Doğrulama

Şirketten lia-sdk depo:

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-app

Postman CLI , PHP ile cURL ve Go yükleyin. Bu, yerel ilk taraf Postman HTTP simülasyonu üzerinden dört gerçek istemciyi çalıştırır, geçici hatalar, tekrarlı değişiklikler, oturum sona ermesi, yönlendirmeler, zaman aşımı ve webhook sahteciliği dahil olmak üzere. Üretim verilerine dokunmaz. Bakınız scripts/developer-server-features-local-test.mjs gerçek yerel Worker uygulamasına karşı ayrı test için API deposunda.

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku

Her sayfa, yöntem ve uç noktayı aramak için yazın.