Skip to content

Tài liệu kỹ thuật

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

LinkGate (SDK)

Dùng LinkGate trong SDK Node/TypeScript, C#, C++ và Python: tạo lượt, đưa link bọc cho người dùng, chờ hoàn thành và đọc kết quả có chữ ký Ed25519.

LinkGate nằm trong cùng gói SDK với LR License (bản 0.2 trở lên; hubUrl từ bản 0.3). Tải gói ở /app/license › Tổng quan hoặc trang /services/lr-license; tệp ở https://lrsvn.com/sdk/ (manifest.json, SHA256SUMS).

SDK tự sinh nonce cho mỗi lần gọi, xác minh chữ ký, so nonce và campaign_id, tách lỗi mạng (network_error) khỏi kết luận đã ký và poll theo poll_after.

Node / TypeScript

JavaScript
import { LinkGate } from "@lrs/license";

const gate = new LinkGate({
  campaignId: "lcmp_xxxxxxxx",
  publicKeys: { lksk_xxxxxxxx: "PUBLIC_KEY_BASE64URL" },
});

const r = await gate.createRun("player-42");
if (!r.ok) throw new Error(r.code);
// Một link (hoặc mã QR) cho cả lượt; hoặc tự hiện từng link trong r.run.links.
console.log(r.run.hubUrl);

const done = await gate.waitForCompletion(r.run.id);
if (done.ok && done.run.status === "completed") {
  console.log(done.run.result.licenseKey, done.run.result.code);
}

Python

Python
from lr_license import LinkGate

gate = LinkGate("lcmp_xxxxxxxx", {"lksk_xxxxxxxx": "PUBLIC_KEY_BASE64URL"})
r = gate.create_run("player-42")
print(r.run.hub_url)  # một link (hoặc mã QR) cho cả lượt
done = gate.wait_for_completion(r.run.id)
if done.ok and done.run.status == "completed":
    print(done.run.result.license_key)

C#

Mã
using var gate = new LinkGate(new LinkGateOptions
{
    CampaignId = "lcmp_xxxxxxxx",
    PublicKeys = new Dictionary<string, string> { ["lksk_xxxxxxxx"] = "PUBLIC_KEY_BASE64URL" },
});
var r = await gate.CreateRunAsync("player-42");
Console.WriteLine(r.Run!.HubUrl);  // một link (hoặc mã QR) cho cả lượt
var done = await gate.WaitForCompletionAsync(r.Run.Id);
if (done.Ok && done.Run?.Status == "completed") Console.WriteLine(done.Run.Result!.LicenseKey);

C++

Mã
lr::LinkOptions o;
o.campaign_id = "lcmp_xxxxxxxx";
o.public_keys = {{"lksk_xxxxxxxx", "PUBLIC_KEY_BASE64URL"}};
lr::LinkGate gate(o);
auto r = gate.create_run("player-42");
std::puts(r.run->hub_url.c_str());  // một link (hoặc mã QR) cho cả lượt
auto done = gate.wait_for_completion(r.run->id);  // chặn luồng
if (done.ok && done.run->status == "completed") std::puts(done.run->result->license_key.c_str());

Hàm

HàmViệc
createRun(externalUser?)Mở lượt. externalUser (≤ 128 ký tự) là mã người dùng của bạn: thống kê và giới hạn mỗi ngày. run.hubUrl là trang lượt (một link cho cả lượt).
getRun(runId)Lượt lúc này. Rẻ: poll 2–5 giây một lần là được.
cancelRun(runId)Huỷ lượt đang chờ; link bọc ngừng chạy.
waitForCompletion(runId)Poll tới khi lượt không còn pending (completed, expired, cancelled); lỗi mạng tự thử lại, mã khác thì dừng; hết thời gian chờ → timeout.

Tên hàm theo quy ước của từng ngôn ngữ (create_run, CreateRunAsync…). Bảng mã ở Lượt (client API).

Bảo mật

  • Chỉ mở khoá theo result mà SDK đã xác minh. Đừng tin ứng dụng tự báo "đã mở đủ link" — người dùng sửa được mọi thứ trên máy của họ.
  • Ứng dụng phía người dùng (game, launcher) dùng LinkGate trực tiếp được: chỉ cần mã chiến dịch và khoá công khai. Không bao giờ nhúng API key lrs_….
  • Khoá LR License hay mã trong result chỉ trả cho lượt đó; nếu cần, cấp thêm từ máy chủ của bạn qua webhook.