RetroArchのソースを表示

[[Category:ゲーム]]
[[Category:エミュレーション]]
[[en:RetroArch]]
[[es:RetroArch]]
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}}

[http://www.retroarch.com/ RetroArch] は libretro API のリファレンス実装です。これは、ビデオゲームシステムエミュレーター、ゲームエンジン、ビデオゲーム、メディアプレイヤーおよびその他のアプリケーション用のモジュール式フロントエンドであり、マルチパスシェーダーのサポート、リアルタイムの巻き戻し、ビデオの記録 ([[FFmpeg]] を使用) などのいくつかの一般的でない技術的な機能を提供します。また、フル機能のコマンドラインインターフェイスに加えて、ゲームパッド操作のUIも備えています。

== インストール ==

{{Pkg|retroarch}} パッケージを[[インストール]]するか、開発版のために {{AUR|retroarch-git}} をインストールしてください。
{{Tip|
* RetroArch の GUI 用のフォントとアイコンを取得するために、{{Pkg|retroarch-assets-xmb}} をインストールしてください。デスクトップにより適した GUI のために、{{Pkg|retroarch-assets-ozone}} をインストールすることも検討してください。
* スタンドアロンのゲームボックス用に、システムユーザー、システムサービス、および RetroArch の設定を取得するために、{{AUR|retroarch-standalone-service}} をインストールしてください。その後、{{ic|retroarch-standalone.service}} を開始および/または有効にします。
* PATH にある retroarch を Steam にインストールされた retroarch にマップするために、{{AUR|retroarch-steam-launcher}} をインストールしてください。これは、PATH から retroarch を使用する {{AUR|emulationstation-de}} のようなアプリケーションで、クラウドセーブなどの Steam 機能を使用するのに便利です。
}}

== 使用方法 ==

RetroArch は、その機能のほとんどを「コア」と呼ばれる個別のライブラリに依存しています。これらは、RetroArch 内で ([https://buildbot.libretro.com/ libretro Buildbot] を介して) ユーザーごとにダウンロードするか、[https://www.archlinux.org/groups/x86_64/libretro/ Community] または [https://aur.archlinux.org/packages/?O=0&K=libretro AUR] からシステム全体に [[インストール]] することもできます。 

デフォルトでは、RetroArchはダウンロードするユーザーごとのコアをロードするように構成されています。他の場所にインストールする場合は、[[#設定]] を変更します。

特定のコアを実行するコマンドは次の通りです

 $ retroarch --libretro ''/path/to/some_core_libretro.so'' ''/path/to/rom''

== 設定 ==

RetroArch を初めて実行すると、ユーザー設定ファイルが作成されます{{ic|~/.config/retroarch/retroarch.cfg}}。

RetroArch コンポーネントをホームディレクトリにインストールする場合は、コアをダウンロードするためのグローバル構成ファイルでローカルパスを指定する必要があります。例えば、

{{hc|~/.config/retroarch/retroarch.cfg|2=libretro_directory = "~/.config/retroarch/cores"
libretro_info_path = "~/.config/retroarch/cores/info"}}

RetroArch コンポーネントを [[pacman]] を使ってシステム全体にインストールする場合は、グローバル設定ファイルにユーザーファイルを設定してしてください。例えば、

{{hc|/etc/retroarch.cfg|2=# for retroarch-assets-xmb
assets_directory = "/usr/share/retroarch/assets"
# for libretro-core-info
libretro_info_path = "/usr/share/libretro/info"
# for libretro cores
libretro_directory = "/usr/lib/libretro"}}

{{hc|~/.config/retroarch/retroarch.cfg|2=#include "/etc/retroarch.cfg"}}

{{Note|RetroArch はこれらのコンポーネントの複数の検索パスをサポートしていません。例えば、[[pacman]] でコアをインストールして、RetroArch の GUI を使ってコアをダウンロードした場合、それらは別のディレクトリにインストールされているので、RetroArch が一度にすべてのコアを表示するように設定することはできません。}}

設定を上書きしたい場合は (特定のコアを実行しているときなど) {{ic|--appendconfig ''/path/to/config''}} コマンドラインオプションを使うことができます。

== ヒントとテクニック ==

=== ''オンラインアップデーター'' を有効にする ===

pacman の代わりに組み込みのアップデータを使用して、すべての RetroArch コンポーネントをインストールする場合は、設定ファイルを使用して有効にすることができます:

{{hc|~/.config/retroarch/retroarch.cfg|2=menu_show_core_updater = "true"}}

{{Note| Install {{Pkg|libretro-core-info}} to ensure the core downloader works correctly.  Without this package it will not fetch the core list to choose from.
}}

=== ''SaveRAM Autosave Interval'' の有効化 ===

デフォルトでは、RetroArch はエラーなしで終了した場合のみ SRAM をディスクに書き込みます。つまり、クラッシュが発生しやすいコアを使用すると、セーブデータが失われるリスクがあります。この動作を変更するには、{{ic|~/.config/retroarch/retroarch.cfg}} を開いて、{{ic|autosave_interval}} に ''n'' を設定します。

{{hc|~/.config/retroarch/retroarch.cfg|2=
autosave_interval = "600"
}}

上記の例では、RetroArch は SRAM の変更を600秒毎にディスクに書き込みます。

{{Warning|この値を低くしすぎると、あらゆる種類の問題、特にハードウェアの劣化が発生します。[https://github.com/libretro/RetroArch/issues/4901#issuecomment-300888019] を参照してください}}

=== フィルターとシェーダー ===

RetroArch は [https://gitorious.org/bsnes/xml-shaders BSNES XML filters] と [https://github.com/libretro/common-shaders CG shaders] をロードできます。これらはそれぞれ、{{ic|retroarch.cfg}} に {{ic|video_bsnes_shader}} と {{ic|video_cg_shader}} でそれぞれ設定されています。シェーダーは、オンラインアップデータを使用して、RetroArch 内で直接取得および更新することもできます。

{{Note|{{AUR|retroarch-git}} では、''cg shaders'' を使用するために、{{pkg|nvidia-cg-toolkit}} が必要です。}}

=== 設定をデフォルト値にリセットする ===

GUIを使用して、設定またはキーバインドをデフォルト値にリセットするには、ハイライト表示して、{{ic|Start}} を押します。キーバインドからボタンを削除するには、キーバインドをハイライト表示にして、{{ic|Y}} を押します。

== トラブルシューティング ==
=== コアが見つかりません ===

デフォルトでは、RetroArch は {{ic|~/.config/retroarch/cores}} 内でコアを検索します。これは、Online Updater がコアをインストールする場所です。[[pacman]] でインストールされたコアは {{ic|/usr/lib/libretro}} に配置されるため、RetroArch の GUI には表示されません。コアのインストール方法（pacman または Online Updater）のいずれかを選択し、それに合わせて[[#Configuration|設定]]を変更する必要があります。

=== 入力デバイスが使えない ===
RetroArch を CLI で実行したり [[Xorg]] 以外のディスプレイサーバーで実行すると問題が発生します。{{ic|/dev/input}} ノードは root だけがアクセスできるように制限されているためです。この問題は手動で {{ic|1=KERNEL=="event*", NAME="input/%k", MODE="666"}} という中身のルールを {{ic|/etc/udev/rules.d/99-evdev.rules}} に追加することで解決します。次を実行して udev ルールをリロードしてください:
 # udevadm control --reload-rules

システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます:
 # chmod 666 /dev/input/event*

=== ビデオパフォーマンスが悪い ===
ビデオパフォーマンスが低いのを補うために、{{ic|~/.config/retroarch/retroarch.cfg}} に {{ic|<nowiki>video_threaded = true</nowiki>}} と設定することで RetroArch を別のスレッドで実行することができます。

ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。

=== ALSA でのオーディオの問題 ===

[[ALSA]] を使用する場合の {{ic|audio_out_rate}} は、システムのデフォルトの出力レートと一致させる必要があります。通常は、{{ic|48000}} です。

=== RetroArch がクラッシュするとセーブデータが失なわれる ===

[[#SaveRAM Autosave Interval の有効化]] を参照してください。

=== プレイリストからゲームを開始したが、'No Items' と報告される  ===

RetroArch が {{ic|libretro core requires contents, but nothing provided}} と報告する場合、''Main Menu > Load Content'' から ROM のパスを手動で選択してゲームをロードしてみてください。''playlist'' からゲームを開始するのは信頼性が低いようです。

RetroArch を Xwayland で強制的に起動する必要があります。

 $ WAYLAND_DISPLAY="" retroarch

{{ic|--verbose}} オプションを使用してログを確認できますが、その際に {{ic|"vk_wayland"}} の代わりに {{ic|Found vulkan context: "vk_x"}} が表示されるはずです。

=== BIOS ファイルが見つからない、または認識されない ===

Retroarch のコアは、{{ic|retroarch.cfg}} 内の {{ic|system_directory}} オプションで設定された場所に BIOS ファイルを探します。

GUI メニューの ''Settings > Directory > System/BIOS'' でもディレクトリが表示されます。

いくつかのコアは、ファイルをこのディレクトリに直接配置する必要があります。その他のコアは、特定の BIOS ファイルのために、このディレクトリ内に特定の名前のサブディレクトリが必要です。さらに、一部のコアは、実行しようとする ROM ファイルと同じディレクトリにファイルを探します。

インストールされている各コアは、必要なファイル、MD5 ハッシュ、および配置する必要があるディレクトリに関する情報を提供します。この情報は、GUI メニューの ''Settings > Core > Manage Core'' で確認できます。ここでコアを選択すると、この特定のコアに必要な BIOS ファイルに関する情報が表示されます。RetroArch は、コア情報ページでそれらを「ファームウェア」ファイルとして説明しています。

サポートされている多くのコアの BIOS ファイルに関する詳細な情報は、公式ドキュメントで確認できます。 [https://docs.libretro.com/library/bios/]

== 参照 ==
* [http://www.retroarch.com/ 公式ウェブサイト]
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github]
* [https://github.com/libretro/libretro.github.com/wiki/Documentation-devs 開発者向けドキュメント]