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

アプリを起動する

• Web版は、サンプルサイトから作品を開きます。
• SB3はTurboWarpで開き、緑の旗を押します。

タイトル画面が表示された後の操作は、利用形態によって異なります。

Web版または再生用SB3を再生する

1. タイトル画面をクリックします。
2. 組み込み済みの台本と作品固有アセットが読み込まれます。
3. 紙芝居が始まります。

ファイル選択は必要ありません。画像・音声・台本は作品へ組み込まれていますが、ポーズ認識を使う作品ではTurboWarp TMのライブラリ・モデル取得とカメラ利用のためにネットワーク接続が必要です。

汎用SB3または編集用SB3で台本を読み込む

1. メニューにあるファイル読込ボタン（ファイルを開く／Open）を押します。
2. .txt の台本ファイルを選びます。
3. アプリが台本を読み込みます。
4. 台本にLoading用背景や画像が指定されている場合は、それらを先に読み込みます。
5. Loadingの吹き出しで進捗を表示しながら、残りの画像や音声を読み込みます。編集用SB3では作品固有アセットをSB3内から、汎用SB3では台本の指定に従って読み込みます。
6. 読み込みが終わると、紙芝居が始まります。

台本を一度読み込むと、ブラウザーのlocalStorageに保存されます。同じブラウザーであれば、次回以降は前回の台本を再生できます。

前回の台本を再生する

1. 緑の旗を押します。
2. 前回台本ボタン（もう一度／Reload）が表示されていることを確認します。
3. 前回台本ボタンを押します。
4. 保存されている台本が再生されます。

注意: localStorageはブラウザーごとの保存領域です。別のブラウザー、別の端末、シークレットモードでは前回台本が表示されないことがあります。

Loadingの見方

Loadingの吹き出しは完了数 / 総数です。3 / 10なら、通常アセット10件のうち3件の読込が完了しています。Loading表示そのものに使う背景や画像は先に読み込まれるため、この分子・分母には含まれません。

台本作者はsetLoadingBackdrop=loadingBackgroundでLoading中の背景を、setLoadingCostume=loading1,loading2,loading3でLoading画像を指定できます。背景を指定しない場合は真っ黒な組み込み背景を使います。Loading画像が複数指定されている場合は、通常アセットの読込番号に応じて順番に切り替わります。進捗の吹き出しは画像とは別の固定位置から表示されるため、各画像の大きさや外形が異なっても位置は変わりません。

カメラを許可する

台本を再生すると、ブラウザーがカメラ利用の許可を求める場合があります。ポーズ認識を使う紙芝居では、カメラを許可してください。

許可しない場合、ポーズ認識が進まず、物語が止まることがあります。

ポーズを取る

1. 画面にポーズ案内が表示されます。浦島太郎の公開台本では「ポーズをとろう！」、未定義時は Pose! です。
2. カメラの前に立ちます。
3. 画面のキャラクターや進行役の指示に合わせてポーズを取ります。
4. 正しく認識されると、チャージが増えます。
5. チャージが100になると、そのポーズは成功です。
6. 複数のポーズがある場合は、次のポーズに進みます。

台本でsetPoseRecognitionSound=Clock Ticking,Sewing Machineのように音声アセット名を指定すると、第1音を各ポーズの認識開始から終了まで鳴らし、第2音をポーズが認識されるたびに鳴らせます。第2音は省略でき、コマンド自体を省略した場合は無音です。

ポーズが認識されにくいとき

次の点を確認してください。

事前準備

発表前に、必ず1回は最初から最後まで再生テストをしてください。特に次の点を確認します。

• 台本ファイルが読み込めるか
• 画像が表示されるか
• 音声が鳴るか
• カメラが使えるか
• ポーズ認識が進むか
• プロジェクタや画面共有で見やすいか

進行のコツ

紙芝居の途中でポーズ認識が入る場合、発表者は次のように案内するとスムーズです。

「ここでみんなの力が必要です。画面の前でカメを助けるポーズをしてみましょう。」

ポーズ認識は、動作が大きく、止まっている時間が少し長いほど成功しやすくなります。急いで動くより、「ポーズを作って、少し待つ」のがコツです。

参加人数の考え方

ポーズ認識は基本的に、カメラに映っている人の姿勢をもとに判断します。大人数が一度に映ると認識が不安定になることがあります。授業では、代表者が前に出てポーズを取る形式が扱いやすいです。

台本エラーが表示される

台本の文法に誤りがある可能性があります。未定義時は Invalid script、浦島太郎の公開台本では「エラー：不正な台本ファイル」と表示されます。

確認すること:

• 先頭にkamishibai=3.1またはkamishibai=3.2があるか（新規台本は3.2を推奨）
• key=value の形式になっているか
• 未対応のコマンド名を書いていないか
• action= の区切り : が不足していないか
• --- の位置が正しいか
• 分岐先の sceneLabel が存在するか

画像や音が読み込まれない

アセットURLが間違っている、URL先にアクセスできない、ネットワークが使えない、ブラウザーが読み込みを拒否している可能性があります。

確認すること:

• URLをブラウザーで直接開けるか
• ファイル名の大文字・小文字が一致しているか
• 画像や音声が公開URLに置かれているか
• ネットワークが安定しているか
• setLoadingBackdropに書いた名前がasset=で画像として定義されているか
• setLoadingCostumeに書いた名前がasset=で画像として定義されているか

紙芝居が途中で止まる

多くの場合、ポーズ認識待ち、音声の再生待ち、または長い wait の途中です。

確認すること:

• 「ポーズをとろう」が表示されていないか
• sound で長い音声を再生していないか
• wait の秒数が大きすぎないか

セリフが想定通りに出ない

say と think では、半角 : が本文と秒数の区切りとして使われます。本文に半角 : を入れると、本文と秒数の対応が崩れます。

対処:

• セリフ内では ： のような全角記号を使う
• = はセリフ本文に使用できる。コマンド行で区切りになるのは最初の = だけ