Lingara Lingara 說明文件 學習指南 API 函式庫 App 建立 網頁版
語言: 客家話

開發 Lingara App

這頁係對英文翻譯過來个。若係兩片無共樣,以英文頁為準。 看英文頁

Lingara App 係一台你自家在運行个伺服器。學習者安裝你个 App 以後,Lingara 會送一隻簽名過个請求到你个伺服器,你个伺服器用一張卡片回應,Lingara 再用佢自家个風格將該張卡片畫出來。你个程式碼永遠毋會在學習者个裝置頂高行,也永遠看毋到 Lingara 在該位儲存个東西。

對 Lingara 來講,App 就係一隻有清單个 OAuth 用戶端。用戶端分你个 App 一隻身分。清單就講明佢个卡片做得在哪位出現、佢想愛看麼个,還有 Lingara 愛將請求送到哪位。

卡片在哪位出現

你个清單列出你个卡片做得填入去个位所。總共有兩隻:

  • plans.empty_detail:課程計畫畫面還吂揀任何計畫个時節,該隻詳細資料窗格。只要螢幕闊到做得顯示兩隻窗格,網頁、Android 摎 iOS 都會畫出佢。
  • home.side:網頁首頁个側邊欄。

兩隻位所都無畫出來个地方,學習者做得從「App」用全螢幕打開你个 App:網頁係在控制台肚項,Android 摎 iOS 係在「設定」肚項。每隻位所一擺淨顯示一隻 App。學習者若在同一隻位所安裝幾隻 App,就由佢兜自家揀這位顯示哪一隻。

麼人做得安裝 App

這下 App 淨做得由佢个主人安裝在自家个帳戶。別人个安裝還吂開放。

你需要麼个

  • 一隻 OAuth 用戶端,你在控制台建立。
  • 一台用 HTTPS 回應 Lingara 請求个伺服器。
  • 下背其中一隻 App 套件。套件會檢查每隻請求个簽名,在你送出卡片以前將佢限在 Lingara 个上限肚項,再寫好回應。

快速入門會帶你行過歸隻流程,從一隻新个用戶端到你自家帳戶頂高个一張卡片。

安裝套件

在下背揀你个語言。

TypeScript

npm install @lingara/apps@0.1.0-alpha.6

Rust

cargo add lingara-apps@0.1.0-alpha.6 --features axum
cargo add axum@0.8
cargo add tokio --features macros,net,rt-multi-thread

Go

go get github.com/Spinning-Cat-Studios/lingara_app_framework_sdk/go@v0.1.0-alpha.6

Java

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-apps-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

Kotlin

implementation("com.getlingara:lingara-apps-kotlin:0.1.0-alpha.6")

Ruby

gem install lingara-apps -v 0.1.0-alpha.6

PHP

composer require spinningcatstudios/lingara-apps:0.1.0-alpha.6 spinningcatstudios/lingara:@alpha

開發一隻 App

  • 快速入門

    從一隻新个 OAuth 用戶端,到你个 App 卡片出現在你自家个帳戶。

  • 卡片

    組成一張卡片个八種元素、Lingara 會套用个限制,還有卡片失敗个時節學習者會看到麼个。

  • 情境資料摎同意

    你个 App 做得一隻欄位一隻欄位知學習者麼个,還有學習者仰般同意。

  • 導師備註

    你个 App 做得提供分 Lingara 導師个一行字,還有佢愛經過个規則。