Nhúng Lingara

Trang này được dịch từ tiếng Anh. Nếu hai bản khác nhau, trang tiếng Anh là bản đúng. Đọc trang tiếng Anh

Lingara có thể nằm bên trong trò chơi hoặc trang web của bạn. Một nhân vật trong thế giới của bạn có thể trò chuyện ở đúng cấp độ của người chơi, và phần luyện tập người chơi hoàn thành được tính là luyện tập trên Lingara. Phần nhúng có hai nửa, và điều đầu tiên cần xác định là nửa nào chạy ở đâu.

Ai giữ gì

Máy chủ của bạn giữ khóa bí mật của máy khách OAuth và khóa bí mật dùng để ký webhook. Không khóa nào rời khỏi máy chủ.

Thiết bị của người chơi chỉ giữ một thứ: một mã nhúng, bắt đầu bằng lgr_et_. Bất cứ thứ gì bạn phát hành bên trong tệp nhị phân của trò chơi hay trong một trang web đều là công khai, nên thiết bị không bao giờ giữ khóa bí mật máy khách, khóa bí mật webhook hay mã truy cập của chính máy khách của bạn. Một mã nhúng chỉ hành động thay cho một người chơi, có hiệu lực trong vài phút chứ không phải vài giờ, và chỉ mang những phạm vi mà máy chủ của bạn đã cấp cho nó.

Người chơi không cần tài khoản Lingara. Mã đầu tiên máy chủ của bạn cấp cho một người chơi sẽ tạo một người học khách cho họ, và mọi mã sau đó đều đến cùng người học đó. Người chơi đã có tài khoản Lingara có thể mang tài khoản đó theo: trang bộ công cụ máy chủ mô tả cách máy chủ của bạn liên kết hai tài khoản với nhau.

Cách một mã đến tay người chơi

1. Bộ công cụ người chơi, trong trò chơi hoặc trên trang của bạn, cần một mã và hỏi máy chủ của bạn thông qua nguồn mã của nó.
2. Máy chủ của bạn kiểm tra phiên của chính mình cho người chơi đó và cấp một mã cho họ bằng bộ công cụ máy chủ.
3. Máy chủ của bạn trả mã về dưới dạng hai trường, mã và thời điểm hết hạn của nó, thông qua phiên của chính bạn và không bao giờ trong URL.
4. Bộ công cụ người chơi dùng mã cho đến khi mã gần hết hạn, rồi hỏi lại máy chủ của bạn. Lingara không bao giờ làm mới mã.

 player's device                your server                    Lingara
 ───────────────                ───────────                    ───────
 player kit ── needs a token ──▶ your token route
                                 server kit ── mint ─────────▶ token for one player
 player kit ◀── token, expiry ── your token route ◀──────────
 player kit ── API calls with the token ─────────────────────▶

Mã cho một trang web được gắn với một nguồn gốc: lược đồ, tên máy chủ và cổng của chính trang đó. Hãy đăng ký mọi nguồn gốc mà tiện ích của bạn chạy trên đó trước khi cấp mã cho nguồn gốc ấy, như trang bộ công cụ máy chủ mô tả. Mã cho trò chơi không có nguồn gốc.

Một mã được phép làm gì

Máy chủ của bạn chọn phạm vi cho mỗi mã khi cấp mã, từ năm phạm vi sau: events:read, events:write, lesson_plans:read, lesson_plans:write và embed:play. Một mã chỉ có thể mang những phạm vi mà chính máy khách của bạn đã có. embed:play cho phép người chơi trò chuyện với các nhân vật của bạn và báo cáo phần luyện tập họ hoàn thành.

Ai trả tiền

Chỉ máy khách dùng gói trả theo mức dùng mới có thể cấp mã. Mọi thứ người chơi làm bằng một mã đều được tính là mức sử dụng của máy khách của bạn và được tính tiền cho bạn, không phải cho người chơi.

Xóa một người chơi

Khi người chơi xóa tài khoản của họ trong trò chơi của bạn, máy chủ của bạn cũng xóa họ trên Lingara. Việc đó gỡ bỏ người học của họ cùng mọi thứ Lingara lưu giữ về họ, và thu hồi mọi mã họ đang giữ.

Bạn cần bộ công cụ nào

Mọi tích hợp đều dùng hai bộ công cụ: một bộ công cụ máy chủ trên máy chủ của bạn, và một bộ công cụ người chơi ở nơi người chơi chơi.

Sau đó hãy đọc hội thoại NPC và kết quả luyện tập, hai phần này hoạt động giống nhau trong mọi bộ công cụ.