开发准备

移动端SDK

当前SuperMap iMobile产品包中包含众多模块,而在移动端视频地图的开发过程中,仅用到部分模块的功能。

必需的SO库

使用libimb2d.so 或libimb.so。

当需要使用到com.supermap.realspace.jar时,必须使用libimb.so。

常用JAR包

在视频地图的开发过程中,经常使用到的jar包如下:

  • com.supermap.data.jar(必需)
  • com.supermap.ar.jar(必需)
  • com.supermap.ai.jar(使用AI功能以及“地图叠加视频帧”时添加)
  • com.supermap.mapping.jar(地图模块,根据需要添加)
  • com.supermap.realspace.jar(三维模块,根据需要添加)

三方依赖

引入Sceneform

为确保com.supermap.ar模块正常运行,需额外引入sceneform-sm.aar。(sceneform-sm.aar可在SuperMap iMobile for Android中找到)

引入sceneform-sm有两种方式。

第一种方式

根据不同的sceneform版本,直接在模块的build.gradle文件的dependencies中添加以下内容。

sceneform-sm_v1.19.8.aar配置如下:

//注意:当前版本的sceneform-sm,需在filament 1.9.25版本上运行
implementation files('libs/sceneform-sm_v1.19.8.aar')
//ARCORE
api 'com.google.android.filament:filament-android:1.9.25'
api 'com.google.android.filament:gltfio-android:1.9.25'
api 'com.google.android.filament:filament-utils-android:1.9.25'
scenefrom-sm-11.0.1.aar配置如下:
//注意:当前版本的sceneform-sm,需在filament 1.12.0版本上运行
implementation files('libs/sceneform-sm-11.0.1.aar')
//谷歌filament依赖已合入sceneform-sm-11.0.1.aar

第二种方式

先在项目工程的build.gradle文件中的repositories中添加在线maven配置。

buildscript {
  repositories {
    google()
    jcenter()
    // 配置Maven地址。
    maven {
      url "https://raw.githubusercontent.com/SupermapIMobile/repo/main"
      //url "https://repo.eqgis.cn"
    }
  }
}
allprojects {
  repositories {
    google()
    jcenter()
    // 配置Maven地址。
    maven {
      url "https://raw.githubusercontent.com/SupermapIMobile/repo/main"
      //url "https://repo.eqgis.cn"
    }
  }
}

再在模块的build.gradle文件。

//仅添加对应版本的sceneform-sm依赖即可
implementation 'com.supermap:sceneform-sm:11.0.0'

引入 DJI MSDK

在本地视频地图的开发流程中无需引入DJI MSDK V4(例如,SuperMap UAVSurvey的离线视频方式),仅当涉及DJI无人机的操作中需要使用到DJI MSDK V4(例如,SuperMap UAVSurvey的实时视频方式)。

(1).注册DJI 账号

您可以点击这里注册成为DJI开发者,在大疆开发者中心创建一个应用,按照流程激活后方可得到DJI App key。 大疆开发文档:https://developer.dji.com/cn/mobile-sdk-v4

(2).生成App Key

① 选择左侧栏的 "应用 "。

② 选择右侧的 “创建应用” 按钮。

③ 输入应用程序的名称, 开发平台, Package Name, 分类和描述信息。

④ 您会收到一封应用程序激活邮件,完成App Key的生成。

⑤ 您可以在开发者中心中找到App Key,复制粘贴到应用程序配置中。