extension-text2speech

拡張機能: 音声合成 (Text to Speech)

🔧 upstream 改良 — upstream にあるが Smalruby で機能を改良・拡張している 改良点: 音声合成リクエストを Smalruby の汎用 CORS 回避プロキシ (api.smalruby.app/cors-proxy) 経由に切り替え。Scratch の音声合成サービスは CORS を scratch.mit.edu 限定にしたため、smalruby.app からの直叩きが CORS で失敗する。

• Smalruby ランタイム対応: ❌（smalruby3 gem 未対応。AWS Polly API + ブラウザ音声再生）
• デフォルト表示: ✅（拡張機能ライブラリにデフォルトで表示される）
• collaborator: Amazon Web Services

概要

入力したテキストを音声で読み上げる拡張機能。AWS Polly を使った音声合成（複数の声・言語対応）。upstream Scratch 標準。

Smalruby 独自: 汎用 CORS 回避プロキシ経由

Scratch の音声合成サービス (synthesis-service.scratch.mit.edu) は Access-Control-Allow-Origin を scratch.mit.edu 限定に締めたため、smalruby.app から直接叩くと CORS でブロックされる。 そこで VM 実装 scratch3_text2speech/index.js では、合成 URL (${SERVER_HOST}/synth?...) を Smalruby の汎用 CORS プロキシで包む（=== Smalruby: Start/End of synthesis CORS proxy === マーカーで囲む）:

https://api.smalruby.app/cors-proxy?url=<encodeURIComponent(合成URL)>

SERVER_HOST は upstream の値 (https://synthesis-service.scratch.mit.edu) のまま維持し、URL 組み立て 箇所だけをラップするので upstream との差分が最小になる（upstream マージ時の silent revert 検知は test/unit/extension_text2speech_proxy.js が担保）。

汎用 cors-proxy はサーバ側で対象 URL を fetch し、audio/* をバイナリと判定して mp3 を Base64 で返却 （isBase64Encoded: true。API Gateway HTTP API v2 がクライアントへバイト列にデコード）、built-in CORS で レスポンスを返す（infra/smalruby-api の GET /cors-proxy）。translate (#857) と同じ根本原因だが、 translate は専用 Lambda、音声合成は既存の汎用プロキシを再利用する点が異なり、専用 Lambda の追加も インフラの再デプロイも不要（#859）。

ユーザーストーリー

• 小学生として、自分の作ったキャラクターに「しゃべらせたい」
• 物語作品を作る子として、ナレーションを音声で入れたい
• 多言語学習中の子として、英語など他言語の発音を聞きたい

主要ファイル

• 拡張機能登録: packages/scratch-gui/src/lib/libraries/extensions/index.jsx の extensionId: 'text2speech'
• VM 実装: packages/scratch-vm/src/extensions/scratch3_text2speech/

ブロックパレット

関連ブロック（主要 opcode）

opcode	説明
text2speech_speakAndWait	テキストを話して終わるまで待つ
text2speech_setVoice	声を選ぶ（Alto, Tenor, Squeak, Giant, Kitten など）
text2speech_setLanguage	言語を選ぶ

関連ドキュメント

• 上流: scratch-vm のドキュメント
• AWS Polly