使用说明
本文档主要介绍天工计划SDK(iOS版)使用方法,利用SDK可以快速加载显示3D模型,展示交互式模型,加载AR场景 本文属于入门级文档,旨在帮助开发者快速学习iOS SDK的使用并应用到自身开发工作。
获取应用授权码
请到登录http://ar.jd.com/newhome/home.do (京东天工AR开放平台), 在技术开放平台中进行登记,选择移动应用进行设置后,将该应用提交审核,只有审核通过的应用才能进行开发。
下载iOS SDK
进入“技术开放平台”下载iOS SDK,压缩包中包括Demo+SDK+模型资源+开发文档。 其中的Demo使用SDK的各功能API;SDK包括Frostfire.framework、hiar.framework、JDARLib2.framework、AR3DLib.framework、calib.framework5个framework文件。
Demo介绍
为了更好的理解天工计划SDK的使用,下面将通过一个简单的实例来讲解一下SDK各个关键API接口的使用。
- 工程配置
首先新建一个示例工程,按以下步骤进行配置。
i. 设置工程的 Bundle Identifer,内容为您创建应用时的iOS包名。
ii. 在AppDelegate.类中- (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions 函数内添加[JDARManager SetAppKey:@"appkey" andAppSecret:@"appsecret "]; 3D模型加载显示Demo 关于界面的构建此处不进行介绍,下面着重介绍3D模型加载显示SDK各API的使用:
i. 3D模型初始化arView = [[JDARView alloc] initWithFrame:self.view.frame];
ii. 加载3D模型
[arView setBackgroundPath:bgPath andModelPath:path withPassword:password];
bgPath:背景模型路径。 Path:商品模型路径。 Password:商品解压包密码。
iii. 加载天空球模型[arView setSkyModel:path andSkySphere:skyPath withPassword: password];
bgPath:背景模型路径。 Path:商品模型路径。 Password:商品解压包密码。
[arView setSkyModel:path andLeft:leftPath right:rightPath top:topPath bottom:bottomPath front:frontPath back:backPath withPassword:@""];
Path:商品模型路径。 leftPath:左侧背景模型路径。 rightPath:右侧背景模型路径。 topPath:顶部背景模型路径。 bottomPath:底部背景模型路径。 frontPath:前部背景模型路径。 backPath:后部背景模型路径。 Password:商品解压包密码。
arkit3D模型加载显示Demo 下面着重介绍arkit场景3D模型加载显示SDK各API的使用: i. 初始化arkit 遵循协议(JDIOSARViewDelegate)
iOSARView = [[JDIOSARView alloc] initWithFrame:self.view.frame andParentView:self.view]; iOSARView.delegate = self
ii. 模型加载显示 回调函数
(void)addModelToScene:(NSString*)anchorID withTransform:(GLKMatrix4)modelMatrix withVertical:(bool)isVertical
中执行:
[iOSARView loadModel:anchorID andModelFile:path andTransform:modelMatrix andVertical:isVertical withThePassword:@""]
Path:商品模型路径。
imu 3D模型加载显示Demo 下面着重介绍imu场景3D模型加载显示SDK各API的使用: i. imu 3D模型初始化
imuView = [[JDIMUView alloc] initWithFrame:self.view.frame];
ii. 模型加载显示
[imuView loadModelPath:path withPassword:@""];
Path:商品模型路径。
Matrix 3D模型加载显示Demo 下面着重介绍Matrix场景3D模型加载显示SDK各API的使用: i.Matrix 3D模型初始化
matrixView = [[JDMatrixView alloc] initWithFrame:self.view.frame];
ii. 模型加载显示
[matrixView setModelName:@"jiangxiaobai" andDBPaths:dbPaths andModelPath:modelpath andVideoPath:videoPath withPassword:password]
dbPaths 数据模型路径。 modelpath:商品模型路径。 videoPath:音频数据。 Password解压密码。