見る・参加する・作る

TM紙芝居 4.0 ドキュメント

TM紙芝居4.0について、初めて知る方、作品を作る方、開発する方を、目的に合う文書へ案内します。

2026年8月26日確認

4.0.0-rc.10を公開しています

公開プレリリースv4.0.0-rc.10のStandard SB3とCLIを利用できます。 公開サンプル作品とチュートリアル成果物も、現在rc.10基準の成果物として公開しています。 最初に試す方は、「紙芝居を遊ぶ」チュートリアルから始めてください。

4.0.0-rc.10のSB3npmパッケージリリースノートは検証用のリリース候補です。安定版4.0.0はまだ未公開で、現在の最新安定版は v3.2.3です。版ごとの記録が必要な開発・リリース担当者は、 リリース履歴と、このページ後半の専門文書を参照してください。

目的に合う順番で読む

すべてを順番に読む必要はありません。最初に全体像をつかみ、その後は目的に合う経路へ進んでください。 細かな仕様書は最初から読む必要はありません。台本を作りながら、必要な項目だけを調べるための資料です。

初めて4.0を知る

  1. 大人向け子供向け概要のうち、対象に合うドキュメントを読む
  2. 概要で、できること、遊ぶ・作る流れ、安全上の注意をつかむ
  3. 「紙芝居を遊ぶ」チュートリアルで、公開作品を最後まで試す
  4. さらに作る、移行する、保守する場合だけ、目的別の経路へ進む

3.1/3.2作品を移行する

  1. 変換ガイドで元の台本を残したまま別ファイルへ変換する
  2. 台本作成ガイドで出力を読む
  3. 台本を検査し、ブラウザーで確認してから完成ファイルを作る

紙芝居を見る人向けドキュメント

紙芝居を遊ぶ

初めてTM紙芝居を再生する方

更新日:

公開サンプルを開き、ポーズを使って物語を最後まで進める手順を説明します。

紙芝居アプリ 4.0 概要説明書 大人向け

初めての方・保護者・教員・教材作成者・運営者

更新日:

TM紙芝居4.0でできること、遊ぶ・作る流れ、人とAIの役割、カメラを使う際の安全、教育利用を初めての方向けに説明します。

紙芝居アプリ 4.0 概要説明書 子供向け

子供・初めての方

更新日:

TM紙芝居4.0で「見る・動く・作る」方法と、カメラ、個人情報、まわりの安全、困ったときの行動をやさしい言葉で説明します。

紙芝居アプリ 4.0 操作説明書

初めてサンプル作品を試す方・進行役

更新日:

4.0のサンプル作品を開き、キー・タッチ・ポーズで進め、困ったときに戻る方法を順番に説明します。

台本を作る人向けドキュメント

紙芝居を作る

初めて紙芝居DSL 4.0を書く方

更新日:

公開スターターを変更し、プレビュー、検査、ビルドを経て作品を完成させます。

紙芝居DSL 4.0 台本作成ガイド

DSL 4.0の作品を作る方

更新日:

入門チュートリアルの次に、作品フォルダー、場面、命令、入力、分岐、エラーへの対処を必要な範囲で調べるガイドです。

DSL 4.0ランタイム変数ガイド

変数と条件分岐を使うDSL 4.0紙芝居制作者

更新日:

台本変数の宣言、runtime状態を使う分岐式、TurboWarpからの書込が反映される時期を、制作者向けに説明します。

紙芝居DSL 4.0 Schemaリファレンス

台本の項目・命令の制約を調べる方

更新日:

台本の項目や命令について、使える値、必須条件、制約を検索するための仕様一覧です。入門手順は扱いません。

紙芝居DSL 4.0 リリース履歴

4.0の公開を管理・確認する開発/リリース担当者

更新日:

候補版と正式版を区別し、確認したソース、配布物、既知の制約、公開状態を版ごとに記録します。一般向けの操作手順ではありません。

紙芝居DSL 3.2から4.0への変換ガイド

DSL 3.1/3.2の既存作品を4.0へ移行する方

更新日:

元の台本を残したまま4.0用の別ファイルへ変換し、警告を確認して作品作りへ引き渡す手順です。

TurboWarpでプログラムを書く人向けドキュメント

DSL 4.0ランタイムとのメッセージ・block・変数連携

DSL 4.0ランタイムからのメッセージに応じた動作の記述

DSL 4.0の台本とTurboWarpプログラムを連携する方

更新日:

broadcastMessageAndWaitで台本からメッセージを送り、TurboWarp側で受け取って処理を完了するまで待たせる方法を説明します。

DSL 4.0ランタイム ブロックリファレンス

集約ランタイムのTurboWarpブロックと公開変数を調べる方

更新日:

紙芝居ランタイムと6つの機能拡張に由来する公開ブロックと、TurboWarpから参照できる2つのStage変数を一覧にします。

DSL 4.0ランタイム変数 TurboWarp連携リファレンス

DSL 4.0のランタイム変数をTurboWarp blockから利用する方

更新日:

専用blockの戻り値、型付き書込、分岐式と共有するsnapshot、非公開範囲、既定OFFの段階導入契約を説明します。

アプリを開発する人向けドキュメント

TM紙芝居 4.0 アプリ・教材・ツールチェインガイド

教材・ワークショップ設計者、制作環境担当者、プレビュー/ビルド確認者

更新日:

概要説明の次に全員が読む文書ではなく、教材設計、制作環境、検証・プレビュー・ビルドを具体化するための全8ページの詳細ガイドです。

TurboWarp extension and toolchain overview

TurboWarp機能拡張、toolchain、TM Kamishibaiの関係を把握する開発者・教材作者

更新日:

ScratchからTurboWarp機能拡張、Composition API、SB3 Toolchain、TM Kamishibaiへ進む道筋と、各repositoryの責務・surface・license境界を正本dataから説明します。

紙芝居アプリ 4.0 ソフトウェアメンテナンスガイド

TM紙芝居4.0の実装と公開手順を保守する開発者

更新日:

実装の変更箇所とテスト、開発環境、プレビュー、完成ファイル、公開、切り戻しの手順を案内します。

DSL 4.0 release smoke

DSL 4.0のリリース候補を検証して公開可否を判断する方

更新日:

公開候補の内容を固定し、自動テスト、ブラウザー、カメラ、ポーズ、安全停止、検証記録、切り戻しを確認します。

TurboWarp TM Extension ID 移行ガイド

TM紙芝居とSB3を新しい認識拡張IDへ移行する開発者

更新日:

TurboWarp TMのExtension IDをkubohiroyatmへ統一し、SB3移行、確認、rollback、旧識別子の扱いを日本語と英語で説明します。

紙芝居アプリ 4.0 内部仕様書

TM紙芝居4.0の実装を調査・変更する方

更新日:

台本の読み込みから実行環境までの内部構造、責任分担、状態の切り替えを、用語表と実装経路に対応させて記録します。

TM紙芝居 4.0 機能拡張・プラットフォーム統合ガイド

TM紙芝居4.0と外部機能の接続を調査・変更する開発者

更新日:

実行部分と外部機能の責任分担、利用環境ごとの違い、権限、失敗時の代替動作、配布境界を説明します。

DSL 4.0 台本診断・安全停止 設計レビュー

DSL 4.0の診断と安全停止を実装・レビューする開発者

更新日:

台本の読み込みから実行までの失敗を分類し、問題のある状態を公開しないこと、安全に停止・後片付けすることを記録します。

upstream fork管理方針

TM Kamishibai ecosystemの上流forkを評価・同期・撤回する開発者

更新日:

scratch-renderを独自productではなく上流検証用forkとして扱い、差分、license、issue routing、exact commit pinを記録します。