UxPlay macOS 快速安装与配置指南
本指南适用于在 macOS（Intel / Apple Silicon）上快速复现 UxPlay 投屏环境。
UxPlay 是一个开源的 AirPlay 服务端，可以让你的 Mac 接收 iPhone/iPad 的屏幕镜像投屏。
一、基础环境准备
首先确保安装了 Homebrew 和 Xcode Command Line Tools。
# 安装 Xcode 命令行工具
xcode-select --install
# 安装编译所需的依赖库
brew install cmake openssl@3 libplist二、安装 GStreamer（核心组件）
请勿使用 brew install gstreamer 安装 GStreamer，应使用官方 .pkg 安装包。
UxPlay 在 macOS 上依赖官方提供的 GStreamer 框架：
- 访问 GStreamer 官网下载页面
- 下载并安装以下两个文件（选择最新的 Stable Universal 版本）：
gstreamer-1.0-1.x.x-universal.pkg（Runtime）gstreamer-1.0-devel-1.x.x-universal.pkg（Development）
三、编译与安装 UxPlay
下载源码
访问 UxPlay GitHub Releases 页面，下载最新的 Source code (zip) 并解压。
编译
# 进入解压后的源码目录（请根据实际版本号替换路径）
cd ~/Downloads/UxPlay-<版本号>
# 编译
mkdir build && cd build
cmake ..
make安装到系统
# 安装到 /usr/local/bin/uxplay
sudo make install四、最佳实践配置
为了避免每次输入长命令，建议创建配置文件。
在终端执行：
nano ~/.uxplayrc写入以下推荐配置：
n Will的MacBook
vsync no
fps 60按 Ctrl+O 保存，Ctrl+X 退出。
五、常用运行指令
配置好 ~/.uxplayrc 后，只需在终端输入：
uxplay其他常用场景：
| 场景 | 命令 | 说明 |
|---|---|---|
| 带 PIN 码连接 | uxplay -pin | 防止他人误投屏 |
| 纯音频模式 | uxplay -a | 只接收音频流 |
| 后台清理 | killall uxplay | 程序卡死时使用 |
六、常见问题排查
搜不到设备
- 确保手机和 Mac 在同一 Wi-Fi 网络
- 检查 系统设置 → 网络 → 防火墙，确保允许
uxplay
报错 “libgstpython” 找不到
这是 GStreamer 的非必要插件警告，可安全忽略，不影响投屏功能。
画面延迟
- 确保配置中使用了
vsync no - 尽量使用 5GHz 频段的 Wi-Fi
Last updated on