[HarmonyOS Next示例代码]AREngine

HarmonyOS next 示例代码全集

AREngine_SampleCode_Clientdemo_cpp: 本示例通过调用AR引擎服务接口，结合XComponent和OpenGL/EGL，将辨认到的点云信息，平面信息等显示在屏幕上。
AREngine

介绍

本示例展示了AREngine提供的平面检测，运动跟踪，情况跟踪和碰撞检测能力。
结果预览

应用首页辨认平面通过碰撞检测显示模子

  

  

  

• 在手机的主屏幕，点击“ArSample”，启动应用，在主界面可见“ArWorld”按钮。
  
• 点击“ArWorld”按钮，拉起ArEngine平面辨认界面，对准地面，桌面，墙面等平面迟钝移动扫描，即可辨认到平面并绘制到屏幕上。
  
• 辨认出平面后，点击平面上某个点，通过AREngine提供的命中检测的能力，会在屏幕被点击位置放置一个3d模子。
  

详细实现

集成服务

利用AREngine服务接口需要在CMakeLists中引入依赖：

1. find_library(
2. arengine-lib
3. libarengine_ndk.z.so
4. )
5. target_link_libraries(entry PUBLIC
6. ${arengine-lib}
7. )

复制代码

利用时引入头文件 #include "ar/ar_engine_core.h"
代码结构解析

1. ├─entry/src/main
2. │  module.json5                                            // 模块的配置文件。              
3. │
4. ├─cpp                                                      // C++代码区。
5. │  │  CMakeLists.txt                                       // CMake配置文件。
6. │  │
7. │  ├─src
8. │  │  │  app_napi.h                                        // 业务侧虚基类。
9. │  │  │  global.cpp                                        // napi初始化。
10. │  │  │  global.h                                          // C++和ets接口映射配置。
11. │  │  │  module.cpp                                        // C++接口注册。
12. │  │  │  napi_manager.cpp                                  // C++接口实现。
13. │  │  │  napi_manager.h
14. │  │  │
15. │  │  ├─graphic                                            // 渲染相关工具类
16. │  │  │
17. │  │  ├─utils                                              // util工具类。                                                               
18. │  │  │
19. │  │  └─world                                              // ArWorld模块。
20. │  │          world_ar_application.cpp                     // ArWorld模块接口实现。
21. │  │          world_ar_application.h
22. │  │          world_background_renderer.cpp                // 背景渲染。
23. │  │          world_background_renderer.h
24. │  │          world_object_renderer.cpp                    // 3D物体渲染。
25. │  │          world_object_renderer.h
26. │  │          world_plane_renderer.cpp                     // 平面渲染。
27. │  │          world_plane_renderer.h
28. │  │          world_render_manager.cpp                     // 每一帧渲染。
29. │  │          world_render_manager.h
30. │  │
31. │  ├─thirdparty                                            // 渲染相关三方库
32. │  └─types                                                 // 接口存放文件夹。
33. │      └─libentry
34. │              index.d.ts                                  // 接口文件。
35. │              oh-package.json5                            // 接口注册配置文件。
36. │
37. ├─ets                                                      // ets代码区。
38. │  ├─entryability
39. │  │      EntryAbility.ets                                 // 程序入口类。
40. │  │
41. │  ├─pages
42. │  │      ArWorld.ets                                      // ArWorld界面。
43. │  │      Selector.ets                                     // 主界面。
44. │  │
45. │  └─utils
46. │          Logger.ets                                      // ets日志打印。
47. │
48. └─resources                                                // 资源文件目录。

复制代码

创建会话和帧数据相关接口

1. AREngine_ARStatus HMS_AREngine_ARConfig_Create(const AREngine_ARSession *session, AREngine_ARConfig **outConfig);
2. void HMS_AREngine_ARConfig_Destroy(AREngine_ARConfig *config);
4. AREngine_ARStatus HMS_AREngine_ARSession_Create(void *env, void *applicationContext, AREngine_ARSession **outSessionPointer);
5. AREngine_ARStatus HMS_AREngine_ARSession_Configure(AREngine_ARSession *session, const AREngine_ARConfig *config);
6. void HMS_AREngine_ARSession_Destroy(AREngine_ARSession *session);
8. AREngine_ARStatus HMS_AREngine_ARFrame_Create(const AREngine_ARSession *session, AREngine_ARFrame **outFrame);
9. void HMS_AREngine_ARFrame_Destroy(AREngine_ARFrame *frame);

复制代码

平面辨认相关接口：

1. AREngine_ARStatus HMS_AREngine_ARTrackableList_Create(const AREngine_ARSession *session, AREngine_ARTrackableList **outTrackableList);
2. AREngine_ARStatus HMS_AREngine_ARSession_GetAllTrackables(const AREngine_ARSession *session, AREngine_ARTrackableType filterType, AREngine_ARTrackableList *outTrackableList);
3. AREngine_ARStatus HMS_AREngine_ARTrackableList_GetSize(const AREngine_ARSession *session, const AREngine_ARTrackableList *trackableList, int32_t *outSize);
4. AREngine_ARStatus HMS_AREngine_ARTrackableList_AcquireItem(const AREngine_ARSession *session, const AREngine_ARTrackableList *trackableList, int32_t index, AREngine_ARTrackable **outTrackable);
5. void HMS_AREngine_ARTrackableList_Destroy(AREngine_ARTrackableList *trackableList);
7. AREngine_ARStatus HMS_AREngine_ARTrackable_GetTrackingState(const AREngine_ARSession *session, const AREngine_ARTrackable *trackable, AREngine_ARTrackingState *outTrackingState);
8. void HMS_AREngine_ARTrackable_Release(AREngine_ARTrackable *trackable);
10. AREngine_ARStatus HMS_AREngine_ARPlane_AcquireSubsumedBy(const AREngine_ARSession *session, const AREngine_ARPlane *plane, AREngine_ARPlane **outSubsumedBy);
11. AREngine_ARStatus HMS_AREngine_ARPlane_AcquireSubsumedBy(const AREngine_ARSession *session, const AREngine_ARPlane *plane, AREngine_ARPlane **outSubsumedBy);
12. AREngine_ARStatus HMS_AREngine_ARPlane_GetCenterPose(const AREngine_ARSession *session, const AREngine_ARPlane *plane, AREngine_ARPose *outPose);
13. AREngine_ARStatus HMS_AREngine_ARPlane_GetPolygonSize(const AREngine_ARSession *session, const AREngine_ARPlane *plane, int32_t *outPolygonSize);
14. AREngine_ARStatus HMS_AREngine_ARPlane_GetPolygon(const AREngine_ARSession *session, const AREngine_ARPlane *plane, float *outPolygonXz, int32_t polygonSize);
15. AREngine_ARStatus HMS_AREngine_ARPlane_IsPoseInPolygon(const AREngine_ARSession *session, const AREngine_ARPlane *plane, const AREngine_ARPose *pose, int32_t *outPoseInPolygon);

复制代码

碰撞检测相关接口：

1. AREngine_ARStatus HMS_AREngine_ARHitResultList_Create(const AREngine_ARSession *session, AREngine_ARHitResultList **outHitResultList);
2. AREngine_ARStatus HMS_AREngine_ARHitResultList_GetSize(const AREngine_ARSession *session, const AREngine_ARHitResultList *hitResultList, int32_t *outSize);
3. AREngine_ARStatus HMS_AREngine_ARHitResultList_GetItem(const AREngine_ARSession *session, const AREngine_ARHitResultList *hitResultList, int32_t index, AREngine_ARHitResult *outHitResult);
4. void HMS_AREngine_ARHitResultList_Destroy(AREngine_ARHitResultList *hitResultList);
6. AREngine_ARStatus HMS_AREngine_ARHitResult_AcquireNewAnchor(AREngine_ARSession *session, AREngine_ARHitResult *hitResult, AREngine_ARAnchor **outAnchor);
7. AREngine_ARStatus HMS_AREngine_ARHitResult_GetHitPose(const AREngine_ARSession *session, const AREngine_ARHitResult *hitResult, AREngine_ARPose *outPose);
8. AREngine_ARStatus HMS_AREngine_ARHitResult_AcquireTrackable(const AREngine_ARSession *session, const AREngine_ARHitResult *hitResult, AREngine_ARTrackable **outTrackable);
9. void HMS_AREngine_ARHitResult_Destroy(AREngine_ARHitResult *hitResult);

复制代码

运动跟踪能力图文介绍：

AR Engine通过获取终端设备摄像头数据，结合图像特性和惯性传感器（IMU），计算设备位置（沿x、y、z轴方向位移）和姿态（绕x、y、z轴旋转），实现6自由度（6DoF）运动跟踪能力。
6DoF运动跟踪能力表示图（赤色线代表设备运动方向） 

相关权限

利用相机，加速度传感器和陀螺仪传感器权限，相机权限由应用申请。
依赖

依赖设备具备相机，加速度传感器和陀螺仪传感器能力。
束缚与限制

• 本实例仅支持尺度系统上运行，支持设备：华为手机（mate 60, mate 60pro, mate x5）。
  
• DevEco Studio版本：DevEco Studio NEXT Developer Beta2及以上。
  
• HarmonyOS SDK版本：HarmonyOS NEXT Developer Beta2及以上。
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。