移动设备增强现实系统应用接口.docxVIP

1

信息技术移动设备增强现实系统应用接口

1范围

本文件规定了移动设备增强现实系统应用开发的数据类型和接口。

本文件适用于移动设备增强现实系统的设计、开发和应用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T38247-2019信息技术增强现实术语

T/CESAXXXXX信息技术移动设备增强现实系统技术规范

3术语和定义

GB/T38247-2019和T/CESAXXXXX界定的以及下列术语和定义适合于本文件。为了便于使用，以下重复列出了GB/T38247—2019中的某些术语和定义。

3.1

参考图像referenceimage

在环境中可被识别的二维图像。

[来源：GB/T38247-2019，2.2.18]

3.2

增强现实会话augmentedrealitysession

负责管理增强现实系统的整个运行过程，包括创建、启动、更新、关闭、销毁等各个过程。

3.3

增强现实地图augmentedrealitymap

增强现实运行过程中构建的地图结构，包括检测到的点云、平面节点、图像节点等信息，以及用户创建的锚点。

3.4

节点node

增强现实运行过程中识别出的平面、图像、手势等具体对象信息。

3.5

2

点云pointcloud

在增强现实应用中，用于恢复三维场景而使用的场景物体表面的三维点数据集合。[来源：GB/T38247-2019，2.2.47]

3.6

稠密网格densemesh

稠密三维重建过程中，恢复的场景三角形网格。

4缩略语

下列缩略语适用于本文件。

6DoF：六自由度（SixDegreesofFreedom）

AR：增强现实(AugmentedReality)

API：应用程序编程接口（ApplicationProgrammingInterface）

FPS：每秒帧数（FramesPerSecond）

IMU：惯性测量单元（InertialMeasurementUnit）

SLAM：同步定位与地图构建（SimultaneousLocalizationAndMapping）

5总体结构

增强现实系统总体结构如图1所示。

说明：

可选模块

必选模块

图1增强现实系统总体结构

3

6数据类型

6.1结果

结果数据类型命名为ARResult，其值定义如表1所示。

表1结果数据类型ARResult定义

ARResult值

描述

ARRESULT_SUCCESS=0

成功或者正确。

ARRESULT_ERROR_INVALID_ARGUMENT=1

包含无效参数。

ARRESULT_ERROR_FATAL=2

严重错误。

ARRESULT_ERROR_SESSION_PAUSED=3

当前操作ARSession暂停状态错误。

ARRESULT_ERROR_SESSION_NOT_PAUSED=4

当前操作ARSession未暂停状态错误

ARRESULT_ERROR_NOT_TRACKING=5

目前不处于跟踪状态导致的错误。

ARRESULT_ERROR_TEXTURE_NOT_SET=6

未设置纹理参数导致的错误。

ARRESULT_ERROR_UNSUPPORTED_VIDEOFORMAT=7

指定的视频格式不支持错误。

ARRESULT_ERROR_CAMERA_NOT_AVAILABLE=8

摄像机服务不可用错误。

ARRESULT_ERROR_CAMERA_PERMISSION_NOT_GRANTED=9

摄像机服务未授权导致的错误。

ARRESULT_ERROR_UNSUPPORTED_CONFIG=10

设置的配置选项不支持导致的错误。

ARRESULT_ERROR_RESOURCE_EXHAUSTED=11

没有可用资源导致的错误。

ARRESULT_ERROR_CLOUD_ANCHORS_NOT_CONFIGURED=12

没有对云锚点模式进行设置导致的错误。

ARRESULT_ERROR_ANCHOR_NOT_SUPPORTED_FOR_HOSTING=13

该锚点不支持托管导致的错误。

ARRESULT_ERROR_DEVICE_UNSUPPORT=14

移动设备不支持增强现实导致的错误。

ARRESULT_ERROR_ALGORITHM_UNSUPPORT=15

使用不支持的算法导致的错误。

ARRESULT_ERROR_APPLICATION_AU