hayakit

Ruffle埋め込みコード生成

SWFのファイル名とサイズを入れると、レスポンシブ対応のHTMLやWordPress埋め込みタグを生成します。

1出力形式と読み込み元

出力形式
Ruffleの読み込み元

2配置するSWF作品(最大10件)

作品 1

HTMLと同じフォルダならファイル名だけ、別フォルダならパスを入力します。

px
px
ID・音量を指定
%

3再生・表示オプション

自動再生 (autoplay)
音声解除オーバーレイ
全画面時の余白 (letterbox)

CSSの色名(black等)は不可。6桁の#付きコードで指定します。

詳細設定(拡大方式・画質・日本語フォントなど)

公開までの手順

    生成仕様・オプションの内訳

    ブラウザ内で処理・送信なし最終更新:

    WordPress カスタムHTMLへの埋め込み手順

    WordPressでSWFファイルを再生したい場合、専用のWordPressプラグインをインストールする必要はありません(WordPress swf Ruffle 埋め込み やり方として最も手堅いのは、ブロックエディターの「カスタムHTML」ブロックを使う方法です)。生成したコードをそのまま貼り付けるだけで動作します。

    1. FTPやサーバーのファイルマネージャーで、対象の .swf ファイルをサーバー上の任意のフォルダ(例:/flash/game.swf)へアップロードします。
    2. 上のフォームにSWFのパスと元の縦横サイズ(例:550×400)を入力し、「コードをコピー」を押します。
    3. WordPress投稿画面で「+」から「カスタムHTML」ブロックを追加し、コピーしたコードを貼り付けてプレビューを確認します。

    記事内に手書きでスクリプトを貼るときに起きやすいのが、WordPressの自動整形機能(wpautop)がタグや<script>内の空行を<p>や<br>に変換してJavaScript構文エラーを起こす問題です。このツールはWordPress・埋め込み用モードで空行(連続改行)を一切出力しないため、そのまま貼り付けても壊れません。

    また、スマホ閲覧時に横幅がはみ出さないよう、コンテナにはwidth:100%;max-width:幅px;aspect-ratio:比率;を自動で付与しています。元のピクセル数を保ちながら画面幅に合わせて等比例縮小されるため、テーマ側のCSSを追加しなくてもレイアウトが崩れにくくなります。設定項目の仕様はRuffle公式ドキュメント「BaseLoadOptions」に準拠しています。

    CDNとセルフホストの選び方・必要ファイルと.htaccess

    個人サイトへの導入(Ruffle Flash 個人サイト 導入 html)では、Ruffle本体の読み込み元を「CDN」と「セルフホスト」のどちらかから選びます。迷う場合は更新の手間がないCDN(unpkg または jsDelivr)から試し、後から自前サーバーへ切り替えることも可能です。

    • CDN(unpkg / jsDelivr):https://unpkg.com/@ruffle-rs/ruffle や https://cdn.jsdelivr.net/npm/@ruffle-rs/ruffle の1行を読み込むだけで最新のRuffleを利用できます。サーバー容量を圧迫せず、ファイルのアップロードも不要です。
    • セルフホスト(自前サーバーに配置):Ruffle公式 GitHub Releases から web-selfhosted.zip をダウンロードして自分のサーバーに置きます。CDNの障害や仕様変更の影響を受けず、公開時のバージョンを固定したい保存目的のサイトに向いています。

    セルフホスト時に注意したいのが、古い解説記事(2022年ごろ)で紹介されていた core.ruffle.*.js のファイル構成が現在の配布物とは異なる点です。現在の web-selfhosted.zip では、ruffle.js と ruffle_web_bg.<HASH>.wasm、ruffle_web-wasm_mvp_bg.<HASH>.wasm などをまとめて同じフォルダ(例:./ruffle/)へバイナリモードでアップロードし、window.RufflePlayer.config.publicPath にそのフォルダを指定します。詳細はRuffle公式「Using Ruffle」にも記載されています。

    さらに、レンタルサーバーによっては .wasm ファイルが正しいMIMEタイプ(application/wasm)で配信されず起動に失敗することがあります。その場合はサーバー上の .htaccess に AddType application/wasm .wasm を追記してください。また、単体 index.html をパソコン上でダブルクリック(file://)して開くとブラウザのCORS制限によりWASMとSWFの読み込みがブロックされるため、必ずテスト用または本番のHTTP(S)サーバー経由で動作確認を行います。

    同じページに複数のFlash(SWF)を並べる方法

    ブログ記事や作品まとめページに複数のFlash作品を並べるとき(Ruffle 同じページ 複数 swf ID重複)、ネット上の単体サンプルコードをそのまま2回コピー&ペーストすると動かなくなることがあります。原因の多くは、コンテナ要素の id="flashContent" などが重複し、1つ目の枠に2つ目のSWFが上書きされたり、読み込みスクリプトが競合したりすることです。

    複数作品を同一ページに置く場合は、PlayerV1 API を使い、次の構造で分離するのが確実です。

    • 各作品ごとに固有のコンテナID(ruffle-player-1、ruffle-player-2、または任意の重複しないID)を用意する。
    • ruffle.js 本体の <script src="..."> と window.RufflePlayer.config はページ内に1回だけ読み込む。
    • DOMContentLoaded 内のループでコンテナIDごとに createPlayer() を生成し、作品ごとの volume と api.load(slot.src) を実行する。

    このツールでは「+ SWFを追加」から最大10件まで登録でき、各スロットのID重複チェックも自動で行います。初期音量を作品ごとに変えたい場合(例:トップメニューは100%、おまけアニメは80%)も、スロット設定の「ID・音量を指定」から個別に指定できます。

    ParaFla!作品や日本語フォントの文字化け対策

    ParaFla!(パラフラ)などで作成された古いFlashアニメーションやテキスト入力ゲームをRuffleで再生すると、日本語のダイナミックテキストや入力テキストが四角(豆腐文字・文字化け)になることがあります(ParaFla! Ruffle 再生 日本語 文字化け)。これはWeb版Ruffleの仕様上、ファイルサイズを抑えるために日本語グリフを含まない英語用フォント(Noto Sans)のみを内蔵しているためです。

    Ruffle公式FAQおよびDefaultFontsドキュメントでは、解決策として fontSources と defaultFonts の設定が案内されています。

    • 日本語フォント入りSWFまたはTTFを用意する:表示させたい日本語グリフを含めたフォントファイル(例:/fonts/japanese-fonts.swf や Webフォント用の .ttf)を自分のサーバーに置きます。注意点として、商用フォントやOS標準フォント(MS Pゴシック等)のファイルを無断でWeb公開することはライセンス違反になる場合があるため、M+ FONTS や Noto Sans JP などの再配布可能なフォントを使用してください。
    • 詳細設定に入力する:本ツールの「詳細設定」にある「日本語フォントパス」へファイルパスを、必要に応じて「フォント名」へフォント名を入れると、fontSources と defaultFonts(sans・japaneseGothic・japaneseMincho)を自動で出力します。

    ただし、フォントファイルがSWF形式(Flash側でフォント埋め込み済み)かTTF形式か、またSWF内部の文字参照方式によって必要なフォント名指定は異なります。まずはパスのみ、またはフォント名と組み合わせて実機表示を確認してください。

    よくある質問

    WordPressにプラグインなしでSWFを埋め込むにはどうすればいいですか?

    WordPressのブロックエディターで「カスタムHTML」ブロックを追加し、このツールで「WordPress・埋め込み用」を選んで生成したコードを貼り付けるだけで埋め込めます。2026年時点のWordPress公式プラグインディレクトリにRuffleの公式プラグインはありませんが、HTMLとJavaScriptの直接貼り付けで問題なく動作し、本ツールの出力はwpautopによる改行エラーも防いでいます。

    Ruffleをセルフホストするときに必要なファイルと.htaccess設定は?

    GitHub Releasesの web-selfhosted.zip に含まれる ruffle.js と、すべての *.wasm ファイル(ruffle_web_bg.<HASH>.wasm、ruffle_web-wasm_mvp_bg.<HASH>.wasm)を同じディレクトリへバイナリモードでアップロードし、.htaccess に「AddType application/wasm .wasm」を追記します。2022年ごろの旧版にあった core.ruffle.*.js は現在存在しないため不要です。

    1ページに複数のSWFを置くと動かない原因は何ですか?

    主な原因は、複数の埋め込みコードでコンテナ要素の id 属性(例:flashContent)が重複していること、または ruffle.js を何度も重複読み込みしていることです。本ツールでは「+ SWFを追加」で増やした各スロットに固有ID(ruffle-player-1、ruffle-player-2など)を自動割り当てし、単一の初期化ループで全プレイヤーを生成するため衝突しません。

    ParaFla!や古いFlashで日本語が文字化けするときはどうすればいいですか?

    Web版Ruffleは初期状態で日本語フォントを内蔵していないため、詳細設定の「日本語フォントパス(fontSources)」に再配布可能な日本語フォントファイル(.swf または .ttf)のURLを指定し、必要に応じて「フォント名(defaultFonts)」を設定します。ライセンス上問題のないフリーフォント(Noto Sans JP や M+ FONTS 等)をサーバーに配置して指定してください。

    ローカルでindex.htmlをダブルクリックしても再生できないのはなぜですか?

    ブラウザのセキュリティ制限(CORS)により、file:// から始まるローカルURLでは WebAssembly(.wasm)や外部SWFの読み込みがブロックされるためです。動作確認を行う際は、VS CodeのLive ServerやPythonの簡易サーバー(python3 -m http.server)、またはレンタルサーバー上の http:// / https:// 環境にアップロードして開いてください。

    入力したSWFのパスや設定はどこかに送信されますか?

    送信されません。埋め込みコードの生成や入力チェック、設計図の描画はすべてお使いのブラウザ内だけで完結しており、入力したファイル名やURLが外部サーバーへ送られることはありません。

    出典