جاسازی Lingara

این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم فرق داشته باشند، صفحهٔ انگلیسی درست است. صفحهٔ انگلیسی را بخوانید

Lingara می‌تواند داخل بازی یا ویب‌سایت شما کار کند. یک شخصیت در دنیای شما می‌تواند در سطح بازیکن گفتگو کند، و تمرینی که بازیکن شما تکمیل می‌کند به حیث تمرین Lingara حساب می‌شود. جاسازی دو نیمه دارد، و اولین چیزی که باید روشن شود این است که کدام نیمه در کجا اجرا می‌شود.

چه کسی چه چیزی را نگه می‌دارد

سرور شما رمز کلاینت OAuth و رمز امضای وب‌هوک شما را نگه می‌دارد. هیچ‌کدام هرگز از آن بیرون نمی‌رود.

دستگاه بازیکن تنها یک چیز را نگه می‌دارد: یک توکن جاسازی که با lgr_et_ شروع می‌شود. هر چیزی که داخل فایل اجرایی یک بازی یا یک صفحهٔ ویب منتشر می‌کنید عمومی است، پس دستگاه هرگز رمز کلاینت، رمز وب‌هوک یا توکن دسترسیِ کلاینت خودتان را نگه نمی‌دارد. توکن جاسازی تنها از طرف یک بازیکن عمل می‌کند، به جای چند ساعت چند دقیقه دوام می‌کند، و تنها مجوزهایی را دارد که سرور شما به آن داده است.

بازیکن به حساب Lingara ضرورت ندارد. اولین توکنی که سرور شما برای یک بازیکن صادر می‌کند یک آموزندهٔ مهمان برای او می‌سازد، و هر توکن بعدی به همان آموزنده می‌رسد. بازیکنی که از قبل حساب Lingara دارد می‌تواند آن را با خود بیاورد: صفحهٔ کیت‌های سرور توضیح می‌دهد که سرور شما چگونه این دو را با هم پیوند می‌دهد.

توکن چگونه به بازیکن می‌رسد

1. کیت بازیکن، در بازی یا صفحهٔ شما، به توکن ضرورت دارد و از طریق منبع توکن خود آن را از سرور شما درخواست می‌کند.
2. سرور شما نشست خودش را برای آن بازیکن بررسی می‌کند و با کیت سرور یک توکن برای او صادر می‌کند.
3. سرور شما توکن را در دو فیلد، خود توکن و زمان انقضای آن، از طریق نشست خودتان و هرگز نه در یک URL، پس می‌فرستد.
4. کیت بازیکن تا نزدیک شدن به زمان انقضا از توکن استفاده می‌کند و بعد دوباره از سرور شما درخواست می‌کند. Lingara هرگز توکنی را تمدید نمی‌کند.

 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 ─────────────────────▶

توکنِ یک ویب‌سایت به یک مبدأ وابسته است: طرح، میزبان و پورت خود صفحه. هر مبدأیی را که ویجت شما روی آن اجرا می‌شود پیش از صادر کردن توکن برای آن ثبت کنید، طوری که صفحهٔ کیت‌های سرور توضیح می‌دهد. توکنِ یک بازی مبدأ ندارد.

توکن چه کارهایی می‌تواند بکند

سرور شما مجوزهای هر توکن را هنگام صادر کردن آن از میان این پنج مورد انتخاب می‌کند: events:read، events:write، lesson_plans:read، lesson_plans:write و embed:play. یک توکن تنها می‌تواند مجوزهایی را داشته باشد که کلاینت خودتان از قبل دارد. embed:play به بازیکن اجازه می‌دهد با شخصیت‌های شما گفتگو کند و تمرینی را که تکمیل می‌کند گزارش دهد.

چه کسی پرداخت می‌کند

تنها کلاینتی که روی پلان مبتنی بر مصرف است می‌تواند توکن صادر کند. هر کاری که بازیکن با یک توکن انجام می‌دهد به حیث مصرف کلاینت شما حساب می‌شود و هزینهٔ آن از شما گرفته می‌شود، نه از بازیکن.

حذف یک بازیکن

وقتی بازیکنی حساب خود را در بازی شما حذف می‌کند، سرور شما او را در Lingara نیز حذف می‌کند. این کار آموزندهٔ او و هر چیزی را که Lingara برای او نگه می‌دارد حذف می‌کند و همهٔ توکن‌هایی را که دارد باطل می‌کند.

به کدام کیت ضرورت دارید

هر یکپارچه‌سازی از دو کیت استفاده می‌کند: یک کیت سرور روی سرور شما، و یک کیت بازیکن در جایی که بازیکن بازی می‌کند.

بعد گفتگوی NPC و نتایج تمرین را بخوانید که در همهٔ کیت‌ها به یک شکل کار می‌کنند.