Skip to content

feat(studuino): センサー名を教科書の名前にして選択肢を足し、ロボットのブロックを「ロボットカー」の見出しにまとめる #2189

Closed

Description

@smalruby3-editor-bot

なにをするか

通常モードのブロックは足さずに(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)はこのあと。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions