Ruffle - Adobe Flash Playerエミュレータ

Ruffleは、レガシーなFlashコンテンツ（ゲーム、アニメーション、アプリケーション、SWFバナー）を実行するために不可欠なAdobe Flash Playerエミュレータです。すべてのオペレーティングシステム（Windows、macOS、Linuxを含む）上でスタンドアロンアプリケーションとして動作し、WebAssemblyを介してブラウザに統合されます。

Ruffleは、Windows、macOS、Linux向けに個別のビルドを提供しており、これらは通常のプログラムと同様に動作します。実行ファイルを起動し、その中で目的のSWFファイルを開くだけです。

Ruffleは、Rust言語のメモリ安全性と最新ブラウザのサンドボックスを活用しています。これにより、潜在的に危険な古いコンテンツを、システム感染やデータ漏洩のリスクなく実行できます。

このエミュレータは、古いAVM1（ActionScript 1および2、2006年まで使用）と、より複雑なAVM2（ActionScript 3）の両方をサポートします。これは、2000年代初頭のアニメーションから、この技術が廃止される直前にリリースされた複雑なゲームやアプリケーションに至るまで、事実上すべてのFlashコンテンツを正しく動作させるために必要です。

ダウンロードリンク：

Windows (64-bit) macOS Linux (x86_64) Linux (ARM64) Flatpak

すべてのリンクは公式ソースにリンクしています。Windows（x86_64）、macOS（IntelとApple Silicon両対応のユニバーサル）、Linux（x86_64およびRaspberry PiやARMデバイス向けARM64）用のビルドはRuffleプロジェクトのGitHubリポジトリから配布され、Flatpak形式のLinux版はデジタル署名とアプリケーション分離機能を備えた公式Flathubカタログから入手できます。

目次：

Ruffleの主な機能

WebAssemblyによる統合。 ブラウザでの動作のために、RuffleはWebAssembly（Wasm）にコンパイルされます。これは、ブラウザの分離されたサンドボックス内でネイティブに近いパフォーマンスで実行される低レベルバイトコードです。これにより、時代遅れで安全でないNPAPI/PPAPIプラグインをインストールすることなく、複雑なFlashグラフィックやロジックを読み込み、処理することができます。

Flashコンテンツの自動検出とポリフィル。 Ruffleのウェブ版にはJavaScript検出機能が含まれており、ページのDOM構造内のobject、embed、applet要素、および.swf拡張子を持つファイルをスキャンします。そのようなコンテンツを検出すると、Ruffleは自動的にそれを自身のプレーヤーに置き換え、ユーザーに対して透過的にページを修正し、Flash要素の機能を復元します。

二重動作モード（デスクトップアプリケーションとウェブ拡張機能）。 Ruffleはユーザーに柔軟性を提供します。ローカルSWF再生用のスタンドアロンデスクトップアプリケーション（Ruffle実行ファイルにファイルを関連付けるだけ）として、またはブラウザのウェブ閲覧環境に統合され、任意のサイトでFlashサポートを提供するブラウザ拡張機能として使用できます。

ActionScript 1.0および2.0（AVM1）のサポート。 RuffleはAVM1仮想マシンを実装しており、2006年以前から2013年頃までに作成された膨大なコンテンツとの互換性を保証します。AVM1言語構造の現在の互換性レベルは99％に達し、APIについては81％であり、初期のFlashゲームやアニメーションの大部分が正しく動作することを保証します。

ActionScript 3.0（AVM2）のサポート。 2006年以降に作成されたコンテンツのために、RuffleはAVM2の実装を含んでいます。互換性向上の作業は積極的に進行中ですが、エミュレータはすでに多くの複雑なActionScript 3で書かれたゲームやアプリケーションを実行するのに十分なサポートレベルを提供しており、APIカバレッジと言語機能を継続的に拡大しています。

Rust言語レベルの安全性。 Ruffleの主要なアーキテクチャ上の利点の一つは、Rust言語の使用です。Rustはコンパイル時にメモリ安全性を保証し、バッファオーバーフロー、ダブルフリー、use-after-freeエラーなど、元のAdobe Flash Playerを悩ませていた脆弱性のクラス全体を完全に排除します。

ブラウザサンドボックス内での分離。 ウェブ環境で動作する場合、Ruffleは（WebAssemblyを介して）ブラウザのセキュリティポリシーに完全に準拠します。これにより、追加の分離レイヤーが追加されます。エミュレータはユーザーのファイルシステムやその他のシステムプロセスに直接アクセスできないため、従来のFlashプラグインと比較して悪用が非常に困難になります。

効率的なメモリ管理。 非決定的な一時停止を伴うガベージコレクションを使用した元のFlash Playerとは異なり、RuffleはRustの厳格な所有権モデルを継承しています。これにより、より予測可能なメモリ使用が可能になり、断片化が減少し、ブラウザの不安定な動作を引き起こすことが多かったメモリリークが排除されます。

コマンドラインサポート。 Ruffleのデスクトップ版は、完全に機能するコマンドラインインターフェースを提供します。ユーザーはパラメータを指定してエミュレータを実行できます。例：ruffle filename.swf（ローカルファイル）、またはruffle https://example.com/filename.swf（URLからSWFを再生）。コマンドruffle --helpを実行すると、利用可能なすべての引数と設定の包括的なリストが表示されます。

オープンソースコードと開発の透明性。 RuffleはApache 2.0およびMITライセンスの下で配布されています。ソースコードが完全に公開されているということは、あらゆる開発者がエミュレータのセキュリティを監査し、修正を提供し、その開発に参加できることを意味し、企業開発者によって導入される可能性のある隠された機能や脆弱性の可能性を排除します。

幅広いブラウザとの互換性。 WebAssembly技術のおかげで、RuffleはGoogle Chrome、Mozilla Firefox、Microsoft Edge、Safari、Opera、Brave、Vivaldiを含むすべての最新ブラウザでサポートされています。これにより、ユーザーがブラウザエンジン（Chromium、Gecko、またはWebKit）を好むかどうかに関わらず、一貫したFlashコンテンツ体験が保証されます。

モバイルブラウザ（iOSおよびAndroid）のサポート。 iOSで公式にサポートされておらず、Androidで限定的なサポートしかなかった元のAdobe Flash Playerとは異なり、Ruffleはモバイルプラットフォームで動作します。これにより、スマートフォンやタブレットでモバイルブラウザ経由で直接Flashゲームやアニメーションを実行でき、アーカイブされたコンテンツへのアクセスをモバイルユーザーに開放します。

設定は不要。 Ruffleは「セットして忘れる」という原則に基づいて設計されています。拡張機能をインストールするか、デスクトップアプリケーションを起動した後、エミュレータは複雑な設定を必要としません。ステージサイズ、フレームレート、インタラクションタイプなどの再生パラメータを自動的に検出し、ユーザーの介入なしに最適な設定を適用します。

ゼロデイ脆弱性からの保護。 Ruffleはプラグインではなく、時代遅れのAPIを使用せず、セキュリティに焦点を当てたRustでコードが書かれているため、Adobe Flash Playerに特徴的であった攻撃の影響を受けません。これにより、レガシーコンテンツへのアクセスを維持しなければならないが、システムが危険にさらされるリスクを冒せない組織にとって理想的なソリューションとなります。

様々なインストール方法との互換性。 Ruffleはいくつかの展開方法を提供しています。ウェブ開発者は、Chromiumベースのブラウザに静的拡張機能として（開発者モードを介して）インストールしたり、Firefoxに一時的なアドオンとして（about:debuggingを介して）インストールしたりできます。サーバーサイドでの簡単なJavaScriptコード挿入による統合も利用可能です。

オンラインおよびオフラインコンテンツの再生。 Ruffleのデスクトップ版では、コンピュータにローカルに保存されたSWFファイルを開いて再生することができます。これにより、RuffleはFlashゲームやアニメーションのローカルアーカイブを扱うコレクター、アーキビスト、研究者にとって不可欠なツールとなっています。

高いレンダリングパフォーマンス。 Ruffleは、クロスプラットフォームライブラリを介して最新のグラフィックスAPI（OpenGL、Vulkan、DirectX、WebGLなど）を使用します。これにより、ベクターグラフィックスとラスターグラフィックスのレンダリングにハードウェアアクセラレーションが提供され、元のFlash Playerでは動作が遅くなる可能性があった、より弱いデバイスでもスムーズな再生が可能になります。

活発な開発と頻繁なアップデート。 このプロジェクトは活発に開発中です。リリースは定期的に公開され、重要なバグ修正と拡張されたActionScript APIサポートの両方が含まれています。例えば、最近のバージョンではString.indexOfおよびlastIndexOfメソッドのエッジケースが修正され、Array.indexOfでの負のインデックスが正しく処理されるようになりました。

主要なアーカイブやプラットフォームとの統合。 Ruffleは、Internet Archive、Newgrounds、Coolmath Games、Armor Gamesなどの大手企業によってFlashコンテンツ再生の公式プレーヤーとして選ばれています。これは、エミュレータの高い信頼性と互換性、および実際の条件下で高負荷下で動作する能力を裏付けています。

ゲームセーブと状態のサポート。 元のFlash Playerと同様に、RuffleはLocal Shared Objects（LSO）をサポートしています。多くのゲームが進行状況の保存にこれを使用しています。エミュレータはこのストレージへのデータ読み書きメカニズムを正しくエミュレートし、アプリケーションの実行時間内でのセーブデータの整合性を保証します。

タイミングとフレームレートの正確なエミュレーション。 RuffleはFlash Playerの内部タイマーを正確にエミュレートします。これはゲームやアニメーションのロジックにとって重要です。これにより、イベント、サウンド、オブジェクトの動きの適切な同期が保証され、ゲームがオリジナルよりも遅くまたは速く動作する状況を防ぎます。

DOMおよびJavaScriptインタラクション（ExternalInterface）のサポート。 ActionScriptとJavaScript間でデータを交換するためにExternalInterface APIを使用した複雑なウェブアプリケーションのために、Ruffleは互換性のあるブリッジを実装しています。これにより、エミュレータは関数呼び出しとデータ転送を正しく処理し、周囲のウェブページとのコンテンツのインタラクティビティを維持できます。

自動スケーリングと解像度適応。 特定の解像度（例：800x600）向けに作成されたFlashコンテンツを再生する場合、Ruffleはブラウザまたはデスクトップアプリケーションの現在のウィンドウサイズに適応するためにスケーリングアルゴリズムを自動的に適用します。縦横比と画質を維持し、マウスインタラクション領域を正しく処理します。

多様なメディアフォーマットのサポート。 エミュレータは、SWFファイルに埋め込まれる可能性のある様々なメディアフォーマット（オーディオ圧縮用のMP3や、Flashの後期バージョンで使用されるビデオ圧縮を含む）のデコードをサポートしています。デコードはRustで書かれた高性能ライブラリを介して実行され、システム負荷を軽減します。

高度なデバッグとロギング。 開発者や上級ユーザー向けに、RuffleはAVM1/AVM2仮想マシン操作の詳細なログを有効にする機能を提供します。これにより、互換性の問題を診断し、ActionScriptコードのエラーを追跡し、より精密な調整のためにエミュレーションの内部プロセスを理解することができます。

カーソルとインタラクティブ要素のエミュレーション。 Ruffleは、Flashコンテンツによって指定されたカーソルスタイルの変更を正しく処理します。例えば、LoaderDisplayのようなインタラクティブな要素では、エミュレータは自動的に標準カーソルをポインタに変更し、元のFlashプレーヤーの動作を模倣して、ユーザーに使い慣れたナビゲーションを提供します。

早期アクセス用のNightlyビルドのサポート。 安定版リリースに加えて、Ruffleチームは毎日の実験的なNightlyビルドへのアクセスを提供しています。これらのビルドには、安定版にはまだ含まれていない最新の修正と革新が含まれています。

デジタル文化遺産の保存。 これは単なる技術的機能ではなく、プロジェクトの基本的な目標です。Ruffleは、歴史的なインターネットコンテンツを保存するためのツールとして作成されました。セキュリティを損なうことなく最新のブラウザで動作する能力のおかげで、Adobe Flash Playerの廃止後に永久に失われていたはずの何百万ものFlashゲーム、アニメーション、アプリケーションが、将来の世代のためにアクセス可能な状態を保っています。

Ruffleの知られざる12の技術的機能

  1. プライマリレンダリングバックエンドとしてのWGPUの使用。 レガシーなOpenGLに依存する多くのエミュレータとは異なり、RuffleはWGPUライブラリを使用します。これは、最新の、安全で、クロスプラットフォームなグラフィックスAPIです。デスクトップでは、WGPUは自動的に最適な低レベルバックエンド（Vulkan、DirectX 12、またはMetal）を選択します。ブラウザでは、WebGPU（利用可能な場合）を介して動作するか、最小限のパフォーマンス損失でWebGLを介して動作をエミュレートできます。

  2. 最大パフォーマンスのためのブラウザでのWebGPUサポート。 最新のブラウザ（例：ChromeとEdgeの最新バージョン）のユーザーは、Ruffleが最先端のWebGPU APIを使用できます。これにより、標準のWebGLバックエンドと比較して、シェーダーコンパイル時間が大幅に短縮され、オーバーヘッドが低減されます。これは、複雑な3DグラフィックスやStage3Dアプリケーションにとって重要です。

  3. きめ細かなレンダリングバックエンドの調整（canvas、webgl、wgpu-webgl）。 レンダリング動作を手動で制御できることを知っている人はほとんどいません。標準のwgpu-webglに加えて、強制的に有効にするオプションがあります：

    • webgl — 起動が速く、複雑なビットマップ効果を必要としないシンプルなコンテンツに役立つ可能性がある従来のバックエンド。

    • canvas — 最も遅いですが、最も正確なバックエンドです。これは、ハードウェアアクセラレーションを使用すると太く見えすぎる可能性がある、ベクターグラフィックスのヘアラインストロークを正しくスケーリングできる唯一のバックエンドです。

  4. Stage3DのエミュレーションとAGALからWGSLへのコンパイル。 Ruffleは2Dグラフィックスだけでなく、Stage3D（Context3D）APIを介した3Dアクセラレーションもサポートしています。AGAL（Adobe Graphics Assembly Language）で書かれたシェーダーは、最新のWGSL（WebGPU Shading Language）またはGLSLに「オンザフライ」でコンパイルされます。これにより、Flash Player 11以降向けに作成された複雑な3Dゲームやアプリケーションを、プログラム可能なシェーダーの完全なパイプラインを利用して実行できます。

  5. 後方互換性のためのfscommandのサポート。 Ruffleは、レガシーではあるが重要なfscommandメカニズムのサポートを維持しています。これにより、古いFlashムービー（ExternalInterface以前に作成されたもの）が、任意のコマンドと引数を送信して、ページ上のJavaScriptと対話できるようになります。Ruffleの最新の実装では、これらのコマンドはonFSCommandを介して処理され、非常に古いウェブコンテンツでも機能性を可能にします。

  6. Context3Dのためのダブルバッファリング。 3Dコンテンツを扱う場合、Ruffleは高度なダブルバッファリングメカニズム（バックバッファ/フロントバッファ）を使用します。これは標準的ですが、非常に重要なパフォーマンス向上技術であり、現在のフレームが画面に表示されている間に次のフレームをバックグラウンドバッファでレンダリングすることを可能にし、動的なゲームにおける視覚的アーティファクト（フレームのティアリング）を排除します。

  7. ベンチマークツール：ruffle_scannerとexporter。 Ruffleリポジトリ内には、標準ビルドには含まれていないが開発者が利用できるユーティリティツールがあります：

    • ruffle_scanner — SWFファイルのフォルダ全体に対するエミュレータの互換性をテストし、解析成功に関するCSVレポートを生成できます。

    • exporter — SWFファイルからPNGスクリーンショットをバッチ生成するためのツールで、GUIなしのヘッドレスモードで実行でき、自動テストやプレビューの作成に役立ちます。

  8. Flatpakサンドボックスによる完全な分離。 Linuxユーザー向けに、Flatpak形式での公式Ruffleビルドがあります。これは単なるインストール方法ではなく、追加のセキュリティレイヤーです。アプリケーションは分離された環境で実行され、すべての保存データ、設定、ログはFlatpakホームディレクトリ（~/.var/app/rs.ruffle.Ruffle/）内に厳密に保存され、システムの他の部分にアクセスすることはありません。

  9. HomebrewとScoopによる統合サポート。 経験豊富なユーザー向けに、Ruffleは手動ダウンロードを超えた高度なインストール方法を提供しています。macOSでは、Homebrew（brew install --HEAD ruffle-rs/ruffle/ruffle）を介してインストールでき、最新のナイトリービルドへの自動更新が可能です。Windowsでは、Scoopパッケージマネージャーが同様の機能を提供します。

  10. 透過的なデータストレージシステム（SharedObjects）。 Ruffleは、Flashローカルストレージシステム（LSO — Local Shared Objects）を正確にエミュレートします。ただし、独自のプレーヤーとは異なり、これらのファイルの場所は標準化されており、ユーザーにとって透過的です。Windowsでは%AppData%\Local\Ruffle\SharedObjects\、Linuxでは~/.local/share/ruffle/SharedObjects/に配置されます。これにより、古いゲームのセーブデータを手動でバックアップできます。

  11. JavaScript APIとグローバル設定による設定。 ウェブ開発者向けに、Ruffleは強力なJavaScript APIを提供しており、プレーヤーの埋め込みだけでなく、その状態の制御も可能にします。プログラムによるSWFのロード（load）、ボリューム制御（volume）、一時停止（suspend/resume）、およびtraceObserverを介したデバッグ用のActionScriptからのtrace()出力のインターセプトなどのメソッドが利用可能です。

  12. macOSビルドの自動署名とノータリゼーション。 CI/CDプロセスでは、macOS用のすべてのRuffleナイトリービルドがAppleによるコード署名とノータリゼーションを受けています。これは、エミュレータの不安定なバージョンであっても、Gatekeeperによって安全でないソフトウェアとしてブロックされず、セキュリティ要件が厳しい最新バージョンのmacOSでの問題のない動作を保証することを意味します。

Ruffleデスクトップ版のインストール

Ruffleのデスクトップ版は、ブラウザを必要とせず、コンピュータ上で直接SWFファイルを開いて再生できるネイティブアプリケーションです。これは、Flashゲームやアニメーションのローカルアーカイブを表示するための理想的な選択肢です。

Windows（10、11）

方法1：グラフィカルインターフェース（推奨）

  1. ruffle-windows-x86_64.zip（64ビットシステム用）またはruffle-windows-x86.zip（32ビットシステム用）という名前のファイルをダウンロードします。

  2. アーカイブの内容を任意の便利なフォルダ（例：C:\Program Files\Ruffle または C:\Users\[ユーザー名]\Documents\Ruffle）に展開します。

  3. 実行するには、実行可能ファイルruffle.exeをダブルクリックします。アプリケーションのグラフィカルインターフェースが開きます。

  4. SWFファイルを開くには、インターフェースのOpen Fileボタンをクリックするか、SWFファイルをアプリケーションウィンドウにドラッグアンドドロップします。

  5. 代替方法： ファイルの関連付けを設定します。任意の.swfファイルを右クリックし、Open with → Choose another appを選択し、ruffle.exeを見つけて、Always use this app to open .swf filesオプションをオンにします。

方法2：コマンドライン

経験豊富なユーザー向けに、コマンドラインインターフェースが利用可能です：

  1. コマンドプロンプト（CMD）またはPowerShellを開きます。

  2. ruffle.exeを含むフォルダに移動するか、そのフォルダをPATH環境変数に追加します。

  3. ローカルファイルを実行するには、コマンドを実行します：

    ruffle.exe C:\path\to\your\file.swf

  4. URLからSWFファイルを実行するには：

    ruffle.exe https://example.com/animation.swf

  5. 利用可能なすべてのコマンドラインパラメータを表示するには：

    ruffle.exe --help

方法3：Scoopパッケージマネージャーによるインストール

自動インストールを希望する方へ：

scoop bucket add extras
scoop install ruffle

macOS

方法1：グラフィカルインターフェース（推奨）

  1. リリースページからファイルruffle-macos-x86_64.dmgまたはruffle-macos-aarch64.dmg（Apple Silicon M1/M2/M3用）をダウンロードします。

  2. ダウンロードした.dmgファイルを開きます。

  3. RuffleアイコンをApplicationsフォルダにドラッグします。

  4. ApplicationsフォルダからRuffleを起動します。初回起動時、システムが確認を求める場合があります — Openをクリックします。

  5. アプリケーションが起動したら、Open Fileボタンを使用するか、SWFファイルをウィンドウにドラッグアンドドロップします。

方法2：Homebrewによるインストール

上級ユーザー向け：

# 利用可能な場合、最新の安定版をインストール
brew install ruffle

# または、ソースから最新のナイトリービルドをインストール
brew install --HEAD ruffle-rs/ruffle/ruffle

方法3：コマンドライン

Homebrewでインストールした後、または手動でruffleを/usr/local/binに配置した後：

ruffle ~/Downloads/game.swf
ruffle https://example.com/game.swf

Linux

方法1：Flatpakによるインストール（分離のために推奨）

Flatpakは、Ruffleを分離されたサンドボックスで実行することにより、最大限のセキュリティを提供します：

# Flathubリポジトリを追加
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Ruffleをインストール
flatpak install flathub rs.ruffle.Ruffle

# 実行
flatpak run rs.ruffle.Ruffle

方法2：AppImageによるインストール（インストール不要）

  1. リリースページからファイルruffle-x86_64.AppImageをダウンロードします。

  2. ファイルを実行可能にします：

    chmod +x ruffle-x86_64.AppImage

  3. ダブルクリックするか、ターミナルで実行します：

    ./ruffle-x86_64.AppImage

方法3：手動インストール（Debian/Ubuntuベースのディストリビューション向け）

  1. ruffle-linux-x86_64.tar.gz（またはRaspberry PiなどのARMデバイス用ruffle-linux-armv7.tar.gz）をダウンロードします。

  2. アーカイブを展開します：

    tar -xzf ruffle-linux-x86_64.tar.gz

  3. 実行可能ファイルをシステムディレクトリにコピーします：

    sudo cp ruffle /usr/local/bin/

  4. ターミナルから実行します：

    ruffle

Ruffleをブラウザ拡張機能としてインストールする

Ruffle拡張機能は、任意のウェブページ上のFlashコンテンツを自動的に検出し、それをエミュレータに置き換えます。

重要な注意事項

現在、この拡張機能は公式の拡張機能ストア（Chromeウェブストア、Firefoxアドオン）ではホストされておらず、活発に開発中です。インストールは、ブラウザのデベロッパーモードを介して手動で行われます。

Google ChromeおよびChromiumベースのブラウザへのインストール

対応ブラウザ：Google Chrome、Microsoft Edge、Brave、Opera、Vivaldi、Arcなど、Chromiumベースのもの。

ステップバイステップの手順：

  1. GitHubのRuffleリリースページにアクセスします。

  2. ruffle-chromium.zip（またはchromiumを含む類似の名前）というアーカイブをダウンロードします。

  3. アーカイブをコンピュータ上の永続的なフォルダに展開します。 重要： インストール後、ブラウザは拡張機能が動作するためにこのフォルダにアクセスするため、このフォルダを削除しないでください。推奨場所：

    • Windows: C:\Users\[ユーザー名]\AppData\Local\Ruffle\

    • macOS: ~/Library/Application Support/Ruffle/

    • Linux: ~/.local/share/ruffle/

  4. ブラウザを開き、アドレスバーに以下を入力します：

    chrome://extensions/

  5. ページの右上隅で、デベロッパーモードを有効にします。

  6. パッケージ化されていない拡張機能を読み込むボタンをクリックします。

  7. 開いたダイアログで、ruffle-chromium.zipアーカイブを展開したフォルダを選択し、フォルダを選択をクリックします。

  8. 拡張機能がインストールされました。これで、Flashコンテンツを含むサイトを訪問すると、Ruffleが自動的に起動します。

Microsoft Edge（Chromium）の場合： 手順はChromeと同じです。chrome://extensions/の代わりにedge://extensions/を使用し、デベロッパーモードを有効にします。

Mozilla Firefoxへのインストール

重要： Firefoxでは、拡張機能は一時的にのみインストールされ、ブラウザを再起動すると削除されます。これは、未署名の拡張機能に対するFirefoxの制限です。永続的に使用するには、デスクトップ版を使用するか、公式ストアでの公開を待つことをお勧めします。

ステップバイステップの手順：

  1. GitHubのRuffleリリースページにアクセスします。

  2. ruffle-firefox.xpiという名前のファイルをダウンロードします。ダウンロードする際は、ファイルを保存を選択します。

  3. Firefoxで、アドレスバーに以下を入力します：

    about:debugging

  4. 左側のサイドバーで、このFirefoxを選択します。

  5. 一時的なアドオンを読み込む…ボタンをクリックします。

  6. ファイルダイアログで、ダウンロードしたruffle-firefox.xpiファイルを選択し、開くをクリックします。

  7. 拡張機能が読み込まれ、有効になります。ブラウザを閉じるまで動作します。

ヒント： Firefox NightlyまたはDeveloper Editionを使用している場合、about:configで拡張機能の署名検証を無効にすることができ、これにより永続的なインストールが可能になりますが、セキュリティ上の理由から日常的な使用には推奨されません。

Safari（macOS）へのインストール

SafariにRuffle拡張機能をインストールするには、Appleのセキュリティポリシーのため、追加の手順が必要です。

  1. リリースページからruffle-safari.zipファイルをダウンロードします。

  2. アーカイブを展開します。

  3. 展開したフォルダからRuffle.appファイルを実行します。これにより、拡張機能がシステムにインストールされます。

  4. Safariを開き、Safari → 設定 → 拡張機能タブに移動します。

  5. Ruffleの横にあるトグルスイッチがオンになっていることを確認します。

  6. 拡張機能が有効になり、ウェブページ上のFlashコンテンツで動作します。

ウェブサイトへのRuffleのインストール（ウェブマスター向け）

Flashコンテンツをホストするウェブサイトを運営している場合、Ruffleを自分のページコードに直接統合できます。これにより、サイトの訪問者は拡張機能をインストールしなくても、自動的にFlashコンテンツを再生できるようになります。

最も簡単な方法：JavaScriptプレーヤーの使用

  1. リリースページからファイルruffle.jsとリソースフォルダruffleをダウンロードします。

  2. これらのファイルをサーバーにアップロードします（例：/js/ruffle/のようなフォルダ内）。

  3. Flashコンテンツが存在する各ページの<head>セクションに、以下のコードを追加します：

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // プレーヤー設定
        autoplay: "auto", // "on", "off" または "auto"
        splashScreen: false, // スプラッシュ画面を無効化
    };
</script>

  1. Ruffleはページ上のすべてのobject、embed、applet要素を自動的に検出し、それらを自身のプレーヤーに置き換えます。

CDNを使用した高度な設定（ファイルをダウンロードしない）

簡単なテストのために、CDNを使用できます：

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        autoplay: "on",
    };
</script>

動的に読み込まれるコンテンツのための手動初期化：

SWFファイルが動的に（JavaScriptを介して）ページに追加される場合、プレーヤーを手動で初期化できます：

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("path/to/your/file.swf");
document.body.appendChild(player);

動作確認

いずれかの方法でRuffleをインストールした後、その動作を確認できます：

  1. デスクトップ版： 任意のSWFファイルを開くだけです。

  2. ブラウザ拡張機能： Internet ArchiveのFlashゲームコレクションまたはFlashコンテンツがある既知のサイトにアクセスします。Flash要素が表示され、再生されれば、Ruffleは正しく動作しています。

  3. 診断： ブラウザでF12キーを押して開発者ツールを開きます。コンソールに、Ruffleの起動を確認するメッセージが表示されます。

一般的な問題のトラブルシューティング

問題 考えられる解決策
拡張機能がサイトで起動しない サイトが拡張機能の設定でブロックされていないことを確認します。chrome://extensions/でデベロッパーモードが有効になっていることを確認します。
SWFファイルが再生されない、または白い画面が表示される 現在のRuffleのバージョンがこの特定のSWFファイルをサポートしていない可能性があります。コンテンツがAVM2（ActionScript 3）かどうかを確認します。サポートはまだ改善中です。
デスクトップ版でファイルを開けない ファイルが破損していないことを確認します。コマンドラインから--verboseフラグを付けて開き、詳細なエラーログを取得してみてください。
Firefox再起動後に拡張機能が消えた これは一時的な拡張機能の通常の動作です。デスクトップ版を使用するか、アドオンストアでの公式公開を待ってください。
ブラウザでのパフォーマンスが低い 拡張機能の設定でレンダリングバックエンドを切り替えてみてください。Chromiumブラウザの場合、ブラウザ設定でハードウェアアクセラレーションが有効になっているかどうかも確認してください。