Skip to content

Tài liệu kỹ thuật

Tích hợp LRS trong một buổi chiều.

Anti-cheat SDK

Lấy thông tin tải SDK cho từng nền tảng (phiên bản, đường dẫn, mã SHA-256) và kết nối SDK với game server để báo người chơi đang online.

EndpointGEThttps://api.lrsvn.com/v1/anticheat/sdk

Tín hiệu phát hiện từ game được chuyển lên LRS qua game server của bạn: game server dùng API key có scope anticheat:ingest để gửi sự kiện. Không bao giờ nhúng API key vào game client.

Yêu cầu

cURL
curl https://api.lrsvn.com/v1/anticheat/sdk \
  -H "Authorization: Bearer $LRS_API_KEY"

Cần scope anticheat:read.

Phản hồi

JSON
{
  "data": [
    {
      "platform": "windows",
      "url": "https://downloads.lrs.vn/anticheat/windows/1.4.2/lrs-anticheat-windows.zip",
      "version": "1.4.2",
      "sha256": "8dbddf49c93d7fd107f31538fb2ee7250d11ddc6fd21b17ee59aabb1df0c0f67"
    },
    {
      "platform": "unity",
      "url": "https://downloads.lrs.vn/anticheat/unity/1.4.0/lrs-anticheat-unity.zip",
      "version": "1.4.0",
      "sha256": "909d6b7201eb21ee6eb168985c34343908790b32dadb7d5fe6cd85e89edfa374"
    }
  ]
}

Chỉ những nền tảng đã được cấu hình (đường dẫn HTTPS, có phiên bản và SHA-256 hợp lệ) mới xuất hiện trong danh sách.

Nền tảng

Giá trị platformDành cho
windowsGame client trên Windows.
androidỨng dụng Android.
iosỨng dụng iOS.
unityPlugin cho Unity.
unrealPlugin cho Unreal Engine.

Xác minh tệp đã tải

So khớp mã SHA-256 trước khi đưa SDK vào bản dựng:

Shell
echo "8dbddf49c93d7fd107f31538fb2ee7250d11ddc6fd21b17ee59aabb1df0c0f67  lrs-anticheat-windows.zip" | sha256sum --check

Báo người chơi đang online

Game server gọi endpoint sau định kỳ cho mỗi người chơi đang kết nối (scope anticheat:ingest). Người chơi được tính là online trong 5 phút kể từ nhịp gần nhất:

cURL
curl -X POST https://api.lrsvn.com/v1/anticheat/players/heartbeat \
  -H "Authorization: Bearer $LRS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "player_id": "player_10293" }'

Phản hồi 200: { "online": true }.

Mã lỗi

HTTPMãKhi nào
403scope_deniedKhoá thiếu scope anticheat:read (hoặc anticheat:ingest với nhịp online).
422validation_errorfields.player_id rỗng hoặc không hợp lệ.
503sdk_unavailableChưa có bản SDK nào được cấu hình để tải xuống.