如何用 Go 实现跨平台屏幕录制pion/mediadevices 屏幕采集实战指南Linux/macOS/Windows【免费下载链接】mediadevicesGo implementation of the MediaDevices API.项目地址: https://gitcode.com/gh_mirrors/me/mediadevicesmediadevices是浏览器 MediaDevices API 的 Go 语言实现也是目前用 Go 做屏幕录制最省心的选择它把摄像头、麦克风和屏幕采集统一抽象成一套简单 API你不需要关心各平台底层差异一行GetDisplayMedia就能在 Linux、macOS、Windows 上拿到屏幕画面帧。本文带你从零完成一次跨平台屏幕录制安装依赖、采集屏幕、按需编码成视频文件。为什么选 mediadevices 做跨平台屏幕录制自己写屏幕录制Linux 要接 X11macOS 要接 CoreGraphics 还要处理系统权限Windows 又是另一套 API。mediadevices 用驱动Driver 注册的模型把这一切屏蔽了一份代码三大平台屏幕、摄像头、麦克风在 Linux / Mac / Windows 上全部支持极简 API约束式接口MediaStreamConstraints决定分辨率、帧率等其余交给库自动挑选驱动编码器自由切换x264、openh264、vpxVP8/VP9、svtav1 等按需导入可插拔架构没有物理设备时还能注册虚拟驱动如 examples/vnc 的 VNC 远程屏幕源方便测试与无头服务器场景。 屏幕采集工作原理统一驱动模型理解一张图就够了——每个设备驱动包括屏幕采集驱动都会经历如下状态流转注册Registerimport _ .../pkg/driver/screen这种副作用导入会触发init()把每个显示器注册为一个驱动。主显示器索引 0优先级更高多显示器时默认选它见 pkg/driver/screen/screen.go。发现Discovery调用GetDisplayMedia时驱动管理器打开所有已注册驱动、读取各自能力分辨率、像素格式按你的约束挑选最合适的一个。录制Running被选中的驱动开始按帧产出画面标准的image.Image可直接配合标准库image/jpeg等使用。释放Close关闭 track 后驱动回到 Closed 状态资源归还。不同平台的具体实现在 pkg/driver/screen/ 目录平台底层实现相关文件说明LinuxX11x11_linux.go、x11capture_linux.go仅支持 X11需设置DISPLAYmacOSscreenshot 库screen.go需要授予屏幕录制权限Windowsscreenshot 库screen.go支持多显示器默认主屏优先 快速开始三平台一行代码启动屏幕录制一键安装步骤安装 Go 环境后拉取代码或直接引入模块git clone https://gitcode.com/gh_mirrors/me/mediadevices # 或 go get -u github.com/pion/mediadevices注册屏幕驱动并读取屏幕帧完整的屏幕采集示例如下核心就 3 步导入驱动 →GetDisplayMedia→ 读帧package main import ( image/jpeg os github.com/pion/mediadevices // 副作用导入注册屏幕采集驱动多显示器会逐个注册 _ github.com/pion/mediadevices/pkg/driver/screen ) func main() { // 注意屏幕采集要用 GetDisplayMedia不是 GetUserMedia stream, _ : mediadevices.GetDisplayMedia(mediadevices.MediaStreamConstraints{}) track : stream.GetVideoTracks()[0].(*mediadevices.VideoTrack) defer track.Close() // 逐帧读取屏幕画面标准 image.Image reader : track.NewReader(false) for { frame, release, err : reader.Read() if err ! nil { break } // 例如把某一帧存成图片 f, _ : os.Create(screen.jpg) jpeg.Encode(f, frame, nil) f.Close() release() } }几个要点分辨率默认采集整个显示器像素格式为 RGBA。可通过MediaStreamConstraints里的Width/Height约束缩放Linux 上未指定帧率时默认为 10 fpsbuffer 复用release()会把帧缓冲区还给驱动池循环读取时务必调用多显示器驱动以显示器索引为标签注册约束里指定DeviceID即可选中特定屏幕。各平台注意事项Linux需运行在 X11 会话Wayland 暂不支持且进程能访问$DISPLAYmacOS首次运行需在「系统设置 → 隐私与安全性 → 屏幕录制」中授权你的终端/应用否则画面全黑Windows开箱即用无需额外系统依赖。 进阶把录屏存成 H264 视频文件屏幕帧是原始像素直接存文件体积很大。mediadevices 通过编码器选择器CodecSelector一行接入压缩编码以 x264 为例x264Params, _ : x264.NewParams() x264Params.Preset x264.PresetMedium x264Params.BitRate 1_000_000 // 1 Mbps codecSelector : mediadevices.NewCodecSelector( mediadevices.WithVideoEncoders(x264Params), ) // 把 codecSelector 传入 MediaStreamConstraints 的 Codec 字段即可常用视频编码器及系统库安装方式编码器格式安装适合场景x264H.264apt install libx264-dev/brew install x264通用兼容性好openh264H.264无需安装内置静态库不想装系统库时vpxVP8/VP9apt install libvpx-devWebRTC 场景svtav1AV1apt install libsvtav1enc-dev追求编码效率把录制的 H264 流写成 mp4 的完整思路可参考 examples/archive/main.go摄像头版本把屏幕驱动换成pkg/driver/screen即可复用若想把录屏实时推给浏览器或远端可看 examples/http/main.goMJPEG 广播与 examples/webrtc/main.goWebRTC 实时传输。️ 常见问题速查❓ 报错failed to find the best driver that fits the constraints99% 是因为屏幕采集用了GetUserMedia。屏幕驱动必须搭配GetDisplayMedia使用且确认已做import _ github.com/pion/mediadevices/pkg/driver/screen。❓ 编译时报pkg-config找不到 vpx/x264mediadevices 通过 cgo pkg-config 查找系统编码库按上表安装对应开发库即可路径不标准时用export PKG_CONFIG_PATH/path/to/directory指明。❓ 交叉编译时缺麦克风依赖可加构建标签go build -tags nomicrophone去掉麦克风支持方便纯录屏场景的交叉编译。❓ 无显示器的服务器怎么录注册 VNC 驱动pkg/driver/vncdriver/即可把远程桌面的画面当作一路视频源配合 examples/vnc/main.go 通过 WebRTC 推流。总结目标关键动作三平台录屏import _ .../pkg/driver/screenGetDisplayMedia控制分辨率/帧率MediaStreamConstraints约束存成视频文件CodecSelector 接入 x264/openh264 等编码器远程/无头录屏注册 VNC 驱动作为视频源mediadevices 的价值在于把屏幕录制这件事从三套平台 API 收敛成一次GetDisplayMedia调用——剩下的分辨率、编码器、驱动选择都交给它自动完成是 Go 生态里做跨平台媒体采集的高性价比起点。【免费下载链接】mediadevicesGo implementation of the MediaDevices API.项目地址: https://gitcode.com/gh_mirrors/me/mediadevices创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何用 Go 实现跨平台屏幕录制：pion/mediadevices 屏幕采集实战指南（Linux/macOS/Windows）
如何用 Go 实现跨平台屏幕录制pion/mediadevices 屏幕采集实战指南Linux/macOS/Windows【免费下载链接】mediadevicesGo implementation of the MediaDevices API.项目地址: https://gitcode.com/gh_mirrors/me/mediadevicesmediadevices是浏览器 MediaDevices API 的 Go 语言实现也是目前用 Go 做屏幕录制最省心的选择它把摄像头、麦克风和屏幕采集统一抽象成一套简单 API你不需要关心各平台底层差异一行GetDisplayMedia就能在 Linux、macOS、Windows 上拿到屏幕画面帧。本文带你从零完成一次跨平台屏幕录制安装依赖、采集屏幕、按需编码成视频文件。为什么选 mediadevices 做跨平台屏幕录制自己写屏幕录制Linux 要接 X11macOS 要接 CoreGraphics 还要处理系统权限Windows 又是另一套 API。mediadevices 用驱动Driver 注册的模型把这一切屏蔽了一份代码三大平台屏幕、摄像头、麦克风在 Linux / Mac / Windows 上全部支持极简 API约束式接口MediaStreamConstraints决定分辨率、帧率等其余交给库自动挑选驱动编码器自由切换x264、openh264、vpxVP8/VP9、svtav1 等按需导入可插拔架构没有物理设备时还能注册虚拟驱动如 examples/vnc 的 VNC 远程屏幕源方便测试与无头服务器场景。 屏幕采集工作原理统一驱动模型理解一张图就够了——每个设备驱动包括屏幕采集驱动都会经历如下状态流转注册Registerimport _ .../pkg/driver/screen这种副作用导入会触发init()把每个显示器注册为一个驱动。主显示器索引 0优先级更高多显示器时默认选它见 pkg/driver/screen/screen.go。发现Discovery调用GetDisplayMedia时驱动管理器打开所有已注册驱动、读取各自能力分辨率、像素格式按你的约束挑选最合适的一个。录制Running被选中的驱动开始按帧产出画面标准的image.Image可直接配合标准库image/jpeg等使用。释放Close关闭 track 后驱动回到 Closed 状态资源归还。不同平台的具体实现在 pkg/driver/screen/ 目录平台底层实现相关文件说明LinuxX11x11_linux.go、x11capture_linux.go仅支持 X11需设置DISPLAYmacOSscreenshot 库screen.go需要授予屏幕录制权限Windowsscreenshot 库screen.go支持多显示器默认主屏优先 快速开始三平台一行代码启动屏幕录制一键安装步骤安装 Go 环境后拉取代码或直接引入模块git clone https://gitcode.com/gh_mirrors/me/mediadevices # 或 go get -u github.com/pion/mediadevices注册屏幕驱动并读取屏幕帧完整的屏幕采集示例如下核心就 3 步导入驱动 →GetDisplayMedia→ 读帧package main import ( image/jpeg os github.com/pion/mediadevices // 副作用导入注册屏幕采集驱动多显示器会逐个注册 _ github.com/pion/mediadevices/pkg/driver/screen ) func main() { // 注意屏幕采集要用 GetDisplayMedia不是 GetUserMedia stream, _ : mediadevices.GetDisplayMedia(mediadevices.MediaStreamConstraints{}) track : stream.GetVideoTracks()[0].(*mediadevices.VideoTrack) defer track.Close() // 逐帧读取屏幕画面标准 image.Image reader : track.NewReader(false) for { frame, release, err : reader.Read() if err ! nil { break } // 例如把某一帧存成图片 f, _ : os.Create(screen.jpg) jpeg.Encode(f, frame, nil) f.Close() release() } }几个要点分辨率默认采集整个显示器像素格式为 RGBA。可通过MediaStreamConstraints里的Width/Height约束缩放Linux 上未指定帧率时默认为 10 fpsbuffer 复用release()会把帧缓冲区还给驱动池循环读取时务必调用多显示器驱动以显示器索引为标签注册约束里指定DeviceID即可选中特定屏幕。各平台注意事项Linux需运行在 X11 会话Wayland 暂不支持且进程能访问$DISPLAYmacOS首次运行需在「系统设置 → 隐私与安全性 → 屏幕录制」中授权你的终端/应用否则画面全黑Windows开箱即用无需额外系统依赖。 进阶把录屏存成 H264 视频文件屏幕帧是原始像素直接存文件体积很大。mediadevices 通过编码器选择器CodecSelector一行接入压缩编码以 x264 为例x264Params, _ : x264.NewParams() x264Params.Preset x264.PresetMedium x264Params.BitRate 1_000_000 // 1 Mbps codecSelector : mediadevices.NewCodecSelector( mediadevices.WithVideoEncoders(x264Params), ) // 把 codecSelector 传入 MediaStreamConstraints 的 Codec 字段即可常用视频编码器及系统库安装方式编码器格式安装适合场景x264H.264apt install libx264-dev/brew install x264通用兼容性好openh264H.264无需安装内置静态库不想装系统库时vpxVP8/VP9apt install libvpx-devWebRTC 场景svtav1AV1apt install libsvtav1enc-dev追求编码效率把录制的 H264 流写成 mp4 的完整思路可参考 examples/archive/main.go摄像头版本把屏幕驱动换成pkg/driver/screen即可复用若想把录屏实时推给浏览器或远端可看 examples/http/main.goMJPEG 广播与 examples/webrtc/main.goWebRTC 实时传输。️ 常见问题速查❓ 报错failed to find the best driver that fits the constraints99% 是因为屏幕采集用了GetUserMedia。屏幕驱动必须搭配GetDisplayMedia使用且确认已做import _ github.com/pion/mediadevices/pkg/driver/screen。❓ 编译时报pkg-config找不到 vpx/x264mediadevices 通过 cgo pkg-config 查找系统编码库按上表安装对应开发库即可路径不标准时用export PKG_CONFIG_PATH/path/to/directory指明。❓ 交叉编译时缺麦克风依赖可加构建标签go build -tags nomicrophone去掉麦克风支持方便纯录屏场景的交叉编译。❓ 无显示器的服务器怎么录注册 VNC 驱动pkg/driver/vncdriver/即可把远程桌面的画面当作一路视频源配合 examples/vnc/main.go 通过 WebRTC 推流。总结目标关键动作三平台录屏import _ .../pkg/driver/screenGetDisplayMedia控制分辨率/帧率MediaStreamConstraints约束存成视频文件CodecSelector 接入 x264/openh264 等编码器远程/无头录屏注册 VNC 驱动作为视频源mediadevices 的价值在于把屏幕录制这件事从三套平台 API 收敛成一次GetDisplayMedia调用——剩下的分辨率、编码器、驱动选择都交给它自动完成是 Go 生态里做跨平台媒体采集的高性价比起点。【免费下载链接】mediadevicesGo implementation of the MediaDevices API.项目地址: https://gitcode.com/gh_mirrors/me/mediadevices创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考