MojingSDK for Unity3D 接口说明文档
北京暴风魔镜科技有限公司
2016-06
版本Version 日期
Data
作者
Author
注释
Comments
1.3 2016.6.6 罗敏1、IOS平台发布设置，Home键在右；
2、不再支持Unity5.1及以下版本；
3、增加魔镜5代、RIO镜片支持；
1.3 2016-06-21 刘满松1、支付相关接口增加错误详情回调void MjFailedDetailsCallback(string json) 2、支付确认页面增加取消按钮的回调
1.3 2016-06-23 罗敏1、增加Unity_IOS Metal选项的支持；
2、增加对Unity5.3.5的支持；
法律声明
本文档包含的所有内容除特别声明以外，版权均属于北京暴风魔镜科技有限公司所有。未经本公司书面许可，任何单位和个人不得以任何方式（电子机械，包括影印）翻印或转载本文档的任何部分，否则将视为侵权，追究法律责任。
一、简介 (5)
二、开发环境 (5)
1、Windows 平台发布 (5)
2、Android平台发布 (5)
3、iOS平台发布 (6)
三、支持的设备 (6)
1、支持的眼镜及镜片 (6)
2、支持的蓝牙手柄 (7)
四、SDK包介绍 (7)
1、Unity3D版本要求 (7)
2、导入SDK开发包 (8)
3、SDK示例场景 (8)
4、Plugins文件夹 (13)
5、StreamingAssets文件夹 (13)
五、SDK功能模块 (14)
1、陀螺仪头部跟踪 (14)
2、图像抗镜片畸变 (16)
3、魔镜蓝牙手柄适配及交互控制 (20)
4、信息统计报数 (24)
5、注册、登录、消费接口 (27)
6、使用用户自定义参数功能 (33)
7、角色控制器 (34)
六、应用程序发布 (37)
1、Windows(X64) Application 发布 (37)
2、Android Application发布 (38)
3、iOS Application发布 (39)
七、总结 (39)
附录 (40)
1、手柄配置文件详细说明 (40)
一、简介
MojingSDK for Unity3D（下文简称SDK）是为了配合Unity3D软件开发者开发适用于VR眼镜（包括但不限于暴风魔镜公司出品的眼镜）而推出的SDK（Software Development Kit）开发包。开发包主要从手机陀螺仪获取头部跟踪数据、校正静态偏置值，图像抗镜片畸变、蓝牙手柄适配及交互性操作等方面为开发者提供便利性支持。SDK采用Unity3D的标准unitypackage包格式发布，同时支持Windows(X64)平台、Android平台和iOS平台发布。
二、开发环境
1、Windows 平台发布
SDK开发环境为Unity5.2.2(Win 64bit)，提供64位库，采用OpenGL2渲染绘制，支持双眼反畸变渲染，键盘鼠标模拟头部Camera旋转，以及Unity原生Input作为交互。开发者在导入unitypackage之前，需将Unity 图形API设为OpenGL2，如图22所示。
2、Android平台发布
SDK开发环境为Unity3D 5.2.2(Win)，建议采用Unity3D 5.2.2（Win）及以上的版本，Android-SDK版本为24.0.2，JDK 1.7.0以上；支持暴风魔镜系列、HID标准协议等蓝牙手柄（详见下表2）作为交互外设进行控制，支持Android4.4以上。Android SDK Location配置，如下图1所示。
图1 Android SDK Location配置
3、iOS平台发布
SDK开发环境为Unity3D 5.2.2(Mac) & XCode7.1，建议采用Unity3D 5.2.2（Mac）及以上版本，Xcode采用7.1以上版本，支持Mojing4（魔镜4代手柄）、iCade模式手柄和iPhoneMFi 手柄作为交互外设进行控制，支持iOS6.0以上。
三、支持的设备
1、支持的眼镜及镜片
目前支持暴风魔镜所有型号的眼镜镜片，参见表1。
厂商Manufacture产品Product眼镜Glasses
暴风魔镜
暴风魔镜II 标准镜片
暴风魔镜III
标准镜片
Plus B镜片
Plus A镜片暴风魔镜IV 标准镜片(96) 观影镜观影镜
魔镜小D 标准镜片
暴风魔镜5代魔镜5
暴风魔镜RIO 魔镜RIO
表1 SDK支持镜片列表
1.1 获取厂商列表
GetManufacturers ( string strLanguageCodeByISO639)
函数功能：获取json文件厂商列表
输入参数：中文（“zh”）
返回值：厂商列表
1.2 获取产品列表
GetProducts ( string strManufacturerKey, string strLanguageCodeByISO639) 函数功能：获取Manufacturer下的产品列表
输入参数：厂商信息KEY，“zh”
返回值：产品列表
1.3 获取镜片列表
GetGlasses(string strProductKey, string strLanguageCodeByISO639)
