#media-player #media #vlc #cross-platform #networking #api-bindings #utility

vlc-rc

用于与VLC播放器的TCP接口交互的库

2个版本

0.1.1 2022年5月24日
0.1.0 2022年5月23日

#21 in #media-player

MIT 协议

27KB
483


vlc-rc

一个rust库,用于与VLC播放器的TCP接口交互。

关于

这是一个(WIP)rust库,您可以使用它通过VLC的内置TCP接口以编程方式与VLC交互。

VLC的TCP接口没有很好地文档化,有时非常不可预测,这使得在确定性方式下测试变得极其困难。尽管如此,该库的目标是尽可能的 稳定可测试

要求

启用VLC接口。

有两种方法可以启用VLC的TCP接口。

选项1

您可以像这样使用CLI参数启动VLC

vlc --rc-host 127.0.0.1:9090 # Or any <host>:<port> you prefer!

选项2

您可以通过GUI启用它,每次启动VLC时都会运行。

  1. 启动VLC播放器。
  2. 在左上角的工具栏中,转到 工具 -> 首选项(Ctrl+P)
  3. 通过在首选项窗口左下角选择 所有 来启用“高级设置”。
  4. 向下滚动,直到您看到 接口 项,然后选择 主接口
  5. 在“额外接口模块”下方,选中 Lua解释器 选项。
  6. 然后点击左侧的列表中的 主接口 旁边的箭头,然后选择 Lua 项。
  7. 在顶部,将 Lua接口 字段的价值设置为 rc
  8. 在其下方,将 Lua接口配置 字段的价值设置为 rc={host='127.0.0.1:9090'}(或您喜欢的任何主机/端口)。
  9. 重启VLC播放器以在后台启动接口。

用法

将库添加为Cargo.toml的依赖项

[dependencies]
vlc-rc = "0.1.1

示例

use vlc_rc::Client;

let mut client = Client::connect("127.0.0.1:9090")?;

// Set the player's volume.
client.set_volume(25)?;
assert_eq!(client.get_volume()?, 25);

// Stop the track's playback.
client.stop()?;
assert_eq!(client.is_playing()?, false);

// Skip to the next track.
client.next()?;

贡献

查看CONTRIBUTING

依赖项

~2–3MB
~53K SLoC