MojingSDK For Android 接口说明文档.docVIP

MojingSDK for Android 开发说明文档 北京暴风魔镜科技有限公司 -02  版本 Version 日期 Data 作者 Author 注释 Comments 1.3 2016-06-21 刘满松 支付相关接口增加错误详情回调void mjFailedDetailsCallback(String json) 支付确认页面增加取消按钮的回调 法律声明 北京暴风魔镜科技有限公司追究法律责任。 目录 目录 3 一 6 1 SDK发布包的文件格式 6 2 SDK的命名规范 6 二 7 1 在工程中使用SDK(以Eclipse为例) 7 2 在代码中使用SDK 7 2.1 初始化SDK 8 2.2 使用头部跟踪系统 8 2.2.1 检查当前手机设备的传感器信息 8 2.2.2 头部跟踪复位 9 2.2.3 复位YAW旋转角 9 2.2.4 开始校准头部跟踪偏置值 9 2.2.5 获取头部跟踪偏置值是否已经校准 9 2.2.6 获取当前视角，以矩阵形式表示 9 2.2.7 获取当前视角，以欧拉角表示 10 2.2.8 获取当前视角，以四元数表示 10 2.3 使用反畸变 10 2.3.1 选择VR眼镜和镜片 10 2.3.2 开启关闭TimeWarp 10 2.3.3 开启关闭多线程反畸变 11 2.3.4 设置Renderer 11 2.3.5 设置Message Handler 11 2.3.6 MojingSurfaceView的使用方法 12 2.3.7 获取推荐视场角(FOV) 12 2.3.8 获取绘制纹理 13 2.3.9 绘制畸变图像 13 2.3.10 绘制畸变图像并且叠加一个额外的图层 14 2.3.11 指定叠加图层的位置 14 2.3.12 更改绘制图像的垂直位置(内测功能) 15 2.3.13 在屏幕中央位置绘制辅助线 15 2.3.14 设置默认魔镜世界 16 2.3.15 获取默认魔镜世界对应信息 16 2.3.16 获取最后一次切换的魔镜世界对应信息 17 2.4 获取SDK支持的-产品-眼镜 17 2.4.1 获取SDK支持的厂家列表 17 2.4.2 获取SDK支持的特定厂商的产品列表 18 2.4.3 获取SDK支持的产品镜片列表 19 2.4.4 获取Key的完整描述信息 19 2.4.5 拼接两个Key 20 2.4.6 发生错误时返回的描述信息 20 2.5 使用蓝牙手柄 21 2.5.1 连接手柄 21 2.5.2 断开手柄 21 2.5.3 配置手柄使用方式 22 2.5.4 使能特定的蓝牙手柄 22 2.5.5 关于配置文件 22 2.5.6 多个Activity共用一个MojingInputManager 22 2.5.7 手柄正常工作需要额外更改的代码 22 2.5.8 响应手柄操作 23 2.6 获取SDK的信息 24 2.6.1 获取SDK版本信息 24 2.6.2 获取SDK是否已经调用Init函数 24 2.6.3 获取是否已经启用了头部跟踪 24 2.6.4 获取是否已经进入了魔镜世界 25 2.6.5 获取进入魔镜世界时指定的畸变算法适配的眼镜型号 25 2.7 加入信息统计报数功能 25 2.7.1 首次报活、使用时长等信息统计 25 2.7.2 页面统计 26 2.7.3 事件统计 27 2.7.4 错误信息上报 27 2.7.5 报数时机设置 28 2.7.6 集中上报间隔时间设置 28 2.8 使用用户自定义参数功能 28 2.8.1 设置用户自定参数 28 2参数 28 2参数字段和说明 29 2消费 29 2.9.1 业务术语 29 2.9.2 接口说明 29 2.9.3 返回码 36 三 37 1 使用SDK时需要的权限 37 1.1 存储设备IO的权限 37 1.2 网络访问权限 37 1.3 蓝牙手柄相关权限 37 1.4 使用报活相关权限 37 1.5 SDK当前正在使用的手柄配置文件 37 1.6 手柄配置文件详细说明 38 MojingSDK For Android（下文简称SDK）是为了配合Android软件开发者开发适用于暴风魔镜(R)产品而推出的SDK(Software Development Kit)开发包。开发包主要从手机头部跟踪、传感器数据获取和静态偏置纠偏，官方和第三方蓝牙手柄接入，以及图像抗镜片畸变、抗色散等方面为开发者提供便利性支持。 SDK发布说明 SDK发布包的文件格式 SDK采用标准ZIP压缩文档格式发布，压缩文档中目前目录组织形式如下图： 目录说明： Doc：Doc目录存放的是MojingSDK 的说明文档。 InputMapManager：该目录存放的是