使用说明

本文档主要介绍天工计划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接口的使用。

  1. 工程配置 首先新建一个示例工程,按以下步骤进行配置。
    i. 设置工程的 Bundle Identifer,内容为您创建应用时的iOS包名。
    ii. 在AppDelegate.类中- (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions 函数内添加[JDARManager SetAppKey:@"appkey" andAppSecret:@"appsecret "];
  2. 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:商品解压包密码。

  3. 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:商品模型路径。

  4. imu 3D模型加载显示Demo 下面着重介绍imu场景3D模型加载显示SDK各API的使用: i. imu 3D模型初始化

    imuView = [[JDIMUView alloc] initWithFrame:self.view.frame];
    

    ii. 模型加载显示

    [imuView loadModelPath:path withPassword:@""];
    

    Path:商品模型路径。

  5. 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解压密码。

powered by Gitbook修订时间: 2022-09-23 09:01:04