情境資料佮同意

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

你的應用程式干焦會當透過情境資料片段知影學習者的代誌。逐个片段攏是一份欄位固定的細份記錄。你的清單列出伊要求的片段，學習者佇安裝你的應用程式的時一个一个同意，Lingara 干焦佇這兩項攏猶成立的時才會送一个片段。

片段

片段	欄位	內底有啥物
`languages`	`source_lang`	學習者用來學的語言，用語言標記表示，親像 `en`。
	`target_lang`	個咧學的語言。
	`level`	個佇彼種語言的等級，對 1 到 9，前提是個有設定。
`plan_summary`	`plan_id`	個上新的課程計畫的 id，用來分別一个計畫佮另外一个計畫。你的應用程式袂當用伊提彼个計畫，因為你的應用程式的權杖讀的是你家己的帳戶，毋是學習者的。
	`title`	彼个計畫產生出來的標題，上濟 120 字，前提是伊有標題。
	`target_lang`	彼个計畫教的語言。
	`set_count`	彼个計畫有偌濟組，上濟 200。
	`sets_completed`	學習者已經完成其中偌濟組。
`review_due`	`due`	這馬有偌濟張閃卡愛複習，上濟 100000。
	`learned`	個已經學會偌濟个詞，上濟 100000。
`tutor_topic`	`topic`	個上新的導師對話咧講啥物，對 1 到 120 字。伊來自一个計畫的標題抑是個所在的畫面，永遠毋是來自個家己的話。

無任何片段會紮的物件

無任何片段會紮電子郵件地址、名、使用者 id，抑是學習者拍過的任何物件。你的應用程式對請求的 subject 知影學習者是啥人，這是一个穩定的值，逐个應用程式收著的攏無仝。你的應用程式的權杖讀的是你家己的帳戶，永遠毋是學習者的，所以片段就是你的應用程式對個所知的全部。

同意

學習者佇安裝你的應用程式的時，一个一个同意逐个片段。若欲改個同意的物件，個愛解除安裝你的應用程式才閣重新安裝。
若你改清單要求較少的片段，你提掉的彼寡會隨停。
若你改清單要求較濟的片段，新的片段佇學習者重新安裝進前袂到任何學習者遐。
Lingara 逐擺請求攏會閣檢查一擺同意，學習者無同意的、抑是你的清單已經無閣要求的片段，攏會予人擲掉。袂合伊記錄格式的片段嘛會予人擲掉，毋過永遠袂共規个請求擲掉。

下跤的範例用伊收著的片段組出伊的一逝字，無呼叫任何 API。

TypeScriptRustGoJavaKotlinRubyPHP

TypeScript

// The app's own client reads its owner's account, never the learner's. The
// slices are all a render knows about the learner.
function planLine(request: AppRenderRequest): string {
  let line = "";
  for (const slice of request.context) {
    // A slice is present only when the learner agreed to share it.
    if (slice.kind === "languages") line += `${slice.source_lang} → ${slice.target_lang}. `;
    if (slice.kind === "plan_summary") line += `${slice.sets_completed}/${slice.set_count} sets.`;
  }
  return line;
}

Rust

// The app's own client reads its owner's account, never the learner's. The
// slices are all a render knows about the learner.
/// The learner's target language and, when they shared their plan, its
/// `(sets_completed, set_count)`.
fn shared_plan(request: &AppRenderRequest) -> (String, Option<(u32, u32)>) {
    let (mut target_lang, mut progress) = (String::from("zh"), None);
    for slice in &request.context {
        match slice {
            ContextSlice::Languages(languages) => target_lang = languages.target_lang.clone(),
            ContextSlice::PlanSummary(summary) => progress = Some((summary.sets_completed, summary.set_count)),
            _ => {}
        }
    }
    (target_lang, progress)
}

// The app's own client reads its owner's account, never the learner's.
// The slices are all a render knows about the learner.
//
// Each slice is present only when the learner agreed to share it.
card := lingaraapps.NewCard().Heading("Your plan", 1)
for _, slice := range req.Context {
	switch s := slice.(type) {
	case lingaraapps.ContextSliceLanguages:
		card.Text(fmt.Sprintf("Learning %s from %s", s.TargetLang, s.SourceLang))
	case lingaraapps.ContextSlicePlanSummary:
		card.Text(fmt.Sprintf("%d of %d sets done", s.SetsCompleted, s.SetCount))
	}
}

Java

import com.getlingara.apps.Card;
import com.getlingara.apps.Reply;
import com.getlingara.apps.model.AppRenderRequest;
import com.getlingara.apps.model.ContextSlice;
import com.getlingara.apps.model.ContextSliceLanguages;
import com.getlingara.apps.model.ContextSlicePlanSummary;

// The app's own client reads its owner's account, never the learner's. The slices are all a
// render knows about the learner.
static Reply render(AppRenderRequest request) {
  Card.Builder card = Card.card();
  // A slice is present only when the learner agreed to share it; the context is read-only.
  for (ContextSlice slice : request.getContext()) {
    if (slice instanceof ContextSliceLanguages languages) {
      card.heading("Learning " + languages.targetLang(), 1);
    } else if (slice instanceof ContextSlicePlanSummary summary) {
      card.text(summary.setsCompleted() + " of " + summary.setCount() + " sets done");
    }
  }
  return card.heading("Today", 2).build();
}

Kotlin

import com.getlingara.apps.kotlin.Reply
import com.getlingara.apps.kotlin.card
import com.getlingara.apps.kotlin.model.AppRenderRequest
import com.getlingara.apps.kotlin.model.ContextSliceLanguages
import com.getlingara.apps.kotlin.model.ContextSlicePlanSummary

// The app's own client reads its owner's account, never the learner's. The slices are all a
// render knows about the learner.
fun renderWithContext(request: AppRenderRequest): Reply {
    // A slice is present only when the learner agreed to share it; the context is read-only.
    val languages = request.context.filterIsInstance<ContextSliceLanguages>().firstOrNull()
    val summary = request.context.filterIsInstance<ContextSlicePlanSummary>().firstOrNull()
    return card {
        heading("Learning ${languages?.targetLang ?: "today"}", 1)
        if (summary != null) {
            text("${summary.setsCompleted} of ${summary.setCount} sets done")
        }
    }
}

Ruby

# The app's own client reads its owner's account, never the learner's. The
# slices are all a render knows about the learner.
#
# A slice is present only when the learner agreed to share it.
request.context.filter_map do |slice|
  case slice
  in Lingara::Apps::ContextSliceLanguages(source_lang:, target_lang:)
    "#{source_lang} → #{target_lang}."
  in Lingara::Apps::ContextSlicePlanSummary(sets_completed:, set_count:)
    "#{sets_completed}/#{set_count} sets."
  else nil
  end
end.join(" ")

PHP

use Lingara\Apps\Generated\ContextSliceLanguages;
use Lingara\Apps\Generated\ContextSlicePlanSummary;

function planLine(AppRenderRequest $request): string
{
    // The app's own client reads its owner's account, never the learner's. The
    // slices are all a render knows about the learner.
    $line = '';
    // A slice is present only when the learner agreed to share it.
    foreach ($request->getContext() as $slice) {
        if ($slice instanceof ContextSliceLanguages) {
            $line .= "{$slice->sourceLang} → {$slice->targetLang}. ";
        } elseif ($slice instanceof ContextSlicePlanSummary) {
            $line .= "{$slice->setsCompleted}/{$slice->setCount} sets.";
        }
    }
    return $line;
}

閣看

Lingara API 函式庫