CavePlayer中控技术文档 2025年2月

中控指令都约定为4个字符，使用UDP和串口直接发送这4个字符就可以了。TCP协议使用短连接，每次发送前需要先建立TCP连接，发送指令后断开连接。

使用UDP协议时支持同时发送多个指令，比如希望同时执行“停止播放视频”、“开启桌面融合”、“切换配置到配置一”，可以三个指令同时发送STOPDESKCFG1

播放列表中的“控制指令”就是这个视频的播放指令，发送这个指令就可以播放对应的视频。比如sample.wmv的“控制指令”为“0001”，那么发送“0001”这4个ASCII字符就可以播放sample.wmv。

如果启用了同步播放，只需要向主屏发送这个指令，所有主机中拥有相同“控制指令”的视频会同步播放。

C# udp代码示例：

string ip = "192.168.0.2";
int port = 9001;
string cmd = "0001";
byte[] buf = Encoding.UTF8.GetBytes(cmd);
Socket socketudp = new Socket(AddressFamily.Internetwork, SocketType.Dgram, ProtocolType.Udp);
EndPoint ep = new IPEndPoint(IPAddress.Parse(ip), port);
socketudp.SendTo(buf, ep);

暂停指令：PAUE，发送暂停指令相当于点击暂停按钮
继续播放指令：PLAY，发送继续播放指令相当于点击播放按钮
停止指令：STOP，发送停止指令相当于点击停止按钮
暂停或继续指令：PAUS，如果正在播放，它表示暂停；如果在暂停中，它表示继续

在勾选了“中控及播放列表”后，会从“默认视频”开始播放。

每个视频播放结束后，会执行“结束动作”，“结束动作”在播放列表中使用右键菜单设置，每个视频的结束动作可以分别设置。结束动作有以下几个选项：

黑屏：在列表中显示为“Black”，播放结束后显示黑屏。
重播：在列表中显示为“Replay”，播放结束后重头播放这个视频。
播放下一个：在列表中显示为“Next”，播放结束后按顺序播放列表中的下一个视频，如果当前是最后一个视频，会播放列表中的第一个视频。注意这里会跳过默认视频，就是说默认视频在“播放下一个”的过程中不会被播放，会跳过它播放下一个视频。
播放默认：在列表中显示为“PlayDef”，播放结束后播放默认视频。
隐藏：在列表中显示为“Hide”，播放结束后停止播放并且隐藏大屏窗口，显示桌面

直接发送视频在播放列表中的控制指令就可以切换不同的视频，除此之外还有几个指令可以切换视频。
播放下一个指令 NEXT：切换到播放列表中的下一个视频。
播放上一个指令 PREV：切换到播放列表中的上一个视频。
播放默认视频指令 PLDF：切换到默认视频，效果与直接发送默认视频的控制指令相同。

使用进度条可以定位视频，即使是多主机同步播放的时候也可以定位。

使用中控指令也可以定位视频。

视频向前进方向跳转指令JXXX：视频向前进方向跳转XXX秒，比如发送J060表示向前进方向跳转60秒，用此功能可以模拟快进功能。

视频向后退方向跳转指令LXXX：视频向后退方向跳转XXX秒，比如发送L060表示向后退方向跳转60秒，用此功能可以模拟后退功能。

音量增大指令：VOL+或者VOLU
音量减小指令：VOL- 或者VOLD
设置音量值指令：VXXX，XXX是音量值，从000到100
在同步播放时只改变主屏的音量

隐藏大屏窗口指令：HIDE
显示大屏窗口指令：SHOW
在同步播放时会同步隐藏和显示所有主机的大屏窗口

切换到默认配置：CFG0
切换到配置一：CFG1
切换到配置二：CFG2
切换到配置三：CFG3

高级中控是2024年8月新增加的中控协议，可以查询系统音量、播放状态和进度，可以精确控制播放进度。查询指令需要使用TCP协议，部分指令需要使用16进制。

查询当前音量指令：VOLQ（需要使用TCP协议）
服务器收到指令后会向客户端发送当前音量值，用4个字符表示，最小：0000 最大：0100

查询当前播放状态指令：16进制80000000（需要使用TCP协议）
服务器收到指令后会向客户端发送当前播放状态和进度，服务器在发送完查询结果后会主动断开连接。格式：

状态，当前位置，视频长度

状态为NOVIDEO、PLAYING、STOPPED或PAUSED
当状态为PLAYING或PAUSED时，当前位置和视频长度有效，单位是0.1秒
如：PLAYING,100,300表示当前正在播放，播放到10秒，视频总长30秒

精确跳转指令：16进制81XXXXXX（UDP、串口、TCP均可）
XXXXXX是播放位置，单位0.1秒

---