Skip to content

协议参考

本节列出 mpv 支持的所有协议。

文件协议

本地文件

bash
# 本地文件
mpv video.mp4
mpv /path/to/video.mp4

# 相对路径
mpv ./video.mp4
mpv ../video.mp4

文件 URL

bash
# 文件 URL
mpv file:///path/to/video.mp4

# Windows 文件 URL
mpv file:///C:/path/to/video.mp4

网络协议

HTTP/HTTPS

bash
# HTTP 流
mpv http://example.com/video.mp4

# HTTPS 流
mpv https://example.com/video.mp4

RTSP/RTMP

bash
# RTSP 流
mpv rtsp://example.com/stream

# RTMP 流
mpv rtmp://example.com/live/stream

HLS (HTTP Live Streaming)

bash
# HLS 流
mpv https://example.com/stream.m3u8

DASH (Dynamic Adaptive Streaming over HTTP)

bash
# DASH 流
mpv https://example.com/manifest.mpd

平台协议

YouTube

bash
# YouTube 视频
mpv https://www.youtube.com/watch?v=VIDEO_ID

# YouTube 播放列表
mpv https://www.youtube.com/playlist?list=PLAYLIST_ID

# YouTube 直播
mpv https://www.youtube.com/watch?v=LIVE_VIDEO_ID

Bilibili

bash
# Bilibili 视频
mpv https://www.bilibili.com/video/BV1xx411c7mD

# Bilibili 直播
mpv https://live.bilibili.com/ROOM_ID

Twitch

bash
# Twitch 直播
mpv https://www.twitch.tv/username

# Twitch 视频
mpv https://www.twitch.tv/videos/VIDEO_ID

Vimeo

bash
# Vimeo 视频
mpv https://vimeo.com/123456789

光盘协议

DVD

bash
# DVD 播放
mpv dvd://1

# 指定 DVD 设备
mpv dvd://1 --dvd-device=/dev/sr0

蓝光

bash
# 蓝光播放
mpv bd://1

# 指定蓝光设备
mpv bd://1 --bd-device=/dev/sr0

特殊协议

EDL (Edit Decision List)

bash
# EDL 播放
mpv edl://file1.mp4;file2.mp4

# EDL 时间范围
mpv edl://!no_clip,file1.mp4;!no_clip,file2.mp4

内存协议

bash
# 内存播放
mpv memory://data

标准输入

bash
# 标准输入
mpv -
cat video.mp4 | mpv -

协议选项

HTTP 选项

bash
# HTTP 超时
network-timeout=60

# HTTP 头
http-header-fields="Referer: https://example.com"

# HTTP Cookies
cookies=yes
cookies-file=~/.config/mpv/cookies.txt

RTSP 选项

bash
# RTSP 传输
rtsp-transport=tcp
rtsp-transport=udp

# RTSP 端口
rtsp-port=554

HLS 选项

bash
# HLS 线程数
hls-segment-threads=4

# HLS 优先级
hls-bitrate=max

协议调试

调试信息

bash
# 显示协议信息
mpv --msg-level=all=v https://example.com/video.mp4

# 测试协议
mpv --network-timeout=10 https://example.com/video.mp4

协议测试

bash
# 测试 HTTP
mpv --network-timeout=10 http://example.com/video.mp4

# 测试 RTSP
mpv --rtsp-transport=tcp rtsp://example.com/stream

协议故障排除

常见问题

  1. 连接超时

    • 增加超时时间:network-timeout=120
    • 检查网络连接
  2. 协议不支持

    • 检查协议支持:mpv --list-protocols
    • 尝试其他协议
  3. 认证失败

    • 检查认证配置
    • 使用 Cookies:cookies=yes

调试命令

bash
# 显示协议信息
mpv --msg-level=all=v https://example.com/video.mp4

# 列出支持的协议
mpv --list-protocols

下一步