本文件规定了用于增强现实的软件构件接口，包括会话类接口、帧数据类接口、可追踪物体类接口、碰撞检测类接口和环境理解类接口。 本文件适用于增强现实软件构件接口的表示与应用。

ICS35.240
CCS L 81
中华人民共和国国家标准
GB/T44247—2024
信息技术
增强现实
软件构件接口
Information technologyAugmented realitySoftware component interface2024-07-24发布
国家市场监督管理总局
国家标准化管理委员会
2025-02-01实施
规范性引用文件
术语和定义
缩略语
构件接口
接口分类
接口调用流程
6会话类接口
会话接口
配置接口
相机接口
顿数据类接口
顿画面接口
图像接口
图像元数据接口
可跟踪物体类接口
锚点接口
点接口
点云接口
平面接口
可跟踪接口
图像增强接口
图像数据库接口
稀疏空间地图接口
面部增强接口
碰撞检测类接口
检测实体管理接口
测量接口
检测结果引用接口
10环境理解类接口
光照估计接口
稠密重建接口
附录A（规范性）
附录B（规范性）
参考文献
特殊数据类型定义
枚举数据类型定义
GB/T44247—2024
GB/T44247—2024
本文件按照GB/T1.1一2020《标准化工作导则」第1部分：标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会（SAC/TC28）提出并归口。本文件起草单位：江南大学、中国电子技术标准化研究院、西安理工大学、视辰信息科技（上海)有限公司、南昌虚拟现实研究院有限公司、新疆丝路六合电气科技有限公司、深圳市鹰眼在线电子科技有限公司、深圳眼千里科技有限公司、广东三鼎实业集团有限公司、深圳市华方信息产业有限公司、青软创新科技集团股份有限公司、山东中维世纪科技股份有限公司、山东承势电子科技有限公司、深圳市宇泰科技有限公司、深圳市磐鼎科技有限公司、河南城建学院、咪咕文化科技有限公司、三一重工股份有限公司、滨沅国科（秦皇岛）智能科技股份有限公司、深圳房讯通信息技术有限公司、中仪英斯泰克科技有限公司、无锡车联天下信息技术有限公司、青岛理工大学、深圳积木易搭科技技术有限公司、维坤智能科技（上海)有限公司、杭州分叉智能科技有限公司、新次元（深圳)文旅技术有限公司、江苏奥格视特信息科技有限公司、天津博顿电子有限公司。本文件主要起草人：王映辉、赵洪良、梁炎兴、宁小娟、张少杰、李伟、江淑红、荣健、肖镇生、潘榕、耿一丹、曾洁琪、姚荣斌、周翔、李久林、王磊、周俊太、刘全、李俊峰、齐泽荣、李国强、魏纪超、贺伟、于秀娜、王乐、部永军、李海滨、俞中宏、陈成军、刚勇、党建明、孙剑峰、周治国、吴小女、吴杰、王立军、郭红岩、张敬祥。
1范围
信息技术
软件构件接口
增强现实
GB/T44247—2024
本文件规定了用于增强现实的软件构件接口，包括会话类接口、顿数据类接口、可追踪物体类接口、碰撞检测类接口和环境理解类接口。本文件适用于增强现实软件构件接口的表示与应用。2
规范性引用文件
本文件没有规范性引用文件
3术语和定义
下列术语和定义适用于本文件。3.1
:component
软件系统中具有相对独立功能、可以明确辨识、接口由契约指定、和语境有明显依赖关系、可独立部署的可组装软件实体。
［来源：GB/T36455—2018,3.1]3.2
构件接口
component interface
软件构件对外交流和交互的唯一通道。3.3
增强现实
augmented reality
采用以计算机为核心的现代高科技手段生成的附加信息对使用者感知到的真实世界进行增强的环境，生成的附加信息以融合的方式叠加至真实场景中。「来源：GB/T38247—2019,2.1.23.4
augmented realitysession
增强现实会话
增强现实中管理各部分运行的消息机制。3.5
面部增强
augmented face
获取面部网格信息，做图像特效处理。4
缩略语
下列缩略语适用于本文件。
AR：增强现实（AugmentedReality）CPU：中央处理器（CentralProcessingUnit)GPU：圆形处理器（GraphicsProcessingUnit）HDR：高动态范围（HighDynamicRange）GB/T44247—2024
ID：唯一编码（IdentityDocument）RGB：红、绿、蓝三个通道的颜色（Red，Green，Blue）5构件接口
5.1接口分类
构件接口类型包括会话类接口、顺数据类接口、可跟踪物体类接口、碰撞检测类接口和环境理解类接口。各类接口间的关系见图1。会话类接口是AR应用中用于管理AR会话生命周期的核心接口，负责初始化和配置AR环境，以及管理AR会话的开始和结束，并设置各种参数来启动AR环境。顿数据类接口是负责处理和捕获每一帧的图像信息的接口，包括画面、图像以及图像元数据，这些数据是AR应用中进行环境理解和物体跟踪的基础数据。可跟踪物体类接口是AR应用中用于识别和跟踪用户环境中的特定物体或标记的接口，与会话类接口和顿数据类接口协作，实时接收和处理顿数据来识别和跟踪物体。碰撞检测类接口是用户与AR环境进行交互的接口，使用户通过自然的方式与AR内容互动，增强用户体验。同时碰撞检测类接口需与会话类接口和顿数据类接口协作，以确保交互的准确性和实时性。环境理解类接口是AR应用中用于理解和分析用户环境的接口，包括对环境的光照估计等。环境理解类接口需与顿数据类接口紧密协作，依赖帧图像数据来实现对环境的分析。可跟踪物体类接口
顿数据类接口
会话类接口
环境理解类接口
碰撞检测类接口
图1不同类接口之间的关系
5.2接口调用流程
会话类接口首先被调用，初始化和配置AR环境顿数据类接口在会话开始后被周期性调用，提供每一帧的图像信息可跟踪物体类接口在顿数据类接口基础上工作，识别和跟踪环境中的特定物体碰撞检测类接口实时处理顿数据类接口提供的数据，实现用户与AR环境进行交互环境理解类接口实时分析可跟踪物体类和碰撞检测类接口，感知用户的环境并提供相应的AR体验。
各类接口中涉及的数据类型应符合附录A和附录B。6会话类接口
6.1会话接口
6.1.1创建增强现实会话
参考接定义：ArStatus ArSession_create（void * env，void ＊ context，ArSession**out_session_pointer)。
功能描述：创建新的增强现实会话。参数说明见表1。env
context
参数名
out_session_pointer
void *
void *
ArSession**
：创建特定功能的增强现实会话6.1.2
创建增强现实会话参数说明
表示运行环境的指针
表示运行上下文的指针
GB/T44247—2024
指向ArSession指针的指针，以接收新分配的会话的地址参考接定义：ArStatusArSession_createWithFeatures（void*env，void*context，constArSessionFeature * features，ArSession ** out_session_pointer)。功能描述：创建新的增强现实会话，请求其他功能。参数说明见表2。表2创建特定功能的增强现实会话参数说明参数名
context
features
out_session_pointer
void *
void *免费标准bzxz.net
ArSessionFeature *
ArSession**
销毁增强现实会话
表示运行环境的指针
表示运行上下文的指针
指向请求的功能列表的指针
指向ArSession指针的指针，以接收新分配的会话的地址参考接口定义：voidArSession_destroy（ArSession*session）。功能描述：释放增强现实会话所占用的资源。参数说明见表3。表3销毁增强现实会话参数说明
参数名
session
ArSession *
设置增强现实会话配置
增强现实会话指针
参考接定义：ArStatusArSession_configure（ArSession*session，constArConfig*config）。功能描述：增强现实会话具有默认配置，如需修改，则调用此方法。参数说明见表4。表4设置增强现实会话配置参数说明参数名
session
config
ArSession*
ArConfig*
增强现实会话指针
增强现实会话的新配置设置指针3
GB/T44247—2024
6.1.5获取增强现实会话配置
参考接口定义：voidArSession_getConfig（ArSession*session，ArConfig*out_config）。功能描述：获取当前增强现实会话的配置。参数说明见表5。表5
参数名
session
out_config
获取增强现实会话配置参数说明类型
ArSession*
ArConfig*
暂停增强现实会话
增强现实会话指针
增强现实会话的新配置设置指针参考接口定义：ArStatusArSession_pause（ArSession*session）。功能描述：暂停当前增强现实会话。参数说明见表6。表6暂停增强现实会话参数说明
参数名
session
ArSession
启动增强现实会话
增强现实会话指针
参考接定义:ArStatus ArSession_resume （ArSession * session)。功能描述：启动或恢复增强现实会话。参数说明见表7。表7
参数名
session
6.1.8创建云锚点
ArSession*
启动增强现实会话参数说明
增强现实会话指针
参考接定义：ArStatusArSession_hostAndAcquireNewCloudAnchor（ArSession*session，const ArAnchor *anchor，ArAnchor **out_cloud_anchor)。功能描述：根据当前锚点的位姿和其他的元数据创建新的云锚点。参数说明见表8。表8创建云锚点参数说明
参数名
session
anchor
out_cloud_anchor
ArSession*
ArAnchor*
ArAnchor**
增强现实会话指针
锚点指针
指向ArAnchor指针的指针，以接收新分配的云锚点地址6.1.9获取所有锚点
GB/T44247—2024
参考接定义：voidArSession_getAllAnchors（constArSession*session，ArAnchorList*outanchor list)。
功能描述：返回所有已知的锚点，包括当前尚未跟踪的锚点。参数说明见表9。表9获取所有锚点参数说明
参数名
session
out_anchor_list
解析锚的位姿
ArSession*
ArAnchorList x
增强现实会话指针
所有的锚点列表指针
参考接定义：ArStatusArSession_resolveAndAcquireNewCloudAnchor（ArSession*session，constchar * cloud_anchor_id,ArAnchor ** out_cloud_anchor)功能描述：创建新的云锚点，并使用给定的云锚点ID安排任务，来解析锚点的位姿。参数说明见表10。
参数名
session
cloud_anchor_id
out_cloud_anchor
ArSession *
char *
ArAnchor**
获取所有可跟踪的对象
解析锚的位姿参数说明
增强现实会话指针
云锚点的ID指针
指向ArAnchor指针的指针，以接收新分配的云锚点的地址参考接定义：voidArSession_getAllTrackables（const ArSession *session，ArTrackableTypefilter_type,ArTrackableList * out_trackable_list)。功能描述：获取所有能够被跟踪到的对象。参数说明见表11。表11
获取所有可跟踪的对象参数说明参数名
session
filter_type
out_trackable_list
定义跟踪位置
ArSession *
ArTrackableType
ArTrackableList*
增强现实会话指针
可跟踪对象类型
指向符合类型的可跟踪对象列表的指针参考接定义：ArStatus ArSession_acquireNewAnchor（ArSession*session，const ArPose*pose，ArAnchor**out_anchor)。
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。