SuperMDK用户手册

目录

一 综述

    1.软件包   
    2.包内容   

三、

     1.硬件包  

四、

    1. 使用方法 
    2. 准备工作 
    3. 设备连接 
    4. Arduino程序烧写  
    5. 正式工作 
    6. 运行结束后    

五、模型调整API

一、 综述
SuperMDK是哈工大MultiWorld团队开发的针对unity3d开发者使用的MDK(Motion capture Development Kit)。
硬件设备由一块树莓派,四块arduino uno以及7块MPU-6050传感器组成。

硬件传感部分数据经过封装呈现,在unity中可以直接使用。不介绍对应理论。

团队的目标是提供一种可以拖拽即使用的SDK,用最简单的方式开发体感应用,团队也认为这点在本文中得到了很好的体现。
二、 软件包

图 1 unity导入包

image.png

如图,引用包名为SuperMDK+版本号。

image.png

包内容

图 2 包主要内容

image.png

图 3 包主要内容

image.png
image.png

-增加下拉菜单MDK
-点击后分别跳转到该项目的帮助文档跟github网站

-Material 文件夹下包括模型使用的各种材料,在此可以替换模型和贴图使用开发者自定义的材料选项。
-scene 文件夹下包括了开发包提供的基础场景,场景中有项目的模型和可以更改的选项。(下文有具体内容)。
-scripts 文件夹下是包中运用的各种脚本(unity默认的C#文件)。
{
Fpstest.cs 文件是默认执行fps统计脚本,将脚本实时显示出来。
testUdp.cs 文件是UDP广播接收端执行脚本,是实例化UDPclient数据接收所依赖的父类。
Rightarm.cs是模型驱动脚本,文件中包括了参数矫正、滤波等内容。
}

图 4 man 场景下内容
Main Carema 是主摄像头。
Directional Light 是方向光源,为场景提供灯光。
Man 是实例模型,开发者可以通过改变脚本来改变模型对应关系。
Canvas 是画布,默认UI组件在此执行。
EventSystem 是时间收集器,收集工作方案工作中事件问题。
UDP 是空类,执行TestUp文件,实例化UDP广播接收端。
FPStest同样是空类,执行FPSTest文件,实例化FPS测试类。

图 5 包导入后unity视图
三、 硬件包
硬件组成中,Arduino uno负责读取MPU-6050 模块数据,通过串口发送到树莓派当中。
树莓派接受数据后进行预处理并通过UDP广播形式发送到局域网内。理论上局域网内任何终端(windows、android等设备)通过app应用可以查看到对应模型动态状态。
四、 使用方法
准备工作
设备连接
MPU1:arduino1
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4

MPU2:arduino1
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4
AD0 : 3.3V

MPU3:arduino2
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4

MPU4:arduino2
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4
AD0 : 3.3V

MPU5:arduino3
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4

MPU6:arduino3
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4
AD0 : 3.3V

MPU7:arduino4
Vcc :3.3v
GND :GND
SCL :A5
SDA :A4
Arduino程序烧写
Arduino程序在您拿到手中时已经烧写进板子中,可以直接使用。需要将arduino和树莓派通过USB线连接

正式工作
将树莓派和开发的电脑连接到同一个局域网内。
在树莓派上启动终端
输入命令:

本树莓派自带 openser.sh 脚本
./openser.sh
#或者手动开启Arduino 的串口
sudo chmod 777 /dev/ttyUSB*
#或者
sudo chmod 777 /dev/ttyACM*

继续输入命令:

python udpargs.py  /dev/ttyUSB0  /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3 

运行UDP程序。

image.png

程序注解:四个参数分别代表了四个Arduino
运行程序,开始UDP广播。
为了开发者调试方便,我们将传送的数据打印在终端上,以便开发者对数据进行监测

回到unity当中
双击打开man场景

image.png

图 8 unity运行
点击运行键开始运行unity端程序

图 9 开始运行截图

  • 开始连接 点击开始连接,unity将开始接受UDP广播内容??即?/li>
  • 暂停连接,为了调试参数,预留的功能,可以暂停连接
  • 继续连接,调整后可以继续开始连接。


    image.png

    注:socket 端口只能初始化一次,请记住只能点击开始链接一次。

运行结束后
我们需要对服务器进行关闭,执行关闭服务器程序代码:

python closeser.py

至此,一次完整的调试过程结束。

五、 模型调整API

image.png

Element0-6 代表了一个模型的7个活动关节:
0:leftForeArm
1:LeftArm
2:RightForeArm
3:RightArm
4:LeftUpleg
5:RightUpleg
6:Head
Socket 代表了挂载testudp.cs 脚本的游戏物体
BodyAssembly.cs脚本API :

        //默认构建函数,定义初始值
    public BodyAssembly(GameObject gameobject) ;
//定义默认初始角
public void getDefault();
//获取基本旋转角
    public void getRotation(float[] fRotation);
//获取与初始脚的差值
    public void getMinus();
//转动方法
    public void RotateArm(GameObject gameobject);
    public void RotateLeg(GameObject gameobject);
    public void RotateLeg(GameObject gameobject);

六、结束语

SuperMDK在考量了成本问题后,提供了以上的方法解决成本问题,团队也尽可能的降低使用MDK的团队的学习成本,目前基本实现拖拽即编程的目标,使零学习成本、低学习成本开发体感游戏成为可能。
团队也将加快研发和维护进度,提供更完善的平台和技术。
也欢迎更多团队帮助宣传和使用我们的产品。
联系方式:liaoboo323@outlook.com
github地址

最后编辑于
?著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,029评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,238评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事?!?“怎么了?”我有些...
    开封第一讲书人阅读 159,576评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,214评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,324评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,392评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,416评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,196评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,631评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,919评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,090评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,767评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,410评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,090评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,328评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,952评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,979评论 2 351

推荐阅读更多精彩内容