OSR-VRChat

English Version

一个OSR机器人的驱动程序，实现了OSR机器人与VRChat的动作同步。

非常感谢Shocking-VRChat郊狼项目搭建的框架！

测试QQ群：1034983762

使用方法

准备工作

1. 确保攻方的牛牛和受方的插座都是基于SPS制作的（不支持DPS/TPS，因为这两个插件缺少用于计算深度的OGB数据接口）

2. 连接OSR2到电脑，打开OSR2的开关，Chrome浏览器打开Mosa控制器网页，左上角选择Serial并在弹窗中选择对应的串口

• 如图所示，请记住红框中的串口名字（通常是COM+一个数字）。拖动L0控制轴，测试并记住适合自己的最大值和最小值，并填到参数文件内。确保OSR设备工作正常，测试完必须关闭网页以解除串口占用

3. 确认VRChat中开启了OSC数据接口，确认模型的吸附功能已开启

参数设置

程序第一次运行时，会生成一个settings-advanced-vx.x.x.yaml的文件，包含了所有参数，点开即可修改。

以下为需要修改的参数：

objective：动作目标，下表为所有允许的取值及解释：

objective	解释
inserting_others	使用自己的插头插入别人的插座
inserting_self	使用自己的插头插入自己的插座（例如插自己的手，通常用作测试）
inserted_ass	自己位于肛门的插座被别人插入
inserted_pussy	自己位于小穴的插座被别人插入

请根据自己的使用情况，在设置文件填入对应的值

com_port：设备连接的串口，填入准备工作中记住的串口号（例如COM5）

OSR2的总移动范围为999个单位（和Mosa中一样）

max_position：移动位置上限，范围0-999

min_position：移动位置下限，范围0-999

max_velocity：速度上限（单位/秒）

updates_per_second：每秒更新次数

vrchat_max: VRChat中SPS数据实际的最大值

vrchat_min: VRChat中SPS数据实际的最小值

运行程序

1. 下载Releases中最新版的.exe文件，运行程序，第一次运行会生成设置文件并自动退出
2. 完成上面的流程，进行设备检查并正确设置参数
3. 再次运行程序，即可与VRChat同步。如果更改了参数，需要重启程序才能生效。
4. 浏览器打开127.0.0.1:8800，在VRChat里做出动作并观察Raw Level折线图的变化，如果变化范围太小，可以设置VRChat中SPS实际的最大最小值，程序会自动进行线性映射到0-1000之间，增加运动行程，加强使用体验。

Q&A

1. 什么是OSR？

OSR是Open-source Stroker Robot的缩写，意思是开源飞机杯机器人。目前此项目仅支持OSR2/2+，是OSR系列中最便携小巧的型号，支持2/3轴上的运动。未来也许会更新其他更复杂的机器人的支持。更多信息可以参考此网页。

2. 如何获取OSR2设备？

在闲鱼上有很多买成品设备和固定支架的商家，价格通常和舵机质量/扭矩以及包含的附件有关，可以根据自己的需求以及预算进行购买。如果想自己搭建OSR2系统，请参考此项目。

3. 什么是OGB？

OGB项目的全名是Osc Goes Brrr，实现了游戏中SPS插入动作和支持Intiface的玩具的同步。OGB的作者Senky也是SPS系统的作者，在SPS插件中预留了一系列地址为/avatar/parameters/OGB/*的OSC数据接口，大大方便了深度的计算。

可穿戴套装

物品清单

1. 2个可调节长短的魔术贴背带

• 可调长度在90-155cm为佳，宽度为5cm

2. 腰封

• 外圈固定腰带的宽度为5cm

3. 3D打印套件

• 请将wearable目录下的两个.stl文件发给代打印商家

4. 4个M4 10mm长的螺丝以及螺丝刀

安装方法

1. 把套件的上下两个部分安装到OSR2的底座，并固定到腰带上
2. 安装肩带，一端穿过套件的肩带环，另一端固定至腰带的背面
3. 调整腰带的位置，并尽量拉紧腰带
4. 背上肩带，安装杯子
5. 调整螺丝滑轨，确定杯子和腰带之间的最佳距离
6. 调整肩带的长度，选择最适合自己的角度
7. 连接OSR2至电脑

推荐链接

请参考wearable目录下的两个淘宝链接

更新计划

可能会增加一个图形界面，方便参数更改。