Repository navigation
Closed
Description
なにをするか
通常モードのブロックは足さずに(E5)、センサー名を教科書の一般的な名前にし、選択肢を増やし(E4・E5)、ロボットのブロックを パレットの後ろの「ロボットカー」の見出し にまとめる(E6)。
決まったこと(#2162 が正)
- E3: ポートの配置はいまの S1 の配置のまま(A0/A1 LED、A2 タッチ、A4/A5 赤外線(フォトリフレクタ)、A6 光、A7 音、M1/M2 DC モーター、D10 サーボ)。
- E4: 教科書の一般的な名前を先に、部品名をかっこで:「光センサー (A6)」「赤外線センサー(フォトリフレクタ)(A4)」「タッチセンサー (A2)」「音センサー (A7)」。
- E5: 通常モードにはできる限りブロックを足さない。選択肢だけ増やす。「左のセンサー」もあるし「赤外線センサー(フォトリフレクタ)(A4)」もある、という形。
- E6: ロボットのブロック(前進させる・アームを曲げる等)は残したまま、パレットの後ろの方に「ロボットカー」の見出しをつけてまとめる。名前は「車を前進させる」など一般的に。通常モードではブロックを足さず、極力互換性を保つ。
変える場所(案。実装時にコードに合わせて調整)
packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/index.js と locale(ja.js / ja-Hira.js / en.js の smalrubotS1.*):
- センサーのメニュー
sensorPositions(いまの値:left/right/touch/light/sound):- 既存の値はそのまま。表示を「左のセンサー (A4)」「右のセンサー (A5)」「タッチセンサー (A2)」「光センサー (A6)」「音センサー (A7)」に。
- 選択肢を足す: 「赤外線センサー(フォトリフレクタ)(A4)」「赤外線センサー(フォトリフレクタ)(A5)」。値は新しく(例
ir_a4/ir_a5)、読むポートはleft/rightと同じ。getSensorValueの switch に足す。 - 並び順(一般的な名前を先にするか)と既定値(いまは
left)を決める。既定値を変えても、保存済みの作品の値は変わらない。
- LED・DC モーターの
positions(left/right): LED とモーターで 同じメニューを使っているので、片方だけの選択肢(「LED (A0)」など)は足せない。ブロックの文言で一般的な名前とポートを出す(例「[POSITION] の LED (左:A0, 右:A1) をオンにする」)にとどめる。メニューを分けるなら下の「互換の注意」を守る。 - 動きのメニュー
actions: 表示を「車を前進させる」「車を後退させる」「車を左に曲げる」「車を右に曲げる」「車を止める」に(値forward/backward/left/right/stopはそのまま)。 - アームのブロック(
bendArm/setArmCalibration): 文言を一般的に(例「アーム(サーボモーター D10)」)。 - 並び順と見出し: センサー・LED・DC モーターの速さを前に、
action/actionAndStopAfter/bendArm/setArmCalibrationを後ろに並べ、その前に「ロボットカー」の見出しを置く。この scratch-vm にはBlockType.LABELが無い('---'の区切りだけ)。見出しを出すには、拡張機能の見出し(ラベル)を VM と scratch-blocks の XML に通す仕組みを足す(upstream のファイルを触るならマーカー+docs/maintenance/smalruby-markers-vm.md/-gui.md)か、'---'の区切りと文言で代える。どちらにするかを実装時に決め、PR に書く。getInfo().blocksの並び替えは保存形式に影響しない。 - Ruby 側も新しい選択肢の値を通す:
packages/scratch-gui/src/lib/ruby-to-blocks-converter/smalrubot_s1.jsのSENSOR_POSITIONSに足す。ふりがな(src/lib/furigana-extension-handlers.jsのSMALRUBOT_S1_*_LABELS)とスニペット(src/containers/ruby-tab/smalrubot-s1-snippets.json)の表示名も新しい名前に。
互換の注意(守ること)
- 拡張機能の ID・opcode・メニューの名前(
actions/sensorPositions/positions)・既存のメニューの値は変えない。sb3 にはメニューの影のブロック(smalrubotS1_menu_sensorPositionsなど)とフィールドの値がそのまま保存されている。メニューの名前を変える・分けると、前の作品のブロックが壊れる。 - 選択肢は 足すだけ(消さない・値を変えない)。
- 翻訳キーは変えず、文言だけ変える。
テスト
- scratch-vm(tap):
test/unit/extension_smalrubot_s1.jsに、新しい値ir_a4/ir_a5が A4 / A5 を読むこと、既存の値がいままでどおりのポートを読むこと、メニューの値の集合が既存の値を含むことを足す。 - scratch-gui(jest):
test/unit/lib/ruby-to-blocks-converter/smalrubot_s1.test.jsとtest/unit/lib/ruby-roundtrip/extension_smalrubot_s1.test.jsに新しい値の行を足す。test/unit/lib/furigana-annotator.test.jsの該当行。 - 既存の sb3 を開いて、ブロック・選ばれている値がそのまま出ることを確かめる。
DoD
- docs(ブロックと選択肢の一覧)を更新し、パレットのスクリーンショット(
docs/extension-smalrubot-s1/screenshots/0301-block-palette-1280x800.pngなど。docs を移していればそちら)を撮り直す。 - 言語仕様
docs/smalruby-language-spec-extensions*.mdの該当の節(センサーの値の一覧)を更新。
親 EPIC: #2162 。設計のページ: https://claude.ai/artifact/RGmK1RHWRRu1whrgmmeNGN 。#2187(docs)のあとに行う。Ruby の studuino.(#2190)はこのあと。
Metadata
Metadata
Assignees
Labels
No labels
Activity
docs(studuino): retake the block palette screenshot with the robot ca…
smalruby3-editor-bot commentedon Nov 18, 2026
PR #2228 を topic/studuino-2162 にマージしました。