「RetroArch」の版間の差分
Kusanaginoturugi (トーク | 投稿記録) (→Tips and tricks: 和訳) |
Kusanaginoturugi (トーク | 投稿記録) (→参照: add TranslationStatus) |
||
(同じ利用者による、間の26版が非表示) | |||
5行目: | 5行目: | ||
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}} |
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}} |
||
− | [http://www.retroarch.com/ RetroArch] は |
+ | [http://www.retroarch.com/ RetroArch] は libretro API のリファレンス実装です。これは、ビデオゲームシステムエミュレーター、ゲームエンジン、ビデオゲーム、メディアプレイヤーおよびその他のアプリケーション用のモジュール式フロントエンドであり、マルチパスシェーダーのサポート、リアルタイムの巻き戻し、ビデオの記録 ([[FFmpeg]] を使用) などのいくつかの一般的でない技術的な機能を提供します。また、フル機能のコマンドラインインターフェイスに加えて、ゲームパッド操作のUIも備えています。 |
== インストール == |
== インストール == |
||
− | {{Pkg|retroarch}} パッケージをインストールしてください。あるいは開発版を使いたい場合は {{AUR|retroarch-git}} をインストールしてください。 |
||
+ | {{Pkg|retroarch}} パッケージを[[インストール]]するか、開発版のために {{AUR|retroarch-git}} をインストールしてください。 |
||
{{Tip| |
{{Tip| |
||
− | * |
+ | * RetroArch の GUI 用のフォントとアイコンを取得するために、{{Pkg|retroarch-assets-xmb}} をインストールしてください。デスクトップにより適した GUI のために、{{Pkg|retroarch-assets-ozone}} をインストールすることも検討してください。 |
+ | * スタンドアロンのゲームボックス用に、システムユーザー、システムサービス、および RetroArch の設定を取得するために、{{AUR|retroarch-standalone-service}} をインストールしてください。その後、{{ic|retroarch-standalone.service}} を開始および/または有効にします。 |
||
− | * Install {{AUR|retroarch-standalone-service}} to get system user, system service and RetroArch configuration for standalone game-box. Then start and/or enable {{ic|retroarch-standalone.service}}. |
||
+ | * PATH にある retroarch を Steam にインストールされた retroarch にマップするために、{{AUR|retroarch-steam-launcher}} をインストールしてください。これは、PATH から retroarch を使用する {{AUR|emulationstation-de}} のようなアプリケーションで、クラウドセーブなどの Steam 機能を使用するのに便利です。 |
||
}} |
}} |
||
== 使用方法 == |
== 使用方法 == |
||
− | RetroArch は''エミュレータコア''や''エミュレータ実装''と呼ばれる形でライブラリを分離しており [https://www.archlinux.org/packages/?q=libretro Community] リポジトリや [https://github.com/libretro Libretro GitHub リポジトリ] から入手できます。 |
||
+ | 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] からシステム全体に [[インストール]] することもできます。 |
||
− | libretro コアパッケージはライブラリを {{ic|/usr/lib/libretro/}} にインストールします。ライブラリを選択して ''retroarch'' を実行する場合: |
||
− | $ retroarch --libretro /usr/lib/libretro/libretro-''core''.so ''path/to/rom'' |
||
+ | デフォルトでは、RetroArchはダウンロードするユーザーごとのコアをロードするように構成されています。他の場所にインストールする場合は、[[#設定]] を変更します。 |
||
− | デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。例: |
||
+ | 特定のコアを実行するコマンドは次の通りです |
||
− | {{hc|~/.config/retroarch/retroarch.cfg|2= |
||
+ | |||
− | libretro_path = "/usr/lib/libretro/libretro-''core''.so"}} |
||
+ | $ retroarch --libretro ''/path/to/some_core_libretro.so'' ''/path/to/rom'' |
||
== 設定 == |
== 設定 == |
||
− | RetroArch の設定ファイルは {{ic|/etc/retroarch.cfg}} にあり、コメントが大量に付記されています。 |
||
+ | RetroArch を初めて実行すると、ユーザー設定ファイルが作成されます{{ic|~/.config/retroarch/retroarch.cfg}}。 |
||
− | デフォルトの設定ファイルをホームディレクトリにコピー: |
||
+ | |||
− | $ cp /etc/retroarch.cfg ~/.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|retroarch.cfg}} で {{ic|#include "foo.cfg"}} ディレクティブを使うことで設定ファイルを分割することができます。{{ic|--appendconfig /path/to/config}} パラメータを使うことで設定を上書きすることができ、キーバインドやビデオ設定、音声設定などを実装に合わせて変更する必要がある場合に便利です。 |
||
+ | 設定を上書きしたい場合は (特定のコアを実行しているときなど) {{ic|--appendconfig ''/path/to/config''}} コマンドラインオプションを使うことができます。 |
||
− | {{Tip|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}} として定義します。}} |
||
− | {{Note|{{AUR|retroarch-git}} で ''cg shaders'' を使うには {{pkg|nvidia-cg-toolkit}} が必要です。}} |
||
− | {{Warning|[[ALSA]] を使用する場合、{{ic|audio_out_rate}} をシステムのデフォルト出力レート (通常は {{ic|48000}}) に合わせる必要があります。}} |
||
== ヒントとテクニック == |
== ヒントとテクニック == |
||
46行目: | 58行目: | ||
{{hc|~/.config/retroarch/retroarch.cfg|2=menu_show_core_updater = "true"}} |
{{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. |
||
− | === Enabling ''SaveRAM Autosave Interval'' === |
||
+ | }} |
||
+ | |||
+ | === ''SaveRAM Autosave Interval'' の有効化 === |
||
− | + | デフォルトでは、RetroArch はエラーなしで終了した場合のみ SRAM をディスクに書き込みます。つまり、クラッシュが発生しやすいコアを使用すると、セーブデータが失われるリスクがあります。この動作を変更するには、{{ic|~/.config/retroarch/retroarch.cfg}} を開いて、{{ic|autosave_interval}} に ''n'' を設定します。 |
|
{{hc|~/.config/retroarch/retroarch.cfg|2= |
{{hc|~/.config/retroarch/retroarch.cfg|2= |
||
54行目: | 69行目: | ||
}} |
}} |
||
+ | 上記の例では、RetroArch は SRAM の変更を600秒毎にディスクに書き込みます。 |
||
− | With the example above, RetroArch will write SRAM changes onto disk every 600 seconds. |
||
− | {{Warning| |
+ | {{Warning|この値を低くしすぎると、あらゆる種類の問題、特にハードウェアの劣化が発生します。[https://github.com/libretro/RetroArch/issues/4901#issuecomment-300888019] を参照してください}} |
+ | === フィルターとシェーダー === |
||
− | === Filters and shaders === |
||
− | RetroArch |
+ | 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}} |
+ | {{Note|{{AUR|retroarch-git}} では、''cg shaders'' を使用するために、{{pkg|nvidia-cg-toolkit}} が必要です。}} |
+ | === 設定をデフォルト値にリセットする === |
||
− | === Reset settings to their default value === |
||
+ | GUIを使用して、設定またはキーバインドをデフォルト値にリセットするには、ハイライト表示して、{{ic|Start}} を押します。キーバインドからボタンを削除するには、キーバインドをハイライト表示にして、{{ic|Y}} を押します。 |
||
− | To reset a setting or keybind to its default value through the GUI, highlight it and press {{ic|Start}}. To remove a button from a keybind, highlight the keybind and press {{ic|Y}}. |
||
== トラブルシューティング == |
== トラブルシューティング == |
||
− | === |
+ | === コアが見つかりません === |
− | デフォルトでは RetroArch は {{ic|/usr/lib/libretro/}} からコアを検索します。付属のオンラインアップデータでダウンロードされたコアは root で retroarch を実行しないと保存されません (推奨されません、[[pacman]] によってインストールされたコアを上書きしてしまう恐れがあります)。ユーザーではディレクトリを編集する権限がないためです。オンラインアップデータのコアを使うには、以下の行を編集してください: |
||
+ | デフォルトでは、RetroArch は {{ic|~/.config/retroarch/cores}} 内でコアを検索します。これは、Online Updater がコアをインストールする場所です。[[pacman]] でインストールされたコアは {{ic|/usr/lib/libretro}} に配置されるため、RetroArch の GUI には表示されません。コアのインストール方法(pacman または Online Updater)のいずれかを選択し、それに合わせて[[#Configuration|設定]]を変更する必要があります。 |
||
− | {{hc|~/.config/retroarch/retroarch.cfg|2= |
||
− | libretro_directory = "~/.config/retroarch/cores" |
||
− | libretro_info_path = "~/.config/retroarch/cores/info" |
||
− | }} |
||
− | |||
− | === メニューにコアをアップデート・ダウンロードするオプションが存在しない === |
||
− | |||
− | {{ic|~/.config/retroarch/retroarch.cfg}} または {{ic|/etc/retroarch.cfg}} を開いて {{ic|menu_show_core_updater}} が {{ic|true}} に設定されていることを確認してください。設定すると ''Online Updater'' メニューからコアをアップデートして ''Load Core'' メニューからコアをダウンロードできるようになります。 |
||
=== 入力デバイスが使えない === |
=== 入力デバイスが使えない === |
||
87行目: | 94行目: | ||
システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます: |
システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます: |
||
# chmod 666 /dev/input/event* |
# chmod 666 /dev/input/event* |
||
− | |||
− | もしくは、ユーザーを "input" グループに追加してください。例: |
||
− | |||
− | # usermod -a -G input user |
||
=== ビデオパフォーマンスが悪い === |
=== ビデオパフォーマンスが悪い === |
||
97行目: | 100行目: | ||
ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。 |
ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。 |
||
− | === |
+ | === ALSA でのオーディオの問題 === |
− | + | [[ALSA]] を使用する場合の {{ic|audio_out_rate}} は、システムのデフォルトの出力レートと一致させる必要があります。通常は、{{ic|48000}} です。 |
|
+ | === RetroArch がクラッシュするとセーブデータが失なわれる === |
||
− | === Save data is lost whenever RetroArch crashes === |
||
− | + | [[#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/] |
||
== 参照 == |
== 参照 == |
||
109行目: | 134行目: | ||
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github] |
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github] |
||
* [https://github.com/libretro/libretro.github.com/wiki/Documentation-devs 開発者向けドキュメント] |
* [https://github.com/libretro/libretro.github.com/wiki/Documentation-devs 開発者向けドキュメント] |
||
+ | |||
+ | {{TranslationStatus|RetroArch|2024-08-25|803998}} |
2024年8月25日 (日) 19:49時点における最新版
RetroArch は libretro API のリファレンス実装です。これは、ビデオゲームシステムエミュレーター、ゲームエンジン、ビデオゲーム、メディアプレイヤーおよびその他のアプリケーション用のモジュール式フロントエンドであり、マルチパスシェーダーのサポート、リアルタイムの巻き戻し、ビデオの記録 (FFmpeg を使用) などのいくつかの一般的でない技術的な機能を提供します。また、フル機能のコマンドラインインターフェイスに加えて、ゲームパッド操作のUIも備えています。
インストール
retroarch パッケージをインストールするか、開発版のために retroarch-gitAUR をインストールしてください。
使用方法
RetroArch は、その機能のほとんどを「コア」と呼ばれる個別のライブラリに依存しています。これらは、RetroArch 内で (libretro Buildbot を介して) ユーザーごとにダウンロードするか、Community または AUR からシステム全体に インストール することもできます。
デフォルトでは、RetroArchはダウンロードするユーザーごとのコアをロードするように構成されています。他の場所にインストールする場合は、#設定 を変更します。
特定のコアを実行するコマンドは次の通りです
$ retroarch --libretro /path/to/some_core_libretro.so /path/to/rom
設定
RetroArch を初めて実行すると、ユーザー設定ファイルが作成されます~/.config/retroarch/retroarch.cfg
。
RetroArch コンポーネントをホームディレクトリにインストールする場合は、コアをダウンロードするためのグローバル構成ファイルでローカルパスを指定する必要があります。例えば、
~/.config/retroarch/retroarch.cfg
libretro_directory = "~/.config/retroarch/cores" libretro_info_path = "~/.config/retroarch/cores/info"
RetroArch コンポーネントを pacman を使ってシステム全体にインストールする場合は、グローバル設定ファイルにユーザーファイルを設定してしてください。例えば、
/etc/retroarch.cfg
# 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"
~/.config/retroarch/retroarch.cfg
#include "/etc/retroarch.cfg"
設定を上書きしたい場合は (特定のコアを実行しているときなど) --appendconfig /path/to/config
コマンドラインオプションを使うことができます。
ヒントとテクニック
オンラインアップデーター を有効にする
pacman の代わりに組み込みのアップデータを使用して、すべての RetroArch コンポーネントをインストールする場合は、設定ファイルを使用して有効にすることができます:
~/.config/retroarch/retroarch.cfg
menu_show_core_updater = "true"
SaveRAM Autosave Interval の有効化
デフォルトでは、RetroArch はエラーなしで終了した場合のみ SRAM をディスクに書き込みます。つまり、クラッシュが発生しやすいコアを使用すると、セーブデータが失われるリスクがあります。この動作を変更するには、~/.config/retroarch/retroarch.cfg
を開いて、autosave_interval
に n を設定します。
~/.config/retroarch/retroarch.cfg
autosave_interval = "600"
上記の例では、RetroArch は SRAM の変更を600秒毎にディスクに書き込みます。
フィルターとシェーダー
RetroArch は BSNES XML filters と CG shaders をロードできます。これらはそれぞれ、retroarch.cfg
に video_bsnes_shader
と video_cg_shader
でそれぞれ設定されています。シェーダーは、オンラインアップデータを使用して、RetroArch 内で直接取得および更新することもできます。
設定をデフォルト値にリセットする
GUIを使用して、設定またはキーバインドをデフォルト値にリセットするには、ハイライト表示して、Start
を押します。キーバインドからボタンを削除するには、キーバインドをハイライト表示にして、Y
を押します。
トラブルシューティング
コアが見つかりません
デフォルトでは、RetroArch は ~/.config/retroarch/cores
内でコアを検索します。これは、Online Updater がコアをインストールする場所です。pacman でインストールされたコアは /usr/lib/libretro
に配置されるため、RetroArch の GUI には表示されません。コアのインストール方法(pacman または Online Updater)のいずれかを選択し、それに合わせて設定を変更する必要があります。
入力デバイスが使えない
RetroArch を CLI で実行したり Xorg 以外のディスプレイサーバーで実行すると問題が発生します。/dev/input
ノードは root だけがアクセスできるように制限されているためです。この問題は手動で KERNEL=="event*", NAME="input/%k", MODE="666"
という中身のルールを /etc/udev/rules.d/99-evdev.rules
に追加することで解決します。次を実行して udev ルールをリロードしてください:
# udevadm control --reload-rules
システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます:
# chmod 666 /dev/input/event*
ビデオパフォーマンスが悪い
ビデオパフォーマンスが低いのを補うために、~/.config/retroarch/retroarch.cfg
に video_threaded = true
と設定することで RetroArch を別のスレッドで実行することができます。
ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。
ALSA でのオーディオの問題
ALSA を使用する場合の audio_out_rate
は、システムのデフォルトの出力レートと一致させる必要があります。通常は、48000
です。
RetroArch がクラッシュするとセーブデータが失なわれる
#SaveRAM Autosave Interval の有効化 を参照してください。
プレイリストからゲームを開始したが、'No Items' と報告される
RetroArch が libretro core requires contents, but nothing provided
と報告する場合、Main Menu > Load Content から ROM のパスを手動で選択してゲームをロードしてみてください。playlist からゲームを開始するのは信頼性が低いようです。
RetroArch を Xwayland で強制的に起動する必要があります。
$ WAYLAND_DISPLAY="" retroarch
--verbose
オプションを使用してログを確認できますが、その際に "vk_wayland"
の代わりに Found vulkan context: "vk_x"
が表示されるはずです。
BIOS ファイルが見つからない、または認識されない
Retroarch のコアは、retroarch.cfg
内の system_directory
オプションで設定された場所に BIOS ファイルを探します。
GUI メニューの Settings > Directory > System/BIOS でもディレクトリが表示されます。
いくつかのコアは、ファイルをこのディレクトリに直接配置する必要があります。その他のコアは、特定の BIOS ファイルのために、このディレクトリ内に特定の名前のサブディレクトリが必要です。さらに、一部のコアは、実行しようとする ROM ファイルと同じディレクトリにファイルを探します。
インストールされている各コアは、必要なファイル、MD5 ハッシュ、および配置する必要があるディレクトリに関する情報を提供します。この情報は、GUI メニューの Settings > Core > Manage Core で確認できます。ここでコアを選択すると、この特定のコアに必要な BIOS ファイルに関する情報が表示されます。RetroArch は、コア情報ページでそれらを「ファームウェア」ファイルとして説明しています。
サポートされている多くのコアの BIOS ファイルに関する詳細な情報は、公式ドキュメントで確認できます。 [2]