📖 本文由 Batocera 官方 Wiki 翻译整理，内容可能随版本更新而变化。

Wi-Fi

虽然 Batocera 可以完美离线运行，但将其连接到互联网可以开启[[:updates_and_downloads|更多]][[:add_games_bios#the_network_share|精彩]][[:es-webserver|功能]][[:ai_game_translation|和]][[:scrape_from|体验]]。以太网线提供最佳的连接质量（尤其是对于[[:netplay|联机游戏]]），但 Wi-Fi 也是可用的替代方案。

Batocera //应该//支持大多数普通 PC 的内置和 PCI-e Wi-Fi 模块，但较新的型号可能不太可能开箱即用。[[hardware:compatible_dongle_list|点击此处查看已知兼容的 USB Wi-Fi 适配器列表]]。

Wi-Fi 设置

以太网会自动连接和配置，但 Wi-Fi 并非如此。需要一些手动操作。

首先，通过进入 主菜单 -> 网络设置 -> 启用 Wi-Fi 来激活 Wi-Fi（关闭 Wi-Fi 对于使用电池供电的[[:choose_a_handheld|手持]][[:handheld_pc|设备]]可能很有用）。

等待片刻，让 Wi-Fi 芯片实际打开并开始扫描（某些设备可能需要完全重启）。然后，所有可用的 Wi-Fi 接入点将显示在列表中。

从 EmulationStation 菜单中，您只能配置一个 Wi-Fi 连接。如果直接编辑 ”Batocera.conf”，则可以配置最多三个连接。

手动 SSID

如果接入点未出现在列表中（或者您的路由器设置中隐藏了 SSID），可以通过点击 ”手动输入” 来手动定义 SSID。

SSID 区分大小写。对于 SSID 和密码，特殊字符需要用反斜杠（”\”）转义。例如，如果密码是 ”special?characters@*”，则输入的密码应为 ”special\?characters\@*”。您也可以直接在 ”Batocera.conf” 文件中编辑这些字段。

连接成功后，Wi-Fi 图标将出现在屏幕右上角（某些主题可能会重新定位此图标）。

{{ ::wifi_connected.png?600 |}}

命令行选项

WIP

通过 [[:access_the_batocera_via_ssh|SSH 或本地终端]] 访问 Batocera 来运行这些命令。您可以使用以太网电缆进行 SSH 连接，或者如果没有网络可用，则直接在 Batocera 机器上运行本地终端。


Batocera-wifi start 开启所有可用的 Wi-Fi 模块。
Batocera-wifi scanlist 列出范围内所有可用的 Wi-Fi。
Batocera-wifi list 列出所有已保存的 Wi-Fi 配置。
Batocera-wifi enable 连接到指定的 Wi-Fi 并保存。
Batocera-wifi disable 关闭所有 Wi-Fi 模块。


故障排除

Wi-Fi 不工作

激活 Wi-Fi 后，可能需要一段时间才能实际激活。事实上，可能直到系统重启后才会激活。Linux 的力量！重启后再试。或许值得在主菜单上等待大约十秒左右再进入 Wi-Fi 菜单。

也可能是您的 Wi-Fi 芯片组需要 Batocera 中未包含的特定驱动程序。请查看[[#how_to_manually_add_drivers_(advanced)|下文关于如何操作的部分]]。

我在列表中看不到我的 SSID，但能看到邻居的

您使用的运行 Batocera 的设备可能与路由器设置的频道不兼容。

例如，Raspberry Pi 系列著名地不支持 2.4GHz Wi-Fi 的 13 频道。

可以在 ”Batocera.conf” 中通过添加 ”wifi.country” 键并将其设置为您所在国家/地区的代码来更改[[https://openwrt.org/docs/guide-user/network/wifi/wifi_countrycode|country region]]。例如：”wifi.country=US”。

如果您不知道您国家的代码怎么办？使用此列表中的 Alpha-2 code：https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

我的 Wi-Fi 很慢/卡顿！

最好的建议是…不要使用 Wi-Fi。使用以太网线缆，尤其是如果您想做对延迟敏感的事情，如 [[:netplay|Netplay]] 或 [[systems:moonlight|游戏串流]]。在我们生活的现代高科技世界中，空气中充斥着大量无线噪音，想要获得稳定、无延迟的 Wi-Fi 信号是不切实际的。即使您就坐在路由器旁边不到几英尺远的地方，也未必…

但如果您的情况绝对需要使用 Wi-Fi，这里有一些建议：

• 关闭尽可能多的其他 Wi-Fi 设备，包括您的手机、智能恒温器、冰箱等。
• 关闭任何会产生大量干扰的大型机械设备，如内燃机、发电机、UPS、微波炉等。

• 如果使用 2.4 GHz Wi-Fi（大多数路由器的”默认”设置），确保没有使用任何 USB 3.0 设备，因为[[https://superuser.com/questions/1282590/why-does-USB-3-0-interfere-with-2-4ghz-devices|它们会造成直接干扰]]。

• 尽量保持与路由器的直线视距。如果因为墙壁阻挡而无法做到，请尽量减少设备和路由器之间的障碍物数量。

• 通常，将路由器放置在离地面很高的地方是最好的，因为天花板上通常比地板上少。
• 这一点尤其适用于金属或完全平面的物体，因为它们会反射信号，导致更强的干扰。
• 优化路由器的设置。可以包括启用 Quality of Service (QoS)、Smart Queue Management (SQM) 等功能。
• 通常只有现代高端路由器才支持这些功能，因为它们比普通网络需要更多的 CPU 性能。如果您的路由器支持在其上安装 [[https://openwrt.org/|OpenWRT]]，它可能也支持此设置。
• 如果您的设备有其他无线接口，例如 Bluetooth 或内部 Wi‑Fi（并且您正在使用 USB dongle），请将它们关闭。
• 尤其是当您只有 2.4 GHz Wi‑Fi 时，因为这与 Bluetooth 的工作频率相近。

您可以通过在 ”/boot/config.txt” 中添加 ”dtoverlay=disable-wifi” 来禁用 Raspberry Pi 4 的板载 Wi‑Fi。

如何手动添加驱动程序（高级）

大多数网络设备已经得到 Batocera 所包含的 Linux 内核的支持。但在极少数情况下（例如最新的硬件），驱动可能尚未包含。如果制造商提供了预编译的二进制驱动文件，则可以手动安装它们。

如果您的网络/Wi-Fi设备提示需要某些二进制固件文件（使用dmesg通过终端检查），您可以将它们放入/lib/firmware/rtlwifi/，确认工作正常后运行Batocera-save-overlay。

Wi-Fi设备在dmesg中提示缺少二进制固件文件的示例：

[ X.XXXXXXX ] Wi-Fi: xxx0: RTL: firmware file rtlwifi/XXXXXXXXXX.bin not found

如果您完成了上述操作且成功生效，请告知开发团队，以便将其添加到下一个版本的Batocera中。

我遇到的是可能与Wi-Fi无关的一般网络问题

请参阅[[:network_issues|网络问题页面]]。

原文: WiFi连接设置教程 • 翻译: DIY8 Bot