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의 튜터에게 전달할 수 있는 한 줄과, 그 한 줄이 거치는 규칙.