stack-chan

# ブロックエディタのチュートリアル

## 5分でシミュレーターを動かす

1. Webツールから「ブロックエディタ」を開きます。
2. サンプルボタンから「1. あいさつと表情」を選びます。
3. 「スタートしたとき」の内側に、好きな表情ブロックを置きます。
4. 「ビルド」を押します。
5. 診断にエラーがなければ「シミュレーターで実行」を押します。
6. シミュレーター内の顔と吹き出しが変わることを確認します。

## 15分で入力に反応させる

1. 「イベント」からボタン、タッチ、IMUのいずれかを選びます。
2. イベントの内側に、発話、表情、姿勢のブロックを接続します。
3. 対象機種を選び、診断欄に未対応能力がないことを確認します。
4. シミュレーターで実行し、ダイアログ上部のA、B、Cボタンで入力を試します。
5. 実機を使う場合は、シミュレーターで停止しないことを確認してから「実機へ書き込み」を押します。
6. チップ、実ファームウェア版、XS版、パーティション、サイズ、使用能力を確認して書き込みを承認します。

## 30分でShape型Faceを組み込む

1. Webツールから「Shape顔エディタ」を開きます。
2. Face領域、左右の目、まぶた、口の位置と寸法を調整します。
3. プレビュー上で目と口をドラッグし、表情と配色を確認します。
4. 「ブロックエディタで使う」を押します。
5. ブロックエディタのアセット欄に「使用中」と表示されることを確認します。
6. 生成コードに`FaceBase.template`と`robot.ui.setFace`が含まれることを確認します。
7. ビルドしてシミュレーターで実行します。
8. プロジェクト保存ボタンから`.stackchan-blocks.json`を保存します。
9. `.xsa`も保存し、編集用成果物と実行用成果物を分けて管理します。

## コードによる開発へ移る

生成コードタブの`mod.js`は、通常のMODと同じ`onContextCreated(robot)`を公開します。

ローカル開発へ移る場合は、生成コードをMODディレクトリの`mod.js`へ保存し、プロジェクトのmanifestとアセットを同じディレクトリへ配置します。

ブロックエディタへ戻る可能性がある間は、`.stackchan-blocks.json`も保持します。

生成コードを直接変更しても、元のBlocklyワークスペースへは逆変換されません。

## 失敗から復旧する

実機へ書き込む前に、対象機種、ファームウェア、XSアーカイブの互換性を自動で検証します。

検証を通過すると既存MODを置き換え、書き込み後の内容を読み戻して確認します。

MODを起動したくない場合は「実機のMODを削除」を使います。

ファームウェア本体はこれらの操作で消去しません。

ブラウザ内のプロジェクトを解析できない場合は、ヘッダーに警告ボタンが表示されます。

警告ボタンから元データとエラーを含む復旧用JSONを保存してください。