diff --git a/docs/README.md b/docs/README.md index c4e1c0b2dce..1b483b6b625 100644 --- a/docs/README.md +++ b/docs/README.md @@ -63,7 +63,7 @@ smalruby3-editor の機能ドキュメントは **ユーザーストーリー単 | [`extension-boost/`](extension-boost/) (`defaultHidden: true`) | ⬆️ そのまま | ✅ | | [`extension-wedo2/`](extension-wedo2/) (`defaultHidden: true`) | ⬆️ そのまま | ✅ | | [`extension-mesh-v2/`](extension-mesh-v2/) | 🆕 独自 | ✅ | -| [`extension-smalrubot-s1/`](extension-smalrubot-s1/)(Studuino/旧 スモウルボットS1) | 🆕 独自 | ✅ | +| [`extension-smalrubot-s1/`](extension-smalrubot-s1/)(アーテックロボ・Studuino 基板/旧 スモウルボットS1) | 🆕 独自 | ✅ | | [`extension-koshien/`](extension-koshien/) | 🆕 独自 | ✅ | | [`extension-smalruby-ruby/`](extension-smalruby-ruby/) | 🆕 独自 | ✅ | | [`extension-tm2scratch/`](extension-tm2scratch/) | 🆕 独自 | ✅ | diff --git a/docs/extension-smalrubot-s1/README.md b/docs/extension-smalrubot-s1/README.md index 7fd54a65e12..644a8de4416 100644 --- a/docs/extension-smalrubot-s1/README.md +++ b/docs/extension-smalrubot-s1/README.md @@ -1,30 +1,30 @@ -# 拡張機能: Studuino(スタディーノ)/旧 スモウルボットS1 +# 拡張機能: アーテックロボ(ArtecRobo)/旧 スモウルボットS1 > **🆕 Smalruby 独自** — upstream に存在しない、Smalruby のために新規追加された拡張機能 - **Smalruby ランタイム対応**: ❌(smalruby3 gem は未対応。WebSerial API 経由でハードウェアと通信するためブラウザ専用) - **デフォルト表示**: ✅(拡張機能ライブラリにデフォルトで表示される) -> **いまの状態とこれから**: この拡張機能は、**同じ拡張機能のまま「Studuino(スタディーノ)」の名前に変えた**(前の名前は「スモウルボットS1」)。 +> **いまの状態とこれから**: この拡張機能は、**同じ拡張機能のまま「アーテックロボ(ArtecRobo)」の名前に変えた**(前の名前は「スモウルボットS1」)。 > ブロックの表示は一般的な名前にし、実機が無くても動かせる **練習用の基板**(VM の中のしくみと、ステージの横のパネル)を入れた。 > このページは、いまの挙動と、リニューアルで決まった方針の両方を書く。 > 見分けがつくように、まだ実装していないことには **🚧 これから** と付ける(印の無いことは、いまの挙動)。 ## 概要 -株式会社アーテックの、ロボット製作に特化した Arduino 互換基板 **Studuino®(スタディーノ)** を Smalruby から制御する拡張機能(前の名前は、この基板を使ったロボット「スモウルボットS1」から取った「スモウルボットS1」)。Web Serial API を使ってブラウザから USB 経由で基板と通信し、DC モーター・サーボモーター・LED・センサーを操作する。 +株式会社アーテックのロボットキット **アーテックロボ(ArtecRobo)** の制御基板 **Studuino®(スタディーノ)** を Smalruby から制御する拡張機能(前の名前は、この基板を使ったロボット「スモウルボットS1」から取った「スモウルボットS1」)。Web Serial API を使ってブラウザから USB 経由で基板と通信し、DC モーター・サーボモーター・LED・センサーを操作する。 ファームウェアの書き込みも内蔵(**WebSerial STK500v1 実装**、`smalrubot-firmware-flasher.js`)しており、初回利用時にブラウザから基板へファームウェアを転送できる(macOS は PL2303 Serial Driver が別途必要)。 ### リニューアルのねらい -- 中学校技術・家庭科の「計測・制御」の授業で、**Studuino で授業ができる** と先生に伝わるようにする(スモウルボットは名前が知られていない)。 +- 中学校技術・家庭科の「計測・制御」の授業で、**アーテックロボ(Studuino)で授業ができる** と先生に伝わるようにする(スモウルボットは名前が知られていない)。 - 教科書は「光センサー」「仕事を行う部分」のような一般的な言葉で書かれているので、ブロックの表示も一般的な名前にする(いまは「左のセンサー」のようなロボットの部品の名前)。 - 実機がつながっていないと、センサーの値は 0 のままで、LED・モーター・サーボの命令は何もしない。そのため、2 人で 1 台・自宅・欠席の補習では進められず、レッスンの「できた」の判定もできない。これを **練習用の基板** で解決する。 ## ユーザーストーリー -- **Studuino(スモウルボットS1)を持っている小学生・中学生**として、Smalruby のブロックでロボットを動かしたい +- **アーテックロボ(スモウルボットS1)を持っている小学生・中学生**として、Smalruby のブロックでロボットを動かしたい - **「計測・制御」を教える先生**として、教科書と同じ言葉(光センサー、DC モーターなど)で Studuino を扱わせたい - **基板が足りない教室・自宅で学ぶ生徒**として、実機が無くても練習用の基板でプログラムを動かして確かめたい(センサーの値はパネルのスライダーとボタンで変える) - **教師**として、複数台のロボットを生徒それぞれに渡して、教室全体でロボットプログラミングをさせたい @@ -33,16 +33,28 @@ ## 名前の変更と互換の方針 -**同じ拡張機能のまま、表示の名前だけを「Studuino(スタディーノ)」にした**。前の作品(sb3・Ruby)はそのまま開けて、そのまま動く。 +**同じ拡張機能のまま、表示の名前だけを「アーテックロボ(ArtecRobo)」にした**。前の作品(sb3・Ruby)はそのまま開けて、そのまま動く。 + +### キットと基板の呼び分け + +中学校の教員用テキスト「計測と制御キットB」に合わせて、**キット全体を「アーテックロボ(ArtecRobo)」、制御基板を「Studuino(スタディーノ)」** と呼び分ける。 + +| 呼び名 | 使うところ | +|---|---| +| **アーテックロボ**(英語は ArtecRobo) | 拡張機能の名前(ライブラリのカード・ブロックのカテゴリ・メニューバー・接続モーダルの見出し)、Ruby タブのふりがな、紹介ページの見出し | +| **Studuino**(スタディーノ) | 基板のこと: 接続の手順の文・ファームウェアのモーダル・練習用の基板のパネル・カードの説明文(「アーテックロボの Studuino 基板」) | + +Ruby の書き方は `studuino.` のまま(下の「Ruby の書き方」)。スモウルビーのふりがなは読みではなく意味を書くので、`studuino` の上には「アーテックロボ」と出る。 ### 変えたもの | 対象 | 前 | いま | |---|---|---| -| 拡張機能の名前(ライブラリ・カテゴリ・メニューバー・接続モーダル・ファームウェアのモーダル) | スモウルボットS1 | **Studuino(スタディーノ)**(ひらがなの表示では「Studuino (スタディーノ)」、文の中は「スタディーノ」) | +| 拡張機能の名前(ライブラリ・カテゴリ・メニューバー・接続モーダルの見出し) | スモウルボットS1 | **アーテックロボ(ArtecRobo)**(カテゴリとメニューバーは「アーテックロボ」、英語は「ArtecRobo」) | +| 基板を指す文(接続モーダルの文・ファームウェアのモーダル・練習用の基板のパネル) | スモウルボットS1 | **Studuino**(ひらがなの表示の文の中は「スタディーノ」) | | ライブラリの絵(カード・接続モーダル・カテゴリの絵) | スモウルボットS1 のロボットの写真 | **自分たちで用意した基板の絵**(アーテック社の写真・ロゴは使わない。下の「ライブラリの絵と商標の表記」) | | ライブラリのカードの説明 | スモウルボットS1を制御する。 | アーテック社の表記に合わせた紹介と、登録商標の一文(下の「ライブラリの絵と商標の表記」) | -| Ruby タブのふりがな(`studuino` / `smalrubot_s1` の上に出る名前) | スモウルボットS1 | スタディーノ | +| Ruby タブのふりがな(`studuino` / `smalrubot_s1` の上に出る名前) | スモウルボットS1 | アーテックロボ | | Ruby の書き出し | `smalrubot_s1.` | **`studuino.`**(読みこみは `smalrubot_s1.` も受けつける。下の「Ruby の書き方」) | | ブロック・選択肢の表示 | ロボットの部品の名前(「左のセンサー」など) | 一般的な名前(下の「ブロックと選択肢」)。センサーの選択肢を足し、ロボットのブロックを「ロボットカー」の見出しの下にまとめた | @@ -50,7 +62,9 @@ - **絵**: 人間が Gemini で描いた、青い基板を斜めから見たイラストを **もとにして** 作った。アーテック社の製品の写真やロゴは使っていない。基板の上の文字(「STUDY」「EDU」「Servo」「Sensor」「POWER」「ANALOG IN」「Reset」)は、アーテック社の製品やロゴに見えないように消した。 - カード(600×372)は背景ごと切り出して縮小した。接続モーダルの絵(95×95)とカテゴリ・カードの小さい絵(40×40)は、基板だけを切り抜いて背景を透明にした。カテゴリの絵(VM の `blockIconURI`)は 40×40 と同じ絵。 -- **商標の表記**: アーテック社の表記「ロボット製作に特化した Arduino 互換基板 Studuino®(スタディーノ)」に合わせる。アーテック社の製品だとわかるように、ライブラリのカードの説明に「**Studuino® は株式会社アーテックの登録商標です。**」を入れた(カードには前から「協力: Artec Co., Ltd.」も出る)。紹介ページ(`pages/about.html`)の Studuino の紹介にも同じ一文を入れた。 +- **商標の表記**: カードの説明は「アーテックロボ(ArtecRobo)の Studuino®(スタディーノ)基板を動かす。**アーテックロボは株式会社アーテックの製品で、Studuino® は同社の登録商標です。**」。Studuino® は登録商標なので ® を付ける。アーテックロボ(ArtecRobo)は商標の扱いを確かめていないので、「登録商標」と言い切らず「株式会社アーテックの製品」と書く。カードには「協力: Artec Co., Ltd.」も出る(実際に協力いただき、基板も提供いただいている)。紹介ページ(`pages/about.html`)の紹介にも同じ一文を入れ、写真はこの基板の絵にした。 + + ![紹介ページの計測と制御のカード](screenshots/0701-about-page-1280x800.png) ### 変えないもの @@ -162,7 +176,7 @@ smalrubot_s1.sensor_value("ir_a4") studuino.sensor_value("ir_a4") ``` -- 変換器は、同じ表(メソッドと引数のチェック)を `studuino` と `smalrubot_s1` の 2 つのレシーバーで登録している。Ruby タブのふりがな(「スタディーノ」)と補完も両方のレシーバーで同じ。補完は `studuino.` を入れ、`smalrubot` と打っても見つかる。 +- 変換器は、同じ表(メソッドと引数のチェック)を `studuino` と `smalrubot_s1` の 2 つのレシーバーで登録している。Ruby タブのふりがな(「アーテックロボ」)と補完も両方のレシーバーで同じ。補完は `studuino.` を入れ、`smalrubot` と打っても見つかる。 - `studuino` は、ほかの拡張機能のレシーバー(`mesh` / `koshien` など)やスプライトのメソッドと名前がぶつからない。同じ名前のローカル変数を作ると、Ruby のふつうの決まりどおりそちらが先になる(`smalrubot_s1` のときと同じ)。 - Studuino モード(`docs/studuino-mode/`)も、同じ `studuino.` の書き方を使う前提(ポートの設定の書き方はそちらで決める)。 @@ -224,7 +238,7 @@ GUI は、イベントを聞いて表示し、センサーの値はこのメソ ### パネル -Studuino の拡張機能を読みこむと、**コードエリアの右上(ステージの列のすぐ左)** に練習用の基板のパネルが出る。たためる。 +アーテックロボの拡張機能を読みこむと、**コードエリアの右上(ステージの列のすぐ左)** に練習用の基板のパネルが出る。たためる。 実装は `packages/scratch-gui/src/containers/studuino-practice-board.jsx`(状態を読む・センサーの値を変える)と `packages/scratch-gui/src/components/studuino-practice-board/`(表示)。 @@ -321,11 +335,11 @@ Studuino の拡張機能を読みこむと、**コードエリアの右上(ス ## UI / 操作フロー -![拡張機能ライブラリの Studuino のカード](screenshots/0401-library-card-1280x800.png) +![拡張機能ライブラリのアーテックロボのカード](screenshots/0401-library-card-1280x800.png) ### 接続 -1. ブロックパレットの「拡張機能を追加」から **Studuino(スタディーノ)** を選ぶ +1. ブロックパレットの「拡張機能を追加」から **アーテックロボ(ArtecRobo)** を選ぶ 2. 接続モーダルが専用フローで開く(`smalrubot-s1-*-step.jsx` 系)。**生徒用 (接続) / 先生用 (ファームウェア書き込み)** のいずれかを選択 ![Studuino 初期ステップ](screenshots/0101-initial-step-1280x800.png) @@ -336,7 +350,7 @@ Studuino の拡張機能を読みこむと、**コードエリアの右上(ス ### ファームウェアフラッシュ -1. 接続モーダルの「ファームウェアを書き込む(先生用)」 もしくはメニューバーの「Studuino」メニューから起動 +1. 接続モーダルの「ファームウェアを書き込む(先生用)」 もしくはメニューバーの「アーテックロボ」メニューから起動 2. ファームウェアフラッシュモーダル (`smalrubot-firmware-modal`) が開く。**macOS では PL2303 Serial Driver アプリのインストール案内** が先に表示される ![ファームウェアモーダル (macOS)](screenshots/0201-firmware-modal-macos-1280x800.png) @@ -346,9 +360,13 @@ Studuino の拡張機能を読みこむと、**コードエリアの右上(ス ### ブロックパレット -接続後はブロックパレットの **Studuino** カテゴリに専用ブロックが表示される(ブロックの一覧は上の「ブロックと選択肢」): +接続後はブロックパレットの **アーテックロボ** カテゴリに専用ブロックが表示される(ブロックの一覧は上の「ブロックと選択肢」): + +![アーテックロボのブロックパレット](screenshots/0301-block-palette-1280x800.png) + +Ruby タブのふりがなでは、`studuino` の上に「アーテックロボ」と出る: -![Studuino ブロックパレット](screenshots/0301-block-palette-1280x800.png) +![Ruby タブのふりがな](screenshots/0601-furigana-1280x800.png) ## 主要ファイル diff --git a/docs/extension-smalrubot-s1/screenshots/0101-initial-step-1280x800.png b/docs/extension-smalrubot-s1/screenshots/0101-initial-step-1280x800.png index f21e5bddfea..17636b76ec8 100644 Binary files a/docs/extension-smalrubot-s1/screenshots/0101-initial-step-1280x800.png and b/docs/extension-smalrubot-s1/screenshots/0101-initial-step-1280x800.png differ diff --git a/docs/extension-smalrubot-s1/screenshots/0301-block-palette-1280x800.png b/docs/extension-smalrubot-s1/screenshots/0301-block-palette-1280x800.png index 424398f06db..74416c341e6 100644 Binary files a/docs/extension-smalrubot-s1/screenshots/0301-block-palette-1280x800.png and b/docs/extension-smalrubot-s1/screenshots/0301-block-palette-1280x800.png differ diff --git a/docs/extension-smalrubot-s1/screenshots/0401-library-card-1280x800.png b/docs/extension-smalrubot-s1/screenshots/0401-library-card-1280x800.png index d788efaa0ee..ad5169bbdcb 100644 Binary files a/docs/extension-smalrubot-s1/screenshots/0401-library-card-1280x800.png and b/docs/extension-smalrubot-s1/screenshots/0401-library-card-1280x800.png differ diff --git a/docs/extension-smalrubot-s1/screenshots/0601-furigana-1280x800.png b/docs/extension-smalrubot-s1/screenshots/0601-furigana-1280x800.png new file mode 100644 index 00000000000..35ac56cb4c6 Binary files /dev/null and b/docs/extension-smalrubot-s1/screenshots/0601-furigana-1280x800.png differ diff --git a/docs/extension-smalrubot-s1/screenshots/0701-about-page-1280x800.png b/docs/extension-smalrubot-s1/screenshots/0701-about-page-1280x800.png new file mode 100644 index 00000000000..4f3d8cfdd8f Binary files /dev/null and b/docs/extension-smalrubot-s1/screenshots/0701-about-page-1280x800.png differ diff --git a/docs/furigana/furigana-mapping.md b/docs/furigana/furigana-mapping.md index 2edf7c52f17..2784d6a0f53 100644 --- a/docs/furigana/furigana-mapping.md +++ b/docs/furigana/furigana-mapping.md @@ -604,26 +604,26 @@ TryRuby 対応で追加された Ruby メソッドのふりがな。 | `mesh_v1`(レシーバー) | `メッシュ(従来)` | — | | `mesh_v1.sensor_value("x")` | `メッシュ(従来)` `センサーの値` | 「xセンサーの値」 | -### Studuino(スタディーノ)拡張機能(旧 スモウルボットS1) +### アーテックロボ(ArtecRobo)拡張機能(旧 スモウルボットS1) -`studuino` は事前定義レシーバー。レシーバー自体に `スタディーノ` のふりがなが付く。ブロックからは `studuino.` を書き出す。前の書き方の `smalrubot_s1` も同じふりがな(レシーバー・メソッド・選択肢)が付く。 +`studuino` は事前定義レシーバー。レシーバー自体に `アーテックロボ` のふりがなが付く(読みの「スタディーノ」ではなく、意味としてキットの名前を書く)。ブロックからは `studuino.` を書き出す。前の書き方の `smalrubot_s1` も同じふりがな(レシーバー・メソッド・選択肢)が付く。 | Ruby | ふりがな | Scratchブロック | | ------ | --------- | ------ | -| `studuino` / `smalrubot_s1`(レシーバー) | `スタディーノ` | — | -| `studuino.action("forward")` | `スタディーノ` `動作する` `車を前進させる` | 「車を前進させる」 | -| `studuino.action("backward")` | `スタディーノ` `動作する` `車を後退させる` | 「車を後退させる」 | -| `studuino.action("left")` | `スタディーノ` `動作する` `車を左に曲げる` | 「車を左に曲げる」 | -| `studuino.action("right")` | `スタディーノ` `動作する` `車を右に曲げる` | 「車を右に曲げる」 | -| `studuino.action("stop")` | `スタディーノ` `動作する` `車を止める` | 「車を止める」 | -| `studuino.bend_arm(90, 1)` | `スタディーノ` `アームを曲げる` | 「アーム(サーボモーター D10)を曲げる」 | -| `studuino.sensor_value("light")` | `スタディーノ` `センサーの値` `光センサー (A6)` | 「光センサー (A6) の値」 | -| `studuino.sensor_value("ir_a4")` | `スタディーノ` `センサーの値` `赤外線センサー(フォトリフレクタ)(A4)` | 「赤外線センサー(フォトリフレクタ)(A4) の値」 | -| `studuino.sensor_value("left")` | `スタディーノ` `センサーの値` `左のセンサー (A4)` | 「左のセンサー (A4) の値」 | -| `studuino.get_motor_speed("left")` | `スタディーノ` `モーター速度` `左` | 「左の DC モーターの速度」 | -| `studuino.set_motor_speed("left", 50)` | `スタディーノ` `モーター速度を設定` `左` | 「左の DC モーターの速度を 50 にする」 | -| `studuino.led("left", true)` | `スタディーノ` `LED設定` `左` | 「左の LED をオンにする」 | -| `studuino.arm_calibration = 0` | `スタディーノ` `アーム調整` | 「アームを 0 度調整する」 | +| `studuino` / `smalrubot_s1`(レシーバー) | `アーテックロボ` | — | +| `studuino.action("forward")` | `アーテックロボ` `動作する` `車を前進させる` | 「車を前進させる」 | +| `studuino.action("backward")` | `アーテックロボ` `動作する` `車を後退させる` | 「車を後退させる」 | +| `studuino.action("left")` | `アーテックロボ` `動作する` `車を左に曲げる` | 「車を左に曲げる」 | +| `studuino.action("right")` | `アーテックロボ` `動作する` `車を右に曲げる` | 「車を右に曲げる」 | +| `studuino.action("stop")` | `アーテックロボ` `動作する` `車を止める` | 「車を止める」 | +| `studuino.bend_arm(90, 1)` | `アーテックロボ` `アームを曲げる` | 「アーム(サーボモーター D10)を曲げる」 | +| `studuino.sensor_value("light")` | `アーテックロボ` `センサーの値` `光センサー (A6)` | 「光センサー (A6) の値」 | +| `studuino.sensor_value("ir_a4")` | `アーテックロボ` `センサーの値` `赤外線センサー(フォトリフレクタ)(A4)` | 「赤外線センサー(フォトリフレクタ)(A4) の値」 | +| `studuino.sensor_value("left")` | `アーテックロボ` `センサーの値` `左のセンサー (A4)` | 「左のセンサー (A4) の値」 | +| `studuino.get_motor_speed("left")` | `アーテックロボ` `モーター速度` `左` | 「左の DC モーターの速度」 | +| `studuino.set_motor_speed("left", 50)` | `アーテックロボ` `モーター速度を設定` `左` | 「左の DC モーターの速度を 50 にする」 | +| `studuino.led("left", true)` | `アーテックロボ` `LED設定` `左` | 「左の LED をオンにする」 | +| `studuino.arm_calibration = 0` | `アーテックロボ` `アーム調整` | 「アームを 0 度調整する」 | センサーの選択肢は、ほかに `ir_a5`(赤外線センサー(フォトリフレクタ)(A5))・`touch`(タッチセンサー (A2))・`sound`(音センサー (A7))・`right`(右のセンサー (A5))。 diff --git a/docs/lessons/README.md b/docs/lessons/README.md index 2697dd356c5..86adbe208c9 100644 --- a/docs/lessons/README.md +++ b/docs/lessons/README.md @@ -697,8 +697,8 @@ design.md の「中 2 のコース」。コースの ✓ もこれで数える | `currentCostume` | いまのコスチューム(`target: 'stage'` なら背景)。`number` = 何番め(1 から)、`changed: true` = 開いたときと別のコスチュームになった。始めにいたものだけ見る | `number`, `changed`, `target`(どちらか 1 つは要る) | | `tab` | いま開いているタブ(エディタの画面の状態。`code` / `costumes` / `sounds`) | `tab` | | `partQuiz` | 「どこでしょう?」のクイズに `count` 問正しく答えた(エディタの画面の状態) | `count` | -| `boardCommand` | Studuino の拡張機能が基板に出した命令(実機でも練習用の基板でも同じ記録) | `kind`(必須。`led` / `motor` / `servo` / `servoCalibration`。配列も可), `port`, `value`, `speed`, `whenSensor` | -| `sensorRead` | Studuino の拡張機能がセンサーの値を読んだ | `port`, `sensor`, `value` | +| `boardCommand` | アーテックロボ(Studuino)の拡張機能が基板に出した命令(実機でも練習用の基板でも同じ記録) | `kind`(必須。`led` / `motor` / `servo` / `servoCalibration`。配列も可), `port`, `value`, `speed`, `whenSensor` | +| `sensorRead` | アーテックロボ(Studuino)の拡張機能がセンサーの値を読んだ | `port`, `sensor`, `value` | `tab` と `partQuiz` は VM ではなく**エディタの画面の状態**を見る。見張り(`attachGoalMonitor`)に `getUi`(`{activeTab, partQuizSolved}` を 返す関数)を渡し、`containers/lesson-goal-watcher.jsx` がタブ・クイズの答えが変わったら `refresh()` で判定を予約する。 diff --git a/docs/smalruby-language-spec-extensions.ja.md b/docs/smalruby-language-spec-extensions.ja.md index 69856e8304e..7ef39063c12 100644 --- a/docs/smalruby-language-spec-extensions.ja.md +++ b/docs/smalruby-language-spec-extensions.ja.md @@ -18,7 +18,7 @@ 5. [音声合成(Text to Speech)](#5-音声合成text-to-speech) 6. [翻訳(Translate)](#6-翻訳translate) 7. [メッシュ V2(Mesh V2)](#7-メッシュ-v2mesh-v2) -8. [Studuino(スタディーノ)(旧 スモウルボット S1)](#8-studuinoスタディーノ旧-スモウルボット-s1) +8. [アーテックロボ(ArtecRobo)(旧 スモウルボット S1)](#8-アーテックロボartecrobo旧-スモウルボット-s1) 9. [マイクロビット モア(Microbit More)](#9-マイクロビット-モアmicrobit-more) 10. [甲子園(Koshien)](#10-甲子園koshien) 11. [Ruby 文字列(Ruby String)](#11-ruby-文字列ruby-string) @@ -155,9 +155,9 @@ --- -## 8. Studuino(スタディーノ)(旧 スモウルボット S1) +## 8. アーテックロボ(ArtecRobo)(旧 スモウルボット S1) -アーテック社の Studuino(スタディーノ)の基板と、つないだ部品(センサー・LED・モーター・サーボ)を制御します。 +アーテック社のロボットキット「アーテックロボ(ArtecRobo)」の制御基板 Studuino(スタディーノ)と、つないだ部品(センサー・LED・モーター・サーボ)を制御します。 書き出しは `studuino.`。前の書き方の `smalrubot_s1.`(例: `smalrubot_s1.action("forward")`)も読みこめて、メソッド名と引数は同じです。 diff --git a/docs/smalruby-language-spec-extensions.md b/docs/smalruby-language-spec-extensions.md index 2b087fb6be3..3f3013a8d3a 100644 --- a/docs/smalruby-language-spec-extensions.md +++ b/docs/smalruby-language-spec-extensions.md @@ -18,7 +18,7 @@ Only extensions visible in the extension library are listed (those with `default 5. [Text to Speech](#5-text-to-speech) 6. [Translate](#6-translate) 7. [Mesh V2](#7-mesh-v2) -8. [Studuino (formerly Smalrubot S1)](#8-studuino-formerly-smalrubot-s1) +8. [ArtecRobo (formerly Smalrubot S1)](#8-artecrobo-formerly-smalrubot-s1) 9. [Microbit More](#9-microbit-more) 10. [Koshien](#10-koshien) 11. [Ruby String](#11-ruby-string) @@ -155,9 +155,9 @@ Allow users to interact over a computer network. (Requires internet connection) --- -## 8. Studuino (formerly Smalrubot S1) +## 8. ArtecRobo (formerly Smalrubot S1) -Control the Artec Studuino board and the parts connected to it (sensors, LEDs, motors, servo). +Control the Studuino board of Artec's ArtecRobo robot kit and the parts connected to it (sensors, LEDs, motors, servo). The blocks write `studuino.`. The older receiver `smalrubot_s1.` (e.g. `smalrubot_s1.action("forward")`) is still read; the method names and arguments are the same. diff --git a/packages/scratch-gui/pages/about.html b/packages/scratch-gui/pages/about.html index 3dc2b92f1eb..fe4196844a5 100644 --- a/packages/scratch-gui/pages/about.html +++ b/packages/scratch-gui/pages/about.html @@ -5,7 +5,7 @@ スモウルビー | 中学校プログラミング教育の新標準 — ブロック・Ruby・DNCL対応 - + @@ -1012,14 +1012,14 @@

- Studuinoロボット + Studuino 基板のイラスト

計測と制御のプログラミング

-

株式会社アーテックの、ロボット製作に特化した Arduino 互換基板「Studuino®(スタディーノ)」に対応。ChromebookとUSBケーブルだけで、センサーやモーターを制御するIoTプログラミングを実現します。
Studuino® は株式会社アーテックの登録商標です。

+

株式会社アーテックのロボットキット「アーテックロボ(ArtecRobo)」と、その制御基板「Studuino®(スタディーノ)」に対応。ChromebookとUSBケーブルだけで、センサーやモーターを制御するIoTプログラミングを実現します。実機が無くても、画面の中の練習用の基板で試せます。
アーテックロボは株式会社アーテックの製品で、Studuino® は同社の登録商標です。

@@ -1080,7 +1080,7 @@

ブ
中
中学校 -

メッシュ・Studuinoで課題解決

+

メッシュ・アーテックロボで課題解決

双方向コンテンツや計測・制御で「社会課題の解決」を体験。ブロックとRubyを行き来しながら、テキストプログラミングへの橋渡しもスタート。

diff --git a/packages/scratch-gui/pages/assets/smalrubot-s1.png b/packages/scratch-gui/pages/assets/smalrubot-s1.png deleted file mode 100644 index 3f7bb6e6430..00000000000 Binary files a/packages/scratch-gui/pages/assets/smalrubot-s1.png and /dev/null differ diff --git a/packages/scratch-gui/pages/assets/studuino-board.png b/packages/scratch-gui/pages/assets/studuino-board.png new file mode 100644 index 00000000000..4de26e1ae3c Binary files /dev/null and b/packages/scratch-gui/pages/assets/studuino-board.png differ diff --git a/packages/scratch-gui/src/components/menu-bar/menu-bar.jsx b/packages/scratch-gui/src/components/menu-bar/menu-bar.jsx index f47d306a33c..681c835b46b 100644 --- a/packages/scratch-gui/src/components/menu-bar/menu-bar.jsx +++ b/packages/scratch-gui/src/components/menu-bar/menu-bar.jsx @@ -1392,7 +1392,7 @@ class MenuBar extends React.Component { > diff --git a/packages/scratch-gui/src/lib/furigana-extension-handlers.js b/packages/scratch-gui/src/lib/furigana-extension-handlers.js index 745d55c5c92..fb0b09cbe57 100644 --- a/packages/scratch-gui/src/lib/furigana-extension-handlers.js +++ b/packages/scratch-gui/src/lib/furigana-extension-handlers.js @@ -43,8 +43,8 @@ const EXTENSION_RECEIVER_LABELS = { microbit: 'マイクロビット', mesh_v1: 'メッシュ(従来)', mesh: 'メッシュ', - studuino: 'スタディーノ', - smalrubot_s1: 'スタディーノ', + studuino: 'アーテックロボ', + smalrubot_s1: 'アーテックロボ', koshien: 'スモウルビー甲子園', tm: '機械学習', akadako: 'AkaDako', diff --git a/packages/scratch-gui/src/lib/libraries/extensions/index.jsx b/packages/scratch-gui/src/lib/libraries/extensions/index.jsx index ab293626771..fc17edeeb54 100644 --- a/packages/scratch-gui/src/lib/libraries/extensions/index.jsx +++ b/packages/scratch-gui/src/lib/libraries/extensions/index.jsx @@ -483,7 +483,7 @@ export default [ { name: ( @@ -493,7 +493,7 @@ export default [ insetIconURL: smalrubotS1InsetIconURL, description: ( diff --git a/packages/scratch-gui/src/locales/en.js b/packages/scratch-gui/src/locales/en.js index 230365ffe6d..ed947a12f04 100644 --- a/packages/scratch-gui/src/locales/en.js +++ b/packages/scratch-gui/src/locales/en.js @@ -27,7 +27,7 @@ export default { 'gui.smalruby3.previewInfo.welcome': 'Welcome to the Smalruby 3.0 Preview', 'gui.smalruby3.menuBar.downloadRubyCodeToComputer': 'Save Ruby to your computer', 'gui.menuBar.meshV2': 'Mesh', - 'gui.menuBar.smalrubotS1': 'Studuino', + 'gui.menuBar.smalrubotS1': 'ArtecRobo', 'gui.menuBar.smalrubotS1.flashFirmware': 'Write Firmware', 'gui.smalrubotFirmware.title': 'Studuino Firmware', 'gui.smalrubotFirmware.description': @@ -1005,11 +1005,11 @@ export default { 'If the host is not displayed, please set the domain. The zip code of a facility such as a school is ideal.', 'mesh.domainExampleTitle': 'Example', 'mesh.domainExample': '100-0014', - 'gui.smalruby3.extension.smalrubotS1.name': 'Studuino', + 'gui.smalruby3.extension.smalrubotS1.name': 'ArtecRobo', 'gui.smalruby3.extension.smalrubotS1.description': - 'Control Studuino®, an Arduino-compatible board designed for building robots. Studuino® is a registered trademark of Artec Co., Ltd.', + 'Control the Studuino® board of ArtecRobo. ArtecRobo is a product of Artec Co., Ltd., and Studuino® is a registered trademark of Artec Co., Ltd.', 'gui.smalruby3.extension.smalrubotS1.connectingMessage': 'Connecting the Studuino', - 'smalrubotS1.categoryName': 'Studuino', + 'smalrubotS1.categoryName': 'ArtecRobo', 'smalrubotS1.action': '[ACTION] (M1, M2)', 'smalrubotS1.actionAndStopAfter': '[ACTION] for [SECS] seconds (M1, M2)', 'smalrubotS1.bendArm': 'bend arm (servo motor D10) [DEGREE] degrees in [SECS] seconds', diff --git a/packages/scratch-gui/src/locales/ja-Hira.js b/packages/scratch-gui/src/locales/ja-Hira.js index f1c454ab2ff..e2e6e70f8c6 100644 --- a/packages/scratch-gui/src/locales/ja-Hira.js +++ b/packages/scratch-gui/src/locales/ja-Hira.js @@ -18,7 +18,7 @@ export default { 'gui.rubyVersion.v1': 'バージョン1', 'gui.rubyVersion.v2': 'バージョン2 (しょきせってい)', 'gui.menuBar.meshV2': 'メッシュ', - 'gui.menuBar.smalrubotS1': 'Studuino (スタディーノ)', + 'gui.menuBar.smalrubotS1': 'アーテックロボ', 'gui.menuBar.smalrubotS1.flashFirmware': 'ファームウェアかきこみ', 'gui.smalrubotFirmware.title': 'Studuino (スタディーノ) ファームウェア', 'gui.smalrubotFirmware.description': @@ -1416,11 +1416,11 @@ export default { 'faceSensing.topOfHead': 'あたまのてっぺん', 'faceSensing.left': 'ひだり', 'faceSensing.right': 'みぎ', - 'gui.smalruby3.extension.smalrubotS1.name': 'Studuino (スタディーノ)', + 'gui.smalruby3.extension.smalrubotS1.name': 'アーテックロボ (ArtecRobo)', 'gui.smalruby3.extension.smalrubotS1.description': - 'ロボットせいさくにとくかした Arduino (アルドゥイーノ) ごかんきばん Studuino® (スタディーノ) をうごかす。Studuino® はかぶしきがいしゃアーテックのとうろくしょうひょうです。', + 'アーテックロボ (ArtecRobo) の Studuino® (スタディーノ) きばんをうごかす。アーテックロボはかぶしきがいしゃアーテックのせいひんで、Studuino® はどうしゃのとうろくしょうひょうです。', 'gui.smalruby3.extension.smalrubotS1.connectingMessage': 'スタディーノにせつぞくしています。', - 'smalrubotS1.categoryName': 'Studuino (スタディーノ)', + 'smalrubotS1.categoryName': 'アーテックロボ', 'smalrubotS1.action': '[ACTION] (M1, M2)', 'smalrubotS1.actionAndStopAfter': '[SECS] びょう [ACTION] (M1, M2)', 'smalrubotS1.bendArm': '[SECS] びょうでアーム(サーボモーター D10)を [DEGREE] どにまげる', diff --git a/packages/scratch-gui/src/locales/ja.js b/packages/scratch-gui/src/locales/ja.js index 659de169a53..f8eb6cea507 100644 --- a/packages/scratch-gui/src/locales/ja.js +++ b/packages/scratch-gui/src/locales/ja.js @@ -18,7 +18,7 @@ export default { 'gui.rubyVersion.v1': 'バージョン1', 'gui.rubyVersion.v2': 'バージョン2 (初期設定)', 'gui.menuBar.meshV2': 'メッシュ', - 'gui.menuBar.smalrubotS1': 'Studuino', + 'gui.menuBar.smalrubotS1': 'アーテックロボ', 'gui.menuBar.smalrubotS1.flashFirmware': 'ファームウェア書き込み', 'gui.smalrubotFirmware.title': 'Studuino ファームウェア', 'gui.smalrubotFirmware.description': @@ -1379,11 +1379,11 @@ export default { 'faceSensing.topOfHead': '頭のてっぺん', 'faceSensing.left': '左', 'faceSensing.right': '右', - 'gui.smalruby3.extension.smalrubotS1.name': 'Studuino(スタディーノ)', + 'gui.smalruby3.extension.smalrubotS1.name': 'アーテックロボ(ArtecRobo)', 'gui.smalruby3.extension.smalrubotS1.description': - 'ロボット製作に特化した Arduino 互換基板 Studuino®(スタディーノ)を動かす。Studuino® は株式会社アーテックの登録商標です。', + 'アーテックロボ(ArtecRobo)の Studuino®(スタディーノ)基板を動かす。アーテックロボは株式会社アーテックの製品で、Studuino® は同社の登録商標です。', 'gui.smalruby3.extension.smalrubotS1.connectingMessage': 'Studuino に接続しています。', - 'smalrubotS1.categoryName': 'Studuino', + 'smalrubotS1.categoryName': 'アーテックロボ', 'smalrubotS1.action': '[ACTION] (M1, M2)', 'smalrubotS1.actionAndStopAfter': '[SECS] 秒 [ACTION] (M1, M2)', 'smalrubotS1.bendArm': '[SECS] 秒でアーム(サーボモーター D10)を [DEGREE] 度に曲げる', diff --git a/packages/scratch-gui/test/integration/smalrubot-s1-connection-flow.test.js b/packages/scratch-gui/test/integration/smalrubot-s1-connection-flow.test.js index 6a798f90980..cebc5dab20e 100644 --- a/packages/scratch-gui/test/integration/smalrubot-s1-connection-flow.test.js +++ b/packages/scratch-gui/test/integration/smalrubot-s1-connection-flow.test.js @@ -19,7 +19,7 @@ const activateSmalrubotS1Extension = async () => { // Open extension chooser await clickXpath('//button[@title="Add Extension"]'); // Click the smalrubotS1 extension by name - await clickText('Studuino'); + await clickText('ArtecRobo'); // Wait briefly for the connection modal to mount await new Promise((resolve) => setTimeout(resolve, 1000)); }; diff --git a/packages/scratch-gui/test/unit/containers/connection-modal-smalrubot-s1.test.jsx b/packages/scratch-gui/test/unit/containers/connection-modal-smalrubot-s1.test.jsx index ffc778a82ae..adcd1e1aebf 100644 --- a/packages/scratch-gui/test/unit/containers/connection-modal-smalrubot-s1.test.jsx +++ b/packages/scratch-gui/test/unit/containers/connection-modal-smalrubot-s1.test.jsx @@ -46,7 +46,7 @@ jest.mock('../../../src/lib/analytics', () => ({ event: jest.fn() })); jest.mock('../../../src/lib/libraries/extensions/index.jsx', () => [ { extensionId: 'smalrubotS1', - name: 'Studuino', + name: 'ArtecRobo', connectionIconURL: 'icon.png', connectionSmallIconURL: 'small-icon.png', connectingMessage: 'Connecting...', diff --git a/packages/scratch-gui/test/unit/lib/furigana-annotator.test.js b/packages/scratch-gui/test/unit/lib/furigana-annotator.test.js index aea166b2a70..dce3f9f641f 100644 --- a/packages/scratch-gui/test/unit/lib/furigana-annotator.test.js +++ b/packages/scratch-gui/test/unit/lib/furigana-annotator.test.js @@ -1308,8 +1308,8 @@ describe('FuriganaAnnotator', () => { // `studuino.` is written by the blocks; `smalrubot_s1.` is still read (#2190). describe.each(['studuino', 'smalrubot_s1'])('%s extension (predefined receiver)', (receiver) => { - test('receiver → スタディーノ', () => { - expect(labelsAt(annotate(`${receiver}.action("forward")`), 1)).toContain('スタディーノ'); + test('receiver → アーテックロボ', () => { + expect(labelsAt(annotate(`${receiver}.action("forward")`), 1)).toContain('アーテックロボ'); }); test('.action("forward") → 動作する + 車を前進させる', () => { const labels = labelsAt(annotate(`${receiver}.action("forward")`), 1); diff --git a/packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/index.js b/packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/index.js index ce74c21c4ef..70fd3b925e0 100644 --- a/packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/index.js +++ b/packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/index.js @@ -943,7 +943,7 @@ class Scratch3SmalrubotS1Blocks { * @returns {string} - the name of this extension. */ static get EXTENSION_NAME() { - return 'Studuino'; + return 'ArtecRobo'; } /** @@ -1262,7 +1262,12 @@ class Scratch3SmalrubotS1Blocks { getInfo() { return { id: Scratch3SmalrubotS1Blocks.EXTENSION_ID, - name: Scratch3SmalrubotS1Blocks.EXTENSION_NAME, + // The kit is ArtecRobo and its board is Studuino (the teacher's text of the kit uses these names). + name: formatMessage({ + id: 'smalrubotS1.categoryName', + default: Scratch3SmalrubotS1Blocks.EXTENSION_NAME, + description: 'Label for the ArtecRobo extension category', + }), blockIconURI: blockIconURI, showStatusButton: true, blocks: [ diff --git a/packages/scratch-vm/test/unit/extension_smalrubot_s1.js b/packages/scratch-vm/test/unit/extension_smalrubot_s1.js index e7c2d08fd0c..46195c32e12 100644 --- a/packages/scratch-vm/test/unit/extension_smalrubot_s1.js +++ b/packages/scratch-vm/test/unit/extension_smalrubot_s1.js @@ -89,7 +89,7 @@ test('Smalrubot S1 Blocks', (t) => { const blocks = new SmalrubotS1Blocks(mockRuntime); const info = blocks.getInfo(); st.equal(info.id, 'smalrubotS1'); - st.equal(info.name, 'Studuino'); + st.equal(info.name, 'ArtecRobo'); st.ok(info.blocks.length > 0); st.equal(info.showStatusButton, true); st.end();