Lingara Lingara 說明文件 學習指南 API 函式庫 應用程式 起造 網頁版
語言: 閩南語

開發 Lingara 應用程式

這頁是對英文翻譯過來的。若兩篇無仝,以英文頁為準。 看英文頁

Lingara 應用程式是一台你家己咧運行的伺服器。學習者安裝你的應用程式了後,Lingara 會送一个簽名過的請求去你的伺服器,你的伺服器用一張卡片回應,Lingara 才用伊家己的風格共彼張卡片畫出來。你的程式碼永遠袂佇學習者的裝置頂懸行,嘛永遠看袂著 Lingara 佇遐儲存的物件。

對 Lingara 來講,應用程式就是一个有清單的 OAuth 用戶端。用戶端予你的應用程式一个身分。清單就講明伊的卡片會使出現佇佗位、伊要求看啥物,閣有 Lingara 欲共請求送去佗位。

卡片出現佇佗位

你的清單列出你的卡片會使填入去的所在。總共有兩个:

  • plans.empty_detail:課程計畫畫面猶未揀任何計畫的時,彼个詳細資料窗格。只要螢幕闊甲會當顯示兩个窗格,網頁、Android 佮 iOS 攏會共伊畫出來。
  • home.side:網頁首頁邊仔的欄。

兩个所在攏無畫出來的所在,學習者會使對「應用程式」用全螢幕拍開你的應用程式:網頁是佇控制台內底,Android 佮 iOS 是佇「設定」內底。逐个所在一擺干焦顯示一个應用程式。學習者若佇仝一个所在安裝幾若个應用程式,就由個家己揀遮欲顯示佗一个。

啥人會使安裝應用程式

這馬應用程式干焦會使由伊的主人安裝佇家己的帳戶。別人的安裝猶未開放。

你需要啥物

  • 一个 OAuth 用戶端,你佇控制台建立。
  • 一台用 HTTPS 回應 Lingara 請求的伺服器。
  • 下跤其中一个應用程式套件。套件會檢查逐个請求的簽名,佇你送出卡片進前共伊限佇 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

開發應用程式

  • 快速入門

    對一个新的 OAuth 用戶端,到你的應用程式卡片出現佇你家己的帳戶。

  • 卡片

    組成一張卡片的八種元素、Lingara 會套用的限制,閣有卡片失敗的時學習者會看著啥物。

  • 情境資料佮同意

    你的應用程式會當一个欄位一个欄位知影學習者啥物,閣有學習者按怎同意。

  • 導師註記

    你的應用程式會當提供予 Lingara 導師的一逝字,閣有伊愛經過的規則。