HarmonyOS鸿蒙Next中怎样获取component3D的surface ID？

HarmonyOS鸿蒙Next中怎样获取component3D的surface ID？ 请问component3D用到了surface吗？怎样获取component3D的surface ID？

3 回复

开发者您好： Component3D和XComponent类似，用到了surface，可以通过ModelType枚举说明指定SURFACE；但是不同的是Component3D通过load一个gltf scene用AGP绘制，AGP是3D渲染引擎，使用时只需要在ArkTS侧调用即可。目前无法在ArkTS侧获取到surface ID。

更多关于HarmonyOS鸿蒙Next中怎样获取component3D的surface ID？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，获取component3D的surface ID，可通过其关联的XComponent组件实现。XComponent持有surface，使用其getXComponentSurfaceId()方法即可直接获取surface ID。该ID用于在Native层进行图形绘制等底层操作。

在HarmonyOS Next中，component3D本身并不直接对应一个独立的Surface。它通常是作为UI组件树的一部分，由ArkUI的渲染引擎统一管理和合成。

要获取与component3D相关的图形层信息，核心是获取其关联的RenderingContext。具体方法如下：

  1. 对于Canvas组件，可以通过其getContext('2d' | 'webgl')方法获取RenderingContext。
  2. 该RenderingContext底层关联着一个Surface。你可以通过调用RenderingContext的getSurfaceId()方法来获取其Surface ID。

示例代码（ArkTS）：

import { drawing } from '@kit.ArkGraphics2D';

@Entry
@Component
struct Index {
  private settings: drawing.RenderingContextSettings = new drawing.RenderingContextSettings(true);
  private ctx: drawing.RenderingContext = drawing.createRenderingContext(this.settings);

  build() {
    Column() {
      // 1. 创建一个Canvas组件作为3D图形的容器或绘制上下文
      Canvas(this.ctx)
        .width('100%')
        .height('100%')
        .onReady(() => {
          // 2. 在Canvas准备就绪后，通过其RenderingContext获取Surface ID
          let surfaceId: number = this.ctx.getSurfaceId();
          console.info(`Canvas Surface ID: ${surfaceId}`);
          // 此surfaceId可用于后续与Native层图形接口交互
        })
    }
  }
}

关键点说明：

  • component3D（或Canvas）的绘制内容最终由这个Surface承载。
  • getSurfaceId()返回的是一个number类型的唯一标识符。
  • 该Surface ID主要用于高级场景，例如与Native Render Service（C/C++层）进行交互，实现自定义的低级图形渲染。

因此，获取component3D的Surface ID的途径是：获取其绘图上下文（RenderingContext），再从中调用getSurfaceId()方法。

回到顶部