Gói
Gói backend & người mới
Sao chép trang
Các khách hàng nền tảng Lia chính thức và các dự án khởi động an toàn cho TypeScript, Python, PHP và Go.
Khách hàng máy chủ chính thức cho TypeScript/JavaScript, Python, PHP và Go. Họ gọi cùng một máy chủ Lia ứng dụng API. Một khóa kiểm tra nhìn thấy các bản ghi kiểm tra; một khóa trực tiếp yêu cầu ứng dụng trực tiếp và nhìn thấy các bản ghi trực tiếp.
#Tạo một backend
npx @lia-labs/create-app@latest backendChọn Node.js HTTP hoặc Express, FastAPI hoặc Django, PHP HTTP, hoặc Go HTTP. Các backend được tạo xác minh các phiên người chơi ngắn hạn và các khoản phí đã thanh toán, lưu trữ SQLite danh sách đồ vật với biên lai duy nhất, công nhận việc giao hàng sau khi cấp phát thành công, và hoàn tiền một lần. Bộ khởi tạo Node cũng bao gồm các thử thách thưởng do máy chủ phát hành và một cuộc quét khôi phục có giới hạn, phân trang.
Token CLI bao giờ cũng không yêu cầu bạn dán một bí mật vào tham số terminal hoặc ghi một bí mật vào giao diện người dùng. Thiết lập LIA_SERVER_KEY và LIA_WEBHOOK_SECRET trên máy chủ của bạn. Tạo hợp đồng coins-100 sản phẩm trong Lia Developers, sau đó thay đổi bản đồ cấp quyền do máy chủ sở hữu cho các sản phẩm thực tế của bạn. Lưu trữ data/ trên một khối lượng bền vững. Đối với nhiều phiên bản ứng dụng, thay thế kho SQLite mẫu bằng cơ sở dữ liệu giao dịch chung. Cấu hình HTTPS và giới hạn tốc độ cụ thể cho ứng dụng trên môi trường sản xuất.
Các ví dụ tích hợp khung công cụ được bao gồm cho Express, Next.js App Router, Hono, FastAPI, Django và Laravel. Một bộ thích hợp khung không thể xác định trò chơi của bạn'quyền lợi hoặc quy tắc chống gian lận; những điều này vẫn là mã ứng dụng do máy chủ sở hữu.
#Cài đặt vào backend hiện có
| Ngôn ngữ | Gói / nguồn | Cài đặt |
|---|---|---|
| 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 | Thêm kho lưu trữ GitHub VCS của công ty bên dưới, sau đó 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 |
Python có thể được cài đặt từ mã nguồn GitHub được gắn thẻ; nó chưa được liệt kê trên PyPI. PHP có thể được cài đặt thông qua Composer VCS; nó chưa được liệt kê trên Packagist.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}Nút hỗ trợ ESM và CommonJS và bao gồm các loại TypeScript. Python cung cấp LiaClient và AsyncLiaClient. PHP yêu cầu 8.2+ và cURL; bộ khởi tạo tồn kho được tạo cũng yêu cầu PDO SQLite. Go'client của nó sử dụng thư viện tiêu chuẩn; khởi tạo danh sách tồn kho được tạo ra sử dụng SQLite qua CGO và cần trình biên dịch C. Không nhập các gói này trong gói trình duyệt.
#Xác minh người chơi
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); Đi: client.RequireSession(ctx, session).
Giao diện người dùng gửi phiên bản trả về bởi Lia.init() hoặc Lia.session(), không phải là người chơi ID hoặc khóa máy chủ của bạn. Kết quả's exp là Unix mili giây. Các client xác minh phản hồi'chế độ, hình dạng người chơi và thời hạn. Cập nhật lại phiên frontend khi nó hết hạn. Chính API sẽ xác minh chữ ký và quyền sở hữu ứng dụng.
#Hoạt động
Hợp đồng có thể đọc được bởi máy là thao tác. Các tên dưới đây là tên TypeScript/PHP. Python sử dụng snake_case và tham số từ khóa; Go sử dụng PascalCase, context.Context, lia.Params và lia.RequestOptions.
| Khu vực | Phương pháp |
|---|---|
| Phiên | verifySession, requireSession |
| Danh mục | listProducts |
| Mua sắm | getCharge, deliverCharge, refundCharge, listPendingCharges |
| Thưởng LIA | payReward, getPool |
| Thông báo | sendNotification |
| Quảng cáo được thưởng | verifyAd, createAdChallenge, claimAdChallenge |
| Sảnh chơi đa người chơi | listTables, saveTable, sitAtTable, removeTable |
| Bảng điểm chính thức | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Lưu trữ chỉ dành cho máy chủ | getPlayerStorage, setPlayerStorage |
| Webhooks | listWebhookEvents, replayWebhookEvent, xác minh chữ ký thô và xây dựng sự kiện |
| Phân tích | getAnalytics, exportAnalytics |
Viết lưu trữ yêu cầu expectedVersion; một xung đột là HTTP 409. JSON null là giá trị lưu trữ hợp lệ. Truy cập trình duyệt vào bộ nhớ này chỉ đọc và bị ràng buộc với phiên làm việc'người chơi. Điểm số phải đến từ trò chơi được xác thực bởi máy chủ; di chuyển một điểm số không đáng tin đến điểm cuối máy chủ không khiến nó trở thành nguồn uy quyền.
#Mua sắm và thử lại
- Lấy hóa đơn với khóa máy chủ. Kiểm tra
playerId,mode,productIdvà mộtpaid/deliveredtrạng thái. - Trong một giao dịch cơ sở dữ liệu, chèn một biên lai duy nhất được khóa bằng chế độ + phí ID và chỉ cấp quyền được phân bổ nếu biên lai là mới.
- Xác nhận danh sách đồ vật, sau đó gọi
deliverCharge. Thử lại thông báo xác nhận đó ngay cả khi kho hàng đã được cấp. - Đồng bộ các khoản phí đã thanh toán dở dang bằng mọi trang con. Hoàn tiền phải được kiểm tra lại đối với Lia và hủy bỏ một lần trong cơ sở dữ liệu của bạn.
Tất cả khách hàng sử dụng ngân sách yêu cầu 15 giây và tối đa hai lần thử lại theo mặc định. Chúng thử lại các lỗi tạm thời HTTP/mạng, tuân thủ Retry-After, từ chối chuyển hướng xác thực và bỏ qua nội dung lỗi thô từ lỗi. Các phép thay đổi giữ nguyên Idempotency-Key được tạo ra và nội dung đã được định dạng hóa trong một cuộc gọi. Truyền một khóa kinh doanh ổn định khi thử lại sau khi khởi động lại quy trình hoặc các cuộc gọi riêng biệt.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});Python sử dụng idempotency_key=...; PHP lấy nó làm đối số thứ hai; Go sử dụng lia.RequestOptions{IdempotencyKey: ...}. Xác minh phiên là một POST kiểu đọc và không tạo bản ghi idempotency không cần thiết. LiaError bao gồm mã, trạng thái HTTP, yêu cầu ID và thời gian chờ thử lại. Không bao giờ coi 503 là một người chơi không hợp lệ hoặc một giao dịch hoàn tất. Kiểm tra GETs và xác minh phiên có số lần thử lại giới hạn; hành vi chính xác một lần về tài chính cũng dựa trên API'và cơ sở dữ liệu của bạn'hóa đơn kinh doanh duy nhất.
#Webhooks đã ký
Xác minh những byte thô nguyên vẹn trước khi phân tích JSON với constructWebhookEvent (Node), construct_webhook_event (Python), Webhooks::constructEvent (PHP), hoặc ConstructWebhookEvent (Go). Sử dụng Lia-Signature tiêu đề và ứng dụng của bạn'mật khẩu webhook. Xác minh từ chối các dữ liệu đầu vào bị thay đổi và các thời điểm cách xa hơn năm phút về quá khứ hoặc tương lai. Các loại sự kiện được ký mà không biết có thể được công nhận mà không cấp bất kỳ thứ gì; test:true các phép kiểm tra không bao giờ cấp quyền tồn kho.
Lia duy trì một hộp thư ra bền bỉ với một sự kiện ID ổn định. Nó cố gắng gửi ngay lập tức, sau đó sau 1 phút, 5 phút, 30 phút, 2 giờ, 8 giờ, 24 giờ và 48 giờ. Mỗi lần thử đều có một thời điểm chữ ký mới. Kiểm tra thông tin meta bằng cách sử dụng listWebhookEvents, và phát lại một sự kiện sau khi sửa chữa xử lý của bạn. Loại bỏ trùng lặp bằng các biên lai kinh doanh ổn định ngay cả sau khi phát lại. Không trả về 2xx trước khi cam kết hoàn thành.
#Thách thức thưởng
Tạo một thử thách trên máy chủ của bạn với một ngữ cảnh do máy chủ sở hữu và người chơi ID. Trả về challengeId về frontend và truyền nó như rewardContextId khi yêu cầu quảng cáo được thưởng. Kiểm tra liên kết/đăng ký kiểm tra người chơi, chế độ ứng dụng, định dạng quảng cáo, độ tuổi, hoàn thành và tái sử dụng. Một lần đăng ký không cấp hàng tồn kho riêng lẻ; cấp quyền cho trò chơi của bạn'quyền truy cập của bạn mỗi lần quảng cáo trong giao dịch của riêng bạn.
Phần thưởng có giá trị thực sự cần providerVerified:true. Luồng xác minh mới cũng cần một máy chủ Lia bản địa được cập nhật để gửi nonce SSV cho mỗi quảng cáo và cuộc gọi lại AdMob SSV được cấu hình. Hỗ trợ phía máy chủ riêng lẻ không nâng cấp các ứng dụng đã cài đặt. Hoàn tất bản địa ở chế độ kiểm tra là bằng chứng mô phỏng, không bao giờ là bằng chứng được ký bởi nhà cung cấp thực tế.
Quảng cáo thực trong SDK Demo được giới hạn ở 3 yêu cầu mỗi ngày UTC, cách nhau ít nhất 30 phút. Giao dịch mua và phần thưởng LIA vẫn là mô phỏng. Hãy cập nhật Lia để sử dụng tính năng này.
#Phân tích
Báo cáo bao gồm số người chơi hoạt động hàng ngày, các giao dịch mua và tỷ lệ chuyển đổi người mua, dữ liệu theo dõi quảng cáo theo định dạng và tỷ lệ giữ chân D1/D7/D30. CSV chứa các loại bản ghi hoạt động, quảng cáo và giữ chân. Việc thu thập dữ liệu giữ chân bắt đầu từ bản phát hành này; các nhóm người dùng trước đây không được tạo ra. Việc phủ sóng quảng cáo không đầy đủ trả về các chỉ số null. Doanh thu được báo cáo bởi SDK là ước tính, không phải là doanh thu AdMob chính thức hoặc báo cáo thanh toán cho nhà phát triển.
Quản lý mùa giải, ẩn hoặc khôi phục điểm số, xem các lần gửi webhook và gửi lại sự kiện trong Lia Developers. Phân tích bao gồm ứng dụng của nhóm và tính năng xuất CSV. Dữ liệu thử nghiệm và dữ liệu chính thức luôn tách biệt.
#Xác minh
Từ công ty lia-sdk kho lưu trữ:
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-appCài đặt Postman CLI, PHP với cURL và Go trước. Điều này chạy tất cả bốn khách hàng thực tế thông qua mô phỏng Postman HTTP nội bộ đầu tiên, bao gồm cả các lỗi tạm thời, các biến đổi lặp lại, hết hạn phiên, chuyển hướng, thời hạn và giả mạo webhook. Nó không chạm vào dữ liệu sản xuất. Xem scripts/developer-server-features-local-test.mjs trong kho API cho bài kiểm tra tích hợp riêng đối chiếu với thực thể Worker địa phương.
Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh